Crea un agente utilizzando i playbook

Nota: la console di Agent Builder continua a fare riferimento ai playbook come agenti. A breve verrà aggiornato in playbook nella console.

Questa guida ti mostra come creare e testare un semplice ordine di camicie tramite 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:

1. Se non l'hai ancora fatto, segui le istruzioni per la configurazione di Dialogflow.

Informazioni sui playbook

Un agente è composto da uno o più playbook. Ogni playbook ha un ambito chiaramente definito e limitato. Un playbook ha i seguenti dati:

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

Crea l'agente

Per creare l'agente:

1. Vai alla console di Agent Builder:

   Console di Agent Builder

2. Seleziona il progetto dal menu a discesa della console.

3. Se non hai già attivato l'API, leggi e accetta i Termini di servizio, quindi fai clic su Continua e attiva l'API.

4. Fai clic su Crea una nuova app o Nuova app.

5. Seleziona Agente.

6. Inserisci "Assistente per l'ordine di camicie" come nome dell'app.

7. Seleziona una regione.

8. Fai clic su Crea.

9. L'interfaccia utente ti reindirizza al playbook predefinito denominato Default Agent.

10. 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:

1. Fai clic su Crea.
2. Inserisci il nome: Order.

3. 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.
   

4. 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.
   

5. Fai clic su Salva.

   

6. Fai clic sul pulsante Indietro per tornare all'elenco dei playbook.

Crea il playbook di informazioni

Il playbook Informazioni gestisce le domande relative al negozio. Per creare questo playbook:

1. Fai clic su Crea.
2. Inserisci il nome: Information.

3. 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.
   

4. 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.
   

5. Fai clic su Salva.

6. Fai clic sul pulsante Indietro per tornare all'elenco dei playbook.

Aggiorna il playbook predefinito

Quando hai creato l'applicazione per la prima volta, è stato creato per te un playbook predefinito. Questo playbook dovrebbe indirizzare la conversazione ai playbook appropriati con obiettivi specifici. Nelle istruzioni riportate di seguito, vedrai come il playbook predefinito fa riferimento agli altri playbook. Per aggiornare questo playbook:

1. Fai clic sul playbook predefinito. Questa guida pratica ha una stella evidenziata.

2. 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.
   

3. 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 ${AGENT: Information}
   - If the customer wants to purchase a shirt,
     route them to ${AGENT: Order}
   

4. Fai clic su Salva.

5. Fai clic sul pulsante Indietro per tornare all'elenco dei playbook.

Fornisci esempi

A questo punto, che il tuo playbook sia funzionante. Tuttavia, l'Utente deve fornire esempi per garantire risposte di qualità.

Puoi fornire manualmente esempi tratti dalla sezione Esempi quando hai un playbook aperto. Tuttavia, spesso è più facile conversare con playbook funzionante e salvare la conversazione come esempio.

Un esempio di conversazione con un playbook predefinito è breve. Questa guida pratica deve solo indirizzarti a un'altra guida pratica. Per avere una conversazione con il playbook predefinito:

1. Chiudi o annulla gli eventuali riquadri presenti sul lato destro della schermata. Vuoi vedere il riquadro del simulatore che contiene Invia un messaggio per vedere come risponde l'agente.
2. Seleziona il playbook predefinito.
3. Seleziona il modello: gemini-pro.
4. Nella casella di testo Inserisci input utente, digita Hello e premi Invio.
5. Il playbook risponde con un saluto.

Per salvare questa conversazione come esempio:

1. Fai clic sul pulsante Salva esempio nella parte in alto a destra dell'interfaccia.
2. Viene visualizzato il riquadro dell'editor di esempi. Puoi utilizzare questo editor per aggiungere, modificare, eliminare o riordinare le azioni.
3. Fornisci il nome dell'esempio: Greeting.
4. Aggiorna le risposte del playbook in base alle esigenze.

5. Fai clic su Salva.

   

Aggiungi un esempio di posizione per il playbook informativo:

1. Chiudi o annulla gli eventuali riquadri presenti sul lato destro della schermata. Se necessario, reimposta la conversazione con Ripristina il pulsante restart_alt.
2. Seleziona il playbook di informazioni.
3. Seleziona il modello: gemini-pro.
4. Inserisci il messaggio: Where are you located?.
5. Il playbook risponde con una posizione.
6. Salva questa conversazione come esempio denominato Location. Solo gli esempi di playbook predefiniti possono iniziare con un'azione dell'utente, quindi devi eliminare l'azione che contiene "Dove ti trovi".

Aggiungi un esempio di orari per il playbook informativo:

1. Analogamente ai passaggi precedenti, ma inserisci il messaggio: What are your hours? e assegna all'esempio il seguente nome: Hours.

Aggiungi un esempio di selezione per il playbook dell'ordine:

1. Analogamente ai passaggi precedenti, ma denomina l'esempio Selection, seleziona la guida pratica sugli 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 di cui sopra. Ad esempio: puoi chiedere a questo agente quali sono i colori disponibili per le magliette. Se il comportamento desiderato non è quello desiderato, il perfezionamento degli esempi e la creazione di nuovi esempi miglioreranno le risposte.

Interazione con l'agente tramite l'API

Consulta Interazioni con l'API.