Travel
Search, book, list and cancel business travel under the organisation's travel policy. Used by the Travel Desk.
| Tool | What it does |
|---|---|
travel_search | Searches flights, hotels or rail for one leg or stay and returns up to eight offers, each with an offer_id and a policy mark. |
travel_book | Books the chosen offers. |
travel_trips | Lists the traveller's own trips, newest first — used to resolve "my Berlin trip" before changing or cancelling it. |
travel_cancel | Cancels one of the traveller's own trips by id or booking reference and returns the refund terms. |
travel_search
Searches flights, hotels or rail for one leg or stay and returns up to eight offers, each with an offer_id and a policy mark.
How an agent gets it. Declare it in the agent's tools: list. Bound per run by the Travel Desk runtime; the provider (simulated by default) is set by an admin.
- Registers an
OFFERS-<KIND>-<n>dataset a chart can reference. Simulated offers say so.
Arguments
| Argument | Type | Required | Meaning |
|---|---|---|---|
kind | one of flight, hotel, rail | yes | |
origin | string | City or IATA code (not for hotels). | |
destination | string | yes | City or IATA code. |
depart_date | string | yes | YYYY-MM-DD (hotel: check-in). |
return_date | string | YYYY-MM-DD (hotel: check-out). | |
travellers | integer | ||
cabin | string | flight cabin or rail class. | |
constraints | string | e.g. 'arrive before 09:00'. | |
max_results | integer | ||
purpose_kind | one of business, personal |
travel_book
Books the chosen offers. A write: it always pauses for approval, and the approver reads the summary and policy_check it carries.
How an agent gets it. Declare it in the agent's tools: list. Bound per run by the Travel Desk runtime; the provider (simulated by default) is set by an admin.
- An out-of-policy offer needs an exception reason. Personal trips are planned, never booked.
- Re-priced at booking; an expired or changed offer comes back as an error to search again.
Arguments
| Argument | Type | Required | Meaning |
|---|---|---|---|
summary | string | yes | One line for the approver: route, dates, cabin, hotel, total, policy. |
offer_ids | array of string | yes | |
quoted_total | number | null | The total the traveller saw, so a price change is caught. | |
trip | object | yes | Fields: origin, destination, depart_date, return_date, travellers, purpose, purpose_kind, cost_centre. |
policy_check | object | yes | Fields: within_policy, notes, exception_reason, citations. |
trip_id | string | null | When changing an existing trip: the trip being replaced. |
travel_trips
Lists the traveller's own trips, newest first — used to resolve "my Berlin trip" before changing or cancelling it.
How an agent gets it. Declare it in the agent's tools: list. Bound per run by the Travel Desk runtime; the provider (simulated by default) is set by an admin.
Arguments
| Argument | Type | Required | Meaning |
|---|---|---|---|
status | one of booked, cancelled, changed | ||
upcoming | boolean | Only trips departing from today. |
travel_cancel
Cancels one of the traveller's own trips by id or booking reference and returns the refund terms. Destructive: it always pauses for approval.
How an agent gets it. Declare it in the agent's tools: list. Bound per run by the Travel Desk runtime; the provider (simulated by default) is set by an admin.
Arguments
| Argument | Type | Required | Meaning |
|---|---|---|---|
trip_id | string | null | ||
booking_ref | string | null | e.g. TRV-7K3M9Q | |
reason | string |