Agente predefinito per i viaggi

L'agente predefinito basato sul playbook di Viaggi consente agli utenti di cercare punti di interesse, ricevere consigli di viaggio e prenotare hotel. Se forniti, l'agente utilizza i dati del profilo utente per personalizzare i consigli per l'utente.

Esempi di dialoghi

I seguenti esempi di dialoghi mostrano scenari comuni gestiti da questo agente predefinito.

Ricerca di punti di interesse e prenotazione di hotel

L'utente chiede informazioni sui ristoranti di Washington DC. L'agente consiglia alcuni punti di interesse e l'utente chiede di prenotare un hotel. L'agente raccoglie le informazioni richieste, tra cui hotel, data del check-in, data del check-out, numero di viaggiatori e numero di camere. L'utente conferma le informazioni e l'agente prenota il soggiorno, fornendo all'utente un numero di conferma.

Input utente	Risposta dell'agente
Ciao, ci sono dei buoni ristoranti di pesce a Washington DC?
	Ecco alcuni ristoranti di pesce a Washington DC: - The Oceanaire Seafood Room - Tony and Joe's Seafood Place - Joe's Seafood, Prime Steak & Stone Crab
	Posso aiutarti in altro modo?
Vorrei prenotare un soggiorno di quattro notti a Washington DC
	Ecco alcuni hotel a Washington DC che ho trovato. Quale vuoi prenotare?: - Cambria Hotel Washington D.C. Navy Yard Riverfront - Beacon Hotel & Corporate Quarters - Holiday Inn Washington Capitol - Natl Mall, an IHG Hotel
Il Beacon Hotel sembra buono
	Ottimo, devo solo confermare alcuni dettagli. Soggiornerai per 4 notti, dall'8 al 12 novembre, giusto?
In realtà farò il check-in l'8
	Ok, quindi farai il check-in l'8 novembre e il check-out il 12 novembre?
Sì, è perfetto
	Ottimo, devo solo confermare i dettagli della prenotazione Nome hotel = Beacon Hotel & Corporate Quarters Data di check-in = 8 novembre Data di check-out = 12 novembre Numero di camere = 1 Numero di viaggiatori = 1 È corretto?
Mio figlio verrà con me
	Ok, quindi 2 viaggiatori. Aggiorno i dettagli della prenotazione Nome hotel = Beacon Hotel & Corporate Quarters Data di check-in = 8 novembre Data di check-out = 12 novembre Numero di camere = 1 Numero di viaggiatori = 2 È corretto?
Sì, prenotalo per me
	Ottimo. Abbiamo confermato la tua prenotazione e il numero di conferma è 2UDVXUUV.
	Posso aiutarti in altro modo?
No, è tutto, grazie.
	Grazie per aver viaggiato con Google. Ti auguro una buona giornata.

Ispirazione per viaggi

L'utente dice che vorrebbe portare la sua famiglia in una vacanza sugli sci. L'agente suggerisce alcune destinazioni sciistiche negli Stati Uniti e l'utente chiede se l'agente ha consigli fuori dal paese. L'agente presenta un elenco di destinazioni al di fuori degli Stati Uniti. Infine, l'utente chiede all'agente di prenotare un soggiorno in una delle destinazioni e l'agente presenta un elenco di hotel nelle vicinanze.

Input utente	Risposta dell'agente
Vorrei portare la mia famiglia in una vacanza sugli sci, hai qualche suggerimento?
	Adoro sciare. Ecco alcune destinazioni sciistiche famose negli Stati Uniti: - Arapahoe Basin - Aspen Highlands - Beaver Creek - Breckenridge - Sun Peaks Resort
Stavo pensando a un posto fuori dagli Stati Uniti, hai qualcosa in mente?
	Certo. Ecco alcune destinazioni sciistiche famose al di fuori degli Stati Uniti: - St. Moritz - Niseko United - Hakuba Valley - Nozawa Onsen - Whistler Blackcomb - Big White Ski Resort - Sun Peaks Resort
Ottimo, grazie. Puoi prenotarmi un soggiorno a Whistler Blackcomb?
	Ecco alcuni hotel a Whistler Blackcomb. Quale vuoi prenotare?: - Blackcomb Lodge - Blackcomb Springs Suites - True Ski-in, Ski-out Resort - Pinnacle Hotel Whistler - Fairmont Château Whistler

Impostazione di base

Per configurare questo agente predefinito:

1. Importa l'agente predefinito.
2. Configura gli strumenti forniti con i tuoi servizi esterni, vedi Configurazione degli strumenti.

Configurazione degli strumenti

Questo agente include strumenti utilizzati per l'integrazione con servizi esterni. Puoi utilizzare il programma di installazione degli strumenti predefiniti per eseguire il deployment di codice campione e dati per l'agente predefinito.

Per eseguire il deployment e configurare codice campione e dati per l'agente predefinito di Viaggi, espandi per visualizzare le istruzioni.

1. Scarica il programma di installazione degli strumenti predefiniti in una directory locale.
2. Vai alla directory locale in cui hai scaricato installer.zip.
3. Decomprimi installer.zip e apri la cartella installer.
4. Consulta il file README.md per una panoramica dettagliata del programma di installazione e dei relativi requisiti.
5. Esegui pip install -r requirements.txt per installare i requisiti.
6. Esegui gcloud auth application-default login per eseguire l'autenticazione utilizzando gcloud auth.
7. Esegui il programma di installazione utilizzando python installer.py --project-id=YOUR_GCP_PROJECT_ID --prebuilt-id=travel
8. Dopo aver eseguito il deployment di tutti i servizi richiesti, configura ogni strumento nell'agente predefinito con gli URL forniti registrati dal programma di installazione:

   Generative AI App Builder

   1. Se non hai ancora importato l'agente predefinito, importalo nel tuo progetto.
   2. Vai a Generative AI App Builder.

      Generative AI App Builder

   3. Seleziona il tuo progetto dal menu a discesa della console.
   4. Selezionare l'app.
   5. Fai clic sull'icona degli strumenti.
   6. Per ogni strumento nell'agente, modifica lo schema per sostituire l'URL nel servers: campo con l'endpoint registrato dal programma di installazione.
   7. Fai clic su Salva.

   Dialogflow CX

   1. Se non hai ancora importato l'agente predefinito, importalo nel tuo progetto.
   2. Apri la console Dialogflow CX.
   3. Scegli il tuo progetto Google Cloud.
   4. Seleziona l'agente.
   5. Fai clic sull'icona delle risorse generative.
   6. Fai clic su Strumenti.
   7. Per ogni strumento nell'agente, modifica lo schema per sostituire l'URL nel servers campo con l'endpoint registrato dal programma di installazione.
   8. Fai clic su Salva.
9. Concedi al account di servizio Compute Engine (your-project-number-developer.gserviceaccount.com) il ruolo Utente Cloud Datastore, in modo che le funzioni Cloud Run appena implementate possano accedere a Firestore.

Ricerca di luoghi

Lo strumento places_search viene utilizzato per ottenere informazioni sui punti di interesse, inclusi i punti di interesse vicino a una località.

Ricerca di hotel

Lo strumento hotel_search viene utilizzato per ottenere informazioni sugli hotel, inclusi gli hotel vicino a una località.

Prenotazione hotel

Lo strumento hotel_booking viene utilizzato per creare e ottenere informazioni sulle prenotazioni di hotel.

Ottieni profilo utente

Lo strumento get_user_profile viene utilizzato per recuperare i profili utente che possono essere utilizzati per personalizzare i consigli per l'utente.

Completa

L'agente e le relative integrazioni dovrebbero essere configurati e pronti per il test.