Componi il viaggio
componi_viaggioSolo per residenti in Italia con partenza dall'Italia: se il cliente dice il contrario, spiegalo con garbo e non avviare il viaggio; la residenza non si chiede. Compone un viaggio con il volo a pezzi, sul server: con azione avvia salva il viaggio (stessi limiti di quote_trip: al massimo 3 viaggi per conversazione) e risponde subito con status searching e quote_id; volo, date degli hotel dagli orari veri del volo, hotel e auto si cercano in background (attendi_viaggio). Arrivo fra mezzanotte e le 6: la prima notte è quella prima dell'arrivo. Se la prima o l'ultima tappa resta senza notti (zero_nights) non si cerca: proponi al cliente di allungare il viaggio o togliere la tappa e avvia un nuovo viaggio. Con azione cambia_tappa (quote_id, stop_index, stop) cerchi un'altra località per una tappa no_availability, no_suitable_hotel o error, con le stesse date, solo dopo il sì del cliente: volo, altre tappe e auto restano; per una tappa timeout (il fornitore degli hotel non ha risposto in tempo) o error (errore del servizio) puoi anche ripetere la stessa località con le stesse coordinate, se il cliente lo chiede: si riprova solo quella tappa, mai il viaggio né la ricerca del volo; al massimo 3 volte per tappa (changes_left), una ricerca per richiesta. Con azione testi (quote_id, testi), solo a viaggio completo, scrivi i testi della pagina pubblica del viaggio: title, summary, description e days come in quote_trip, con le stesse regole e lunghezze (un giorno per ogni notte chiesta con avvia, più uno); sotto le soglie risponde con i motivi da correggere. Gestisce anche le preferenze del volo (preferences.flight: scali, bagaglio in stiva, orari): con la ricerca unica del volo il server sceglie il volo più economico che le rispetta e le date degli hotel seguono quel volo; se nessun volo le rispetta propone il più economico e lo dice in preference_notes. Uscite col solo totale a persona, a viaggio completo, con booking_url. Usalo sempre per un viaggio con il volo: quote_trip lo rifiuta. Mai per un viaggio senza volo (usa quote_trip). Con azione conferma_aeroporto (quote_id, accetta) il cliente accetta (true) o rifiuta (false) l'aeroporto diverso da quello chiesto quando lo stato è needs_review con review_reason airport_substitute: con il sì il viaggio si chiude senza nuove ricerche, con il no il viaggio finisce con errore airport_declined.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"azione": "<azione>"
},
"name": "componi_viaggio"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| stop | No | ||
| testi | No | ||
| azione | Yes | avvia: nuovo viaggio (serve viaggio). cambia_tappa: un'altra località per una tappa senza strutture, o la stessa per una tappa timeout o error (servono quote_id, stop_index, stop). testi: i testi della pagina del viaggio, solo a viaggio completo (servono quote_id e testi). conferma_aeroporto: la risposta del cliente all'aeroporto sostituto, solo con status needs_review e review_reason airport_substitute (servono quote_id e accetta). | |
| accetta | No | Per conferma_aeroporto: true = il cliente accetta l'aeroporto proposto, false = lo rifiuta. | |
| viaggio | No | ||
| quote_id | No | Per cambia_tappa e testi: il quote_id restituito da avvia. | |
| stop_index | No | Per cambia_tappa: la tappa da cambiare (da 0, come stops[].stop_index). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| car | No | ||
| error | No | ||
| stops | No | ||
| flight | No | ||
| status | Yes | searching (chiama attendi_viaggio), complete, needs_review (una tappa da rivedere col cliente), error. | |
| currency | No | ||
| quote_id | Yes | ||
| next_step | Yes | Cosa fare adesso. | |
| travelers | No | ||
| link_until | No | ||
| per_person | No | Solo con complete: il totale del viaggio a persona, al centesimo, come sul sito (1224.5 = € 1.224,50). L'unico prezzo da dire: scrivilo come per_person_text. | |
| price_note | No | ||
| booking_url | No | Solo con complete: il link da mostrare così com'è. | |
| retry_after | No | ||
| review_reason | No | Con needs_review: airport_substitute = si aspetta il sì del cliente all'aeroporto sostituto (nessun totale né link). | |
| per_person_text | No | Solo con complete: per_person già scritto come sul sito (per esempio «€ 1.224,50»): da dire così com'è. | |
| airport_substitute | No | ||
| taxes_at_property_per_person | No | Solo con complete: tasse da pagare in hotel, a persona, non comprese. |