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'ordine di magliette utilizzando i playbook. Utilizza l'agente per chiedere la posizione del negozio, ottenere 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 dovrebbe realizzare.
Istruzioni	Le istruzioni sono passaggi di alto livello da seguire per raggiungere l'obiettivo del playbook.
Esempi	Gli esempi sono conversazioni di esempio tra un utente finale e l'agente. Questi esempi sono di fatto esempi di prompt few-shot per l'LLM.

Crea un agente

Per creare un agente:

Vai alla pagina 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 "Shirt Ordering - Playbooks" 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 indirizza 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 gestisce gli ordini delle magliette.

Per creare il playbook:

Fai clic su Crea.
Seleziona l'opzione Playbook delle 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 informativo

Il playbook Information gestisce le domande sul negozio.

Per creare il playbook:

Fai clic su Crea.
Seleziona l'opzione Playbook delle 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. Puoi vedere come il playbook predefinito fa riferimento agli altri playbook nelle istruzioni riportate di seguito.

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 ci sono ancora 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 predefinita del playbook è breve. Questo playbook deve indirizzare la conversazione a un altro playbook.

Per avviare 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 selezionane uno alternativo.
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 di modifica degli esempi, aggiungi, modifica, elimina o riordina le azioni.
Inserisci Greeting come nome dell'esempio.
Aggiorna le risposte del playbook in base alle tue esigenze.
Nella sezione Termina l'esempio con le informazioni di output, inserisci The user is greeted. nel campo Riepilogo.
Fai clic su Salva.

Esempio di aggiunta di una località per il playbook informativo:

Chiudi o annulla qualsiasi riquadro sul lato destro dello schermo.
Se necessario, reimposta la conversazione con il pulsante di reimpostazione restart_alt.
Seleziona il playbook informativo nel menu Risorsa di avvio del simulatore.
Digita Where are you located? e premi Invio.
Seleziona il playbook informativo nel menu Chiamate.
Fai clic su Salva come esempio.
Inserisci Location come nome dell'esempio.
Elimina l'azione che contiene Where are you located? 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 Inizia l'esempio con le 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 l'esempio con le informazioni di output.
Fai clic su Salva.

Aggiungi un esempio di orari per il playbook informativo:

Seleziona il playbook informativo nel simulatore.
Inserisci il messaggio What are your hours?.
Salva la conversazione come esempio denominato Hours.

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

Assegna all'esempio il nome Selection.
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 camicie. Se non ottieni i risultati desiderati, perfeziona o aggiungi esempi per migliorare le risposte.