Create Itinerary Request
CreateItineraryRequestFull Description
If the user wants to book a flight, this tool can be used to create a flight itinerary request once the user has provided an origin, a destination, and a single outbound date. Ask clarifying questions only if required information is missing or ambiguous (e.g., missing location(s), missing date(s), user specified date range(s), or unclear one-way vs round-trip when only outbound date is given). Do not delay for preferences or confirmation; default to economy cabin unless specified otherwise and infer the traveller persona from knowledge about the user. Normalize dates safely (never past dates; infer the next future year if missing). Include time preferences only when explicitly stated. Flights only; do not use for lodging or ground transportation.
Parameters (4 required, 4 optional)
from_airportstringOrigin IATA code (exactly 3 uppercase letters, pattern ^[A-Z]{3}$). If the user mentions a specific airport, use its airport code (e.g. LHR). If they mention only a city, use the city code (e.g. LON). Only use locations explicitly mentioned by the user.
from_datestringStart date for the itinerary (YYYY-MM-DD). Must be >= today\’s date. Must be a single date, not a range. Only use date specified by the user (year may be inferred).
to_airportstringDestination IATA code (exactly 3 uppercase letters, pattern ^[A-Z]{3}$). If the user mentions a specific airport, use its airport code (e.g. LHR). If they mention only a city, use the city code (e.g. LON). Only use locations explicitly mentioned by the user.
traveller_typestringTraveller persona inferred from Model Set Context and User Knowledge Memories. Choose one of: budget, standard, road_warrior, vip. Use stable signals from memory (e.g., cost-minimizing behavior → budget; frequent or time-sensitive business travel → road_warrior; strong preference for comfort, status, or premium travel → vip). Default to standard if memory data is missing, conflicting, or unclear. Do not ask the user to choose unless they explicitly mention it.
budgetstandardroad_warriorvipcabin_classstringCabin class for the trip. Use economy unless specified or dictated by the traveller persona.
economypremium_economybusinessfirstparent_itinerary_request_idstringItinerary request ID of the related parent itinerary request, if any.
return_datestringReturn date for the itinerary (YYYY-MM-DD), leave blank if a one way trip. Must be >= from_date. Must be a single date, not a range. Only use date specified by the user (year may be inferred).
time_preferencesobjectOptional time preferences for outbound and return legs. Only include when the user explicitly specifies a time preference. Allow extra time if there are time constraints (e.g. use "arrive-before-1300" for a "meeting at 2").