Alcuni prodotti e funzionalità sono in fase di ridenominazione. Anche le funzionalità di playbook generativo e flusso vengono migrate in un'unica console consolidata.

Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Creare un agente utilizzando i playbook

Crea e testa un agente per l'ordinazione di magliette utilizzando i playbook. Utilizza l'agente per chiedere l'indirizzo del negozio, conoscere gli orari di apertura o effettuare un ordine di magliette.

Prima di iniziare

Se non l'hai ancora fatto, segui le istruzioni di configurazione.

Informazioni sui playbook

Un agente è composto da uno o più playbook. Ogni playbook ha un ambito chiaramente definito e limitato. La tabella seguente descrive i dati di un playbook:

X	Elemento
Nome	Un nome utilizzato per identificare il playbook.
Obiettivo	Gli obiettivi sono descrizioni di alto livello di ciò che il playbook deve raggiungere.
Istruzioni	Le istruzioni sono passaggi di alto livello da intraprendere per raggiungere l'obiettivo del playbook.
Esempi	Gli esempi sono conversazioni di esempio tra un utente finale e l'agente. Questi esempi sono esempi di prompt few-shot per il modello LLM.

Crea un agente

Per creare un agente:

Vai all'indirizzo https://conversational-agents.cloud.google.com.
Se non l'hai ancora fatto, seleziona o crea un progetto.
Fai clic su Crea agente.
Fai clic su Crea personalizzato.
Inserisci "Ordinazione di magliette - Playbook" come nome dell'agente.
Inserisci una località.
Inserisci un fuso orario.
Inserisci una lingua predefinita.
Seleziona Playbook per l'opzione Inizio conversazione.
Fai clic su Crea.
L'interfaccia utente ti porta al playbook predefinito denominato Playbook generativo predefinito.
Fai clic su Indietro per tornare all'elenco dei playbook.

Crea il playbook per gli ordini

Il playbook Order (Ordine) gestisce gli ordini di magliette.

Per creare il playbook:

Fai clic su Crea.
Seleziona l'opzione Playbook attività.
Inserisci il nome del playbook: Order.

Inserisci il seguente obiettivo:

You are a shirt store ordering assistant. Help customers purchase shirts.
Help the customer choose a size and color.
The shirts come in small, medium, and large.
The shirts can be red, green, or blue.

Inserisci le seguenti istruzioni:

- If the customer has not provided a size, ask them to choose a size.
- If the customer has not provided a color, ask them to choose a color.
- Once the customer has selected a size and color for the shirt,
  repeat the selection to the customer, and ask them to confirm the selection.
- Once the customer has confirmed their selection,
  let them know that the shirt is now ordered.
- Do not provide prices or collect payment.
- Do not collect the customer's name or address.

Fai clic su Salva.
Fai clic su Indietro per tornare all'elenco dei playbook.

Crea il playbook per le informazioni

Il playbook Information (Informazioni) gestisce le domande sul negozio.

Per creare il playbook:

Fai clic su Crea.
Seleziona l'opzione Playbook attività.
Inserisci il nome del playbook: Information.

Inserisci il seguente obiettivo:

You provide information about a shirt store.
The store is open between 8 AM and 6 PM every day.
The store is located at 1007 Mountain Drive, Gotham City, NJ.

Inserisci le seguenti istruzioni:

- If the customer asks for the store location, provide them with the address.
- If the customer asks for the store hours, provide them with the hours.

Fai clic su Salva.
Fai clic su Indietro per tornare all'elenco dei playbook.

Aggiorna il playbook predefinito

Quando crei l'agente per la prima volta, viene creato un playbook predefinito. Questo playbook indirizza la conversazione ai playbook appropriati con obiettivi specifici. Nelle istruzioni seguenti puoi vedere come il playbook predefinito fa riferimento agli altri playbook.

Per aggiornare il playbook:

Fai clic sul playbook predefinito, contrassegnato da una stella.

Inserisci il seguente obiettivo:

You are an assistant for a shirt store.
Your name is "Samantha".
Your job is to direct customers to other playbooks based on the customer's questions.

Inserisci le seguenti istruzioni:

- If the customer hasn't been greeted yet, greet the customer,
  introduce yourself, and ask how you can help.
- If the customer wants information about the store,
  route them to ${PLAYBOOK: Information}
- If the customer wants to purchase a shirt,
  route them to ${PLAYBOOK: Order}

Fai clic su Salva.
Nota che i riferimenti al playbook sono evidenziati perché non sono ancora presenti esempi. Li aggiungerai nella sezione successiva.
Fai clic su Indietro per tornare all'elenco dei playbook.

Fornisci esempi

Il playbook è funzionale, ma fornire esempi garantisce risposte di qualità.

Puoi fornire esempi dalla scheda Esempi quando un playbook è aperto. Tuttavia, spesso è più facile avere una conversazione con l'agente e salvarla come esempio.

Una conversazione con il playbook predefinito è breve. Questo playbook deve indirizzare la conversazione a un altro playbook.

Per avere una conversazione con il playbook predefinito:

Chiudi o annulla qualsiasi riquadro che potrebbe essere presente sul lato destro dello schermo.
Tocca il pulsante del simulatore nella riga di navigazione in alto.
Per la risorsa, seleziona il playbook predefinito.
Utilizza il modello predefinito o seleziona un'alternativa.
Nel campo Inserisci input utente , inserisci Hello e premi Invio.
Il playbook risponde con un saluto.

Per salvare questa conversazione come esempio:

Seleziona il playbook predefinito nell'elenco Invocazioni.
Fai clic su Salva come esempio.
Nel riquadro dell'editor di esempi, aggiungi, modifica, elimina o riordina le azioni.
Inserisci Greeting come nome dell'esempio.
Aggiorna le risposte del playbook in base alle esigenze.
Nella sezione Termina esempio con informazioni di output, inserisci The user is greeted. (L'utente viene salutato) nel campo Riepilogo.
Fai clic su Salva.

Aggiungi un esempio di località per il playbook delle informazioni:

Chiudi o annulla qualsiasi riquadro sul lato destro dello schermo.
Se necessario, reimposta la conversazione con il pulsante reset restart_alt.
Seleziona il playbook delle informazioni nel menu del simulatore Avvia risorsa.
Digita Where are you located? (Dove ti trovi?) e premi Invio.
Seleziona il playbook delle informazioni nel menu Invocazioni.
Fai clic su Salva come esempio.
Inserisci Location come nome dell'esempio.
Elimina l'azione che contiene Where are you located? (Dove ti trovi?) perché solo gli esempi di playbook predefiniti possono iniziare con un'azione dell'utente.
Espandi la sezione Riepilogo della conversazione precedente e inserisci The customer asked "Where are you located?" nel campo Avvia esempio con informazioni di input.
Espandi la sezione Riepilogo dell'esecuzione del playbook e inserisci The store is located at 1007 Mountain Drive, Gotham City, NJ. nel campo Termina esempio con informazioni di output.
Fai clic su Salva.

Aggiungi un esempio di orario per il playbook delle informazioni:

Seleziona il playbook delle informazioni nel simulatore.
Inserisci il messaggio What are your hours? (Quali sono i tuoi orari?).
Salva la conversazione come esempio denominato Hours (Orari).

Aggiungi un esempio di selezione per il playbook degli ordini seguendo questi passaggi:

Assegna all'esempio il nome Selection (Selezione).
Seleziona il playbook degli ordini.
Invia i seguenti messaggi:
- I want to buy a shirt
- Large
- Green
- Yes

Testa l'agente

L'agente è ora pronto per essere testato. Apri il riquadro del simulatore e avvia una conversazione con l'agente. Puoi avere conversazioni diverse da quelle descritte in precedenza. Ad esempio, puoi chiedere a questo agente quali colori sono disponibili per le magliette. Se non ottieni i risultati necessari, la perfezionamento o l'aggiunta di esempi migliorerà le risposte.