add-to-cart
ChatGPTAdd 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, time, modalityId, and ticketTypeId from check-availability results.
Travel
Overview
Civitatis helps users discover tours and activities by destination, inspect activity details, check available dates and sessions, build an itinerary, add selected sessions to a cart, and continue checkout on Civitatis.
Tools
add-to-cart
ChatGPTAdd 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, time, modalityId, and ticketTypeId from check-availability results.
add-to-cart
ChatGPTAdd 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, time, modalityId, and ticketTypeId from check-availability results.
check-availability
ChatGPTCheck 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
ChatGPTCheck 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
ChatGPTCheck 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-batch
ChatGPTCheck 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
ChatGPTCheck 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
ChatGPTCheck 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.
get-activity-detail
ChatGPTGet 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
ChatGPTGet 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
ChatGPTGet 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.
list-activities
ChatGPTLook 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
ChatGPTLook 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
ChatGPTLook 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)'.
search-activities
ChatGPTBrowse 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
ChatGPTBrowse 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
ChatGPTBrowse 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.
suggest-itinerary
ChatGPTDisplay 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
ChatGPTDisplay 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
ChatGPTDisplay 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).Capabilities
InteractiveWrites
