Civitatis

Get full details of a specific activity: images, long description, highlights, cancellation policy, reviews, and price. Use it whenever the user asks for more info, details, description or highlights of a specific activity, including activities already mentioned earlier in the conversation — catalog data such as prices and policies changes over time, so fresh details come from this tool and are presented in its detail widget. Requires the NUMERIC activityId (e.g. 12345); look it up with list-activities if you only have a name.

get-activity-detail

Add an activity session to the cart and get a checkout URL. Call this when the user wants to book or reserve an activity. Requires activityId, date and time; pass modalityId and ticketTypeId too when check-availability gave them to you, and the server resolves them from the calendar when it did not. To add another item to the SAME cart, pass both cartId AND cartToken exactly as returned by the previous add-to-cart call — cartId alone is rejected.

add-to-cart

Check available time slots for a specific activity on a given date. Call this INSTEAD OF search-activities when the user asks about availability, dates, or schedules for an activity already shown in the conversation. Requires activityId from prior search results.

check-availability

Check availability for MULTIPLE activities on the same date in one call. Use this when the user asks which of several activities are available on a specific date. More efficient than calling check-availability multiple times.

check-availability-batch

Look up activities (with numeric IDs) for a destination as PLAIN TEXT, without showing any widget. Use this to obtain activityIds before suggest-itinerary, get-activity-detail or check-availability when you don't already have them. Returns a text list of 'title (activityId=NNN)'.

list-activities

Browse activities for a destination — shows a visual carousel widget for open-ended discovery. Use ONLY when the user just wants to see what there is, and no activities are visible yet. DO NOT use this for itinerary or multi-day plan requests — for those call suggest-itinerary directly. To look up activityIds WITHOUT a widget, use list-activities.

search-activities

Display a multi-day activity itinerary plan. Use this whenever the user asks for an itinerary, a plan, or a multi-day schedule for a destination (NOT search-activities). Call it DIRECTLY with destination, startDate, days and travelers — the server automatically picks the destination's top activities and distributes them across the days. Only pass `plan` when the user asked for SPECIFIC activities (get their numeric activityIds from list-activities first; NEVER invent activityIds).

suggest-itinerary