Questa guida mostra come creare e testare un semplice agente di ordinazione di magliette utilizzando i playbook. Quando interagisci con questo agente, puoi chiedere la posizione del negozio, l'orario di apertura o effettuare un ordine di una maglietta.
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 di alto livello di ciò che deve essere raggiunto con il playbook. |
| 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 realtà esempi di prompt few-shot per l'LLM. |
Crea l'agente
Per creare l'agente:
Vai alla console Conversational Agents:
Se non l'hai ancora fatto, seleziona o crea un progetto.
Fai clic su Crea agente.
Fai clic su Crea personalizzato.
Fornisci "Shirt Ordering - Playbooks" come nome dell'agente.
Fornisci una posizione.
Fornisci un fuso orario.
Fornisci 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 sul pulsante Indietro per visualizzare l'elenco dei playbook.
Crea il playbook dell'ordine
Il playbook Order gestisce gli ordini di magliette. Per creare questo 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 sul pulsante Indietro per tornare all'elenco dei playbook.
Crea il playbook informativo
Il playbook Informazioni gestisce le domande sul negozio. Per creare questo 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 sul pulsante Indietro per tornare all'elenco dei playbook.
Aggiornare il playbook predefinito
Quando hai creato l'applicazione per la prima volta, è stato creato un playbook predefinito. Questo playbook deve indirizzare la conversazione verso i playbook appropriati con obiettivi specifici. Nelle istruzioni riportate di seguito, puoi vedere come il playbook predefinito fa riferimento agli altri playbook. Per aggiornare questa guida pratica:
- Fai clic sul playbook predefinito. Questa guida pratica ha una stella in evidenza.
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 presenti esempi. Questi verranno aggiunti nella sezione successiva.
Fai clic sul pulsante Indietro per tornare all'elenco dei playbook.
Fornire esempi
A questo punto, il tuo playbook è 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 pannello che potrebbe essere presente sul lato destro dello schermo.
- Fai clic sul pulsante del simulatore nella barra di navigazione della prima riga.
- Per la risorsa, seleziona il playbook predefinito.
- Utilizza il modello predefinito o seleziona un'alternativa.
- Nella casella di testo con la dicitura Inserisci input utente,
digita
Hello, quindi premi Invio. - Il playbook risponde con un saluto.
Per salvare questa conversazione come esempio:
- Seleziona il playbook predefinito nel menu a discesa Invocazioni.
- 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 in base alle esigenze.
- Scorri verso il basso fino a Esempio finale con informazioni sull'output
e inserisci
The user is greeted.nella sezione Riepilogo. - Fai clic sull'icona Salva.
Aggiungi un esempio di posizione per il playbook delle informazioni:
- Chiudi o annulla qualsiasi pannello che potrebbe essere presente sul lato destro dello schermo.
- Se necessario, ripristina la conversazione con il pulsante di ripristino restart_alt.
- Seleziona il playbook informativo nel menu a discesa Risorsa iniziale del simulatore.
- Inserisci il messaggio:
Where are you located?. - Il playbook risponde con una posizione.
- Seleziona il playbook delle informazioni nel menu a discesa Invocazioni.
- Fai clic sul pulsante Salva come esempio.
- Fornisci il nome dell'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 dell'utente.
- Per fornire l'esempio con il contesto che ha dato il via alla conversazione,
espandi la sezione Riepilogo della conversazione precedente…
e inserisci quanto segue
nel campo L'esempio inizia con le informazioni di input:
The customer asked "Where are you located?". - Per fornire l'esempio con 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 Salva.
Aggiungi un esempio di orari per il playbook delle informazioni:
- Analogamente ai passaggi precedenti,
inserisci il messaggio:
What are your hours?e assegna al messaggio di esempio il nome:Hours.
Aggiungi un esempio di selezione per il playbook dell'ordine:
Simile ai passaggi precedenti, ma assegna all'esempio il nome
Selection, seleziona il playbook dell'ordine e invia i seguenti messaggi:I want to buy a shirtLargeGreenYes
Testare l'agente
L'agente è ora pronto per il test. Apri il riquadro del simulatore e avvia una conversazione con l'agente. Non è necessario avere le stesse conversazioni riportate sopra. Ad esempio, puoi chiedere a questo agente quali colori sono disponibili per le magliette. Se non ottieni il comportamento desiderato, perfezionare gli esempi e crearne di nuovi migliorerà le risposte.
Interagire con l'agente utilizzando l'API
Consulta Interazioni con l'API.