Alcuni prodotti e funzionalitร sono in fase di rinominazione. Anche le funzionalitร di playbook e flusso generativi sono in fase di migrazione a un'unica console consolidata. Consulta i dettagli.
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Questa guida mostra come creare e testare un semplice agente per ordinare camicie utilizzando i playbook.
Quando interagisci con questo agente,
puoi chiedere la posizione del negozio,
ottenere l'orario di apertura
o ordinare una camicia.
Prima di iniziare
Prima di leggere questa guida, devi:
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.
Un playbook contiene i seguenti dati:
X
Elemento
Nome
Un nome utilizzato per identificare il playbook.
Obiettivo
Gli obiettivi sono descrizioni generali di ciรฒ che il playbook deve 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 in pratica prompt few-shot per l'LLM.
Seleziona Playbook per l'opzione Inizio conversazione.
Fai clic su Crea.
L'interfaccia utente ti reindirizza al playbook predefinito chiamato Playbook generativo predefinito.
Fai clic sul pulsante Indietro per visualizzare l'elenco dei playbook.
Crea il playbook per gli ordini
Il playbook Ordine gestisce gli ordini di camicie.
Per creare questo playbook:
Fai clic su Crea.
Seleziona l'opzione Playbook di 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 sul pulsante Indietro per tornare all'elenco di playbook.
Crea il playbook di informazioni
Il playbook Informazioni risponde alle domande sul negozio.
Per creare questo playbook:
Fai clic su Crea.
Seleziona l'opzione Playbook di 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 sul pulsante Indietro per tornare all'elenco di playbook.
Aggiornare il playbook predefinito
Quando hai creato l'applicazione per la prima volta, รจ stato creato per te un playbook predefinito.
Questo playbook deve indirizzare la conversazione ai playbook appropriati con obiettivi specifici. Nelle istruzioni riportate di seguito, puoi vedere in che modo il playbook predefinito fa riferimento agli altri playbook.
Per aggiornare questa guida pratica:
Fai clic sul playbook predefinito. Questa guida pratica ha una stella evidenziata.
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 the user 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.
Tieni presente che i riferimenti al playbook sono evidenziati
perchรฉ non sono ancora disponibili esempi.
Questi verranno aggiunti nella sezione successiva.
Fai clic sul pulsante Indietro per tornare all'elenco di playbook.
Fornire esempi
A questo punto,
la tua strategia รจ funzionale.
Tuttavia, devi fornire
esempi
per garantire risposte di qualitร .
Puoi fornire manualmente esempi dalla scheda Esempi quando hai aperto un playbook.
Tuttavia, spesso รจ piรน facile avere una conversazione con il playbook funzionante e salvarla come esempio.
Una conversazione di esempio con un playbook predefinito รจ breve.
Questo playbook deve solo indirizzarti a un altro playbook.
Per avere una conversazione con il playbook predefinito:
Chiudi o annulla qualsiasi riquadro presente sul lato destro dello schermo.
Fai clic sul pulsante del simulatore question_answer
nella barra di navigazione della riga superiore.
Per la risorsa, seleziona il playbook predefinito.
Utilizza il modello predefinito o seleziona un'alternativa.
Nella casella di testo Inserisci input utente, digita Hello e premi Invio.
Il playbook risponde con un saluto.
Per salvare questa conversazione come esempio:
Seleziona il playbook predefinito nel menu a discesa Chiamate.
Fai clic sul pulsante Salva come esempio in alto a destra nell'interfaccia.
Viene visualizzato il riquadro dell'editor di esempi.
Puoi utilizzare questo editor per aggiungere, modificare, eliminare o riordinare le azioni.
Fornisci il nome dell'esempio: Greeting.
Aggiorna le risposte del playbook, se necessario.
Scorri verso il basso fino all'esempio di fine con informazioni sull'output
e inserisci The user is greeted. nella sezione Riepilogo.
Fai clic sull'icona di salvataggio.
Aggiungi un esempio di localitร per il playbook di informazioni:
Chiudi o annulla qualsiasi riquadro presente sul lato destro dello schermo.
Se necessario, reimposta la conversazione con il pulsante di reimpostazione restart_alt.
Seleziona il playbook di informazioni nell'elenco a discesa Risorsa iniziale del simulatore.
Inserisci il messaggio: Where are you located?.
Il playbook risponde con una posizione.
Seleziona il playbook di informazioni nel menu a discesa Chiamate.
Fai clic sul pulsante Salva come esempio.
Fornisci il nome di esempio: Location.
Prima di salvare questa conversazione come esempio,
devi eliminare l'azione che contiene "Dove ti trovi".
Solo gli esempi di playbook predefiniti possono iniziare con un'azione utente.
Per fornire all'esempio il contesto che ha avviato la conversazione,
espandi la sezione Riepilogo della conversazione precedenteโฆ
e inserisci quanto segue
nel campo Inizia l'esempio con le informazioni di input:
The customer asked "Where are you located?".
Per fornire all'esempio il contesto che completa la conversazione,
espandi la sezione Riepilogo dell'esecuzione del playbookโฆ
e inserisci quanto segue
nel campo Termina l'esempio con le informazioni sull'output:
The store is located at 1007 Mountain Drive, Gotham City, NJ..
Fai clic sull'icona di salvataggio.
Aggiungi un esempio di orario per il playbook di informazioni:
Come per i passaggi precedenti,
ma inserisci il messaggio: What are your hours? e
assegna il nome all'esempio: Hours.
Aggiungi un esempio di selezione per il playbook dell'ordine:
Come per i passaggi precedenti,
ma assegna all'esempio il nome Selection,
seleziona il playbook per gli ordini
e invia i seguenti messaggi:
I want to buy a shirt
Large
Green
Yes
Testa l'agente
L'agente รจ ora pronto per il test.
Apri il riquadro del simulatore
e parla con l'agente.
Non รจ necessario avere le stesse conversazioni riportate sopra.
Ad esempio,
puoi chiedere a questo agente quali colori sono disponibili per le camicie.
Se non ottieni il comportamento desiderato, perfezionare gli esempi e crearne di nuovi migliorerร le risposte.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema รจ stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-08-18 UTC."],[[["\u003cp\u003eThis guide provides instructions on how to create a shirt ordering agent using playbooks, enabling it to handle requests for store information and shirt orders.\u003c/p\u003e\n"],["\u003cp\u003ePlaybooks are defined by their name, goal, instructions, and examples, and they allow for a structured approach to handling specific tasks within the agent's scope.\u003c/p\u003e\n"],["\u003cp\u003eThe process involves creating separate playbooks for ordering (Order), providing information (Information), and directing conversations (Default Generative Playbook), and each of these playbooks are to be configured with specific goals and instructions.\u003c/p\u003e\n"],["\u003cp\u003eExamples, which are sample conversations, are crucial for improving the quality of the agent's responses and can be added manually or by saving conversations from the simulator.\u003c/p\u003e\n"],["\u003cp\u003eThe agent can be tested within the simulator interface, and the ability to improve the responses are done through refining the provided examples.\u003c/p\u003e\n"]]],[],null,["# Build an agent using playbooks\n\nThis guide shows you how to build and test a simple shirt ordering\nagent using playbooks.\nWhen interacting with this agent,\nyou can ask for the store location,\nget store hours,\nor make a shirt order.\n\nBefore you begin\n----------------\n\nYou should do the following before reading this guide:\n\n1. If you have not already, follow the [setup](/dialogflow/cx/docs/quick/setup) instructions.\n\nAbout playbooks\n---------------\n\nAn agent is composed of one or more playbooks.\nEach playbook has a clearly defined and limited scope.\nA playbook has the following data:\n\nCreate the agent\n----------------\n\nTo create the agent:\n\n1. Go to the Conversational Agents console:\n\n [Conversational Agents console](https://conversational-agents.cloud.google.com)\n2. If you haven't already, select or create a project.\n\n3. Click **Create agent**.\n\n4. Click **Build your own**.\n\n5. Provide \"Shirt Ordering - Playbooks\" for the agent name.\n\n6. Provide a\n [location](/dialogflow/cx/docs/concept/region).\n\n7. Provide a time zone.\n\n8. Provide a\n [default language](/dialogflow/cx/docs/concept/agent-multilingual).\n\n9. Select **Playbook** for the **Conversation start** option.\n\n10. Click **Create**.\n\n11. The user interface takes you to the default playbook\n named **Default Generative Playbook**.\n\n12. Click the back button to see the list of playbooks.\n\nCreate the order playbook\n-------------------------\n\nThe **Order** playbook handles shirt orders.\nTo create this playbook:\n\n1. Click **Create**.\n2. Select the **Task playbook** option.\n3. Enter the playbook name: `Order`.\n4. Enter the following goal:\n\n You are a shirt store ordering assistant. Help customers purchase shirts.\n Help the customer choose a size and color.\n The shirts come in small, medium, and large.\n The shirts can be red, green, or blue.\n\n5. Enter the following instructions:\n\n - If the customer has not provided a size, ask them to choose a size.\n - If the customer has not provided a color, ask them to choose a color.\n - Once the customer has selected a size and color for the shirt,\n repeat the selection to the customer, and ask them to confirm the selection.\n - Once the customer has confirmed their selection,\n let them know that the shirt is now ordered.\n - Do not provide prices or collect payment.\n - Do not collect the customer's name or address.\n\n6. Click **Save**.\n\n7. Click the back button to return to the playbook list.\n\nCreate the information playbook\n-------------------------------\n\nThe **Information** playbook handles questions about the store.\nTo create this playbook:\n\n1. Click **Create**.\n2. Select the **Task playbook** option.\n3. Enter the playbook name: `Information`.\n4. Enter the following goal:\n\n You provide information about a shirt store.\n The store is open between 8 AM and 6 PM every day.\n The store is located at 1007 Mountain Drive, Gotham City, NJ.\n\n5. Enter the following instructions:\n\n - If the customer asks for the store location, provide them with the address.\n - If the customer asks for the store hours, provide them with the hours.\n\n6. Click **Save**.\n\n7. Click the back button to return to the playbook list.\n\nUpdate the default playbook\n---------------------------\n\nWhen you first created the application,\na default playbook was created for you.\nThis playbook should steer the conversation\nto the appropriate playbooks with specific goals.\nIn the instructions below,\nyou can see how the default playbook references the other playbooks.\nTo update this playbook:\n\n1. Click the default playbook. This playbook has a highlighted star.\n2. Enter the following goal:\n\n You are an assistant for a shirt store.\n Your name is \"Samantha\".\n Your job is to direct customers to other playbooks based on the customer's questions.\n\n3. Enter the following instructions:\n\n - If the customer hasn't been greeted yet, greet the customer,\n introduce yourself, and ask the user how you can help.\n - If the customer wants information about the store,\n route them to ${PLAYBOOK: Information}\n - If the customer wants to purchase a shirt,\n route them to ${PLAYBOOK: Order}\n\n4. Click **Save**.\n\n5. Note that the playbook references are highlighted\n because there are no examples yet.\n These will be added in the next section.\n\n6. Click the back button to return to the playbook list.\n\nProvide examples\n----------------\n\nAt this point,\nyour playbook is functional.\nHowever, You must provide\n[examples](/dialogflow/cx/docs/concept/playbook/example)\nto ensure quality responses.\n\nYou can manually provide examples from the **Examples**\ntab when you have a playbook open.\nHowever, it is often easier to have a conversation with the\nfunctioning playbook and save the conversation as an example.\n\nAn example conversation with a default playbook is short.\nThis playbook just needs to direct you to another playbook.\nTo have a conversation with the default playbook:\n\n1. Close or cancel any panel that might be present on the right side of the screen.\n2. Click the simulator question_answer button in the top row navigation.\n3. For resource, select the default playbook.\n4. Use the default model or select an alternative.\n5. In the text box that says **Enter user input** , type `Hello`, then press enter.\n6. The playbook responds with a greeting.\n\nTo save this conversation as an example:\n\n1. Select the default playbook in the **Invocations** dropdown.\n2. Click the **Save as example** button near the top right of the interface.\n3. The example editor panel opens. You can use this editor to add, edit, delete, or reorder actions.\n4. Provide the example name: `Greeting`.\n5. Update the playbook responses as necessary.\n6. Scroll down to the **End example with output information** and enter `The user is greeted.` in the **Summary** section.\n7. Click the save icon.\n\nAdd a location example for the information playbook:\n\n1. Close or cancel any panel that might be present on the right side of the screen.\n2. If necessary, reset the conversation with the reset restart_alt button.\n3. Select the information playbook in the simulator **Start Resource** dropdown.\n4. Enter the message: `Where are you located?`.\n5. The playbook responds with a location.\n6. Select the information playbook in the **Invocations** dropdown.\n7. Click the **Save as example** button.\n8. Provide the example name: `Location`.\n9. Before saving this conversation as an example, you must delete the action that contains \"Where are you located\". Only the default playbook examples can start with a user action.\n10. To provide the example with the context that started the conversation, expand the **Summary of the preceding conversation...** section and enter the following in the **Starts example with input information** field: `The customer asked \"Where are you located?\"`.\n11. To provide the example with the context that completes the conversation, expand the **Summary of the playbook execution...** section and enter the following in the **End example with output information** field: `The store is located at 1007 Mountain Drive, Gotham City, NJ.`.\n12. Click the save icon.\n\nAdd an hours example for the information playbook:\n\n1. Similar to steps above, but enter the message: `What are your hours?` and name the example: `Hours`.\n\nAdd a selection example for the order playbook:\n\n1. Similar to steps above,\n but name the example `Selection`,\n select the order playbook,\n and send the following messages:\n\n - `I want to buy a shirt`\n - `Large`\n - `Green`\n - `Yes`\n\nTest the agent\n--------------\n\nYour agent is now ready to test.\nOpen the simulator panel\nand have a conversation with the agent.\nYou do not need to have the same conversations as above.\nFor example,\nyou can ask this agent which colors are available for shirts.\nIf you are not getting the desired behavior,\nrefining your examples and creating new ones will improve responses.\n\nInteracting with the agent using the API\n----------------------------------------\n\nSee\n[Interactions with the API](/dialogflow/cx/docs/quick/api)."]]
