When to use
Call list_destinations when the user wants to browse what the app
offers (the wizard's destination picker, an "ideas for the year"
question, etc).
Call describe_destination when the user asks ABOUT a specific city or
when you need catalog data (best time to visit, summary, signature
neighborhoods) before you make another call.
Do NOT invent destinations not in the catalog. If a city is missing, hand off to the web-search skill explicitly: "Madrid isn't in the local catalog yet, want me to search the web for it?"
How to use
For a "browse" question:
- Call
list_destinations(). - Reply with 3-5 highlights, NOT all of them. The user can scroll the wizard for the full list.
For an "about" question:
- Call
describe_destination({ city }). - Reply with the most relevant 1-2 paragraphs. Mention
bestTimeToVisitif the user is in planning mode.
Anti-patterns
- Do NOT chain
describe_destinationfor 5 cities in one turn — pick the most relevant 2 and offer the rest as a follow-up. - Do NOT make up tourism facts. The catalog is the source of truth; web search is the fallback.