Crea un'app agente

Anteprima

Questo prodotto o funzionalità è soggetto ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici del servizio. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Questa guida ti mostra come creare e testare un semplice ordine di camicie dell'agente dell'agente. Quando interagisci con questa app dell'agente, puoi chiedere la posizione del negozio, trova gli orari di apertura, o ordinare camicie.

Prima di iniziare

Prima di leggere questa guida, devi procedere nel seguente modo:

1. Se non lo hai già fatto, segui le istruzioni configurazione istruzioni.

Informazioni sulle app degli agenti

Un'app agente è composta da uno o più agenti. Ogni agente ha un ambito ben definito e limitato. Un agente dispone dei seguenti dati:

X	Elemento
Nome	Un nome utilizzato per identificare l'agente.
Obiettivo	Gli obiettivi sono descrizioni di alto livello di ciò che l'agente dovrebbe raggiungere.
Istruzioni	Le istruzioni sono passaggi generali che dovrebbero essere eseguiti per raggiungere l'obiettivo dell'agente.
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'applicazione

Per creare l'applicazione:

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. Fornire "Assistente per gli ordini di camicie" per il nome dell'app.

7. Seleziona una regione.

8. Fai clic su Crea.

9. L'interfaccia utente ti reindirizza all'agente predefinito denominato Default Agent.

10. Fai clic sul pulsante Indietro per visualizzare l'elenco degli agenti.

Crea l'agente dell'ordine

L'agente dell'ordine gestisce gli ordini di camicie. Per creare questo agente:

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

3. Inserisci il seguente obiettivo:

   You are a shirt store ordering agent. 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 di agenti.

Crea l'agente delle informazioni

L'agente per le informazioni gestisce le domande relative al negozio. Per creare questo agente:

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 di agenti.

Aggiorna l'agente predefinito

Quando hai creato l'applicazione per la prima volta, è stato creato un agente predefinito. Questo agente deve indirizzare la conversazione agli agenti appropriati con obiettivi specifici. Nelle istruzioni riportate di seguito, puoi vedere come l'agente predefinito fa riferimento agli altri agenti. Per aggiornare questo agente:

1. Fai clic sull'agente predefinito. Questo agente è contrassegnato da una stella evidenziata.

2. Inserisci il seguente obiettivo:

   You are an agent for a shirt store.
   Your name is "Samantha".
   Your job is to direct customers to other agents 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 di agenti.

Fornisci esempi

A questo punto, se il tuo agente è operativo. Tuttavia, l'Utente deve fornire esempi per garantire risposte di qualità.

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

Una conversazione di esempio con un agente predefinito è breve. Questo agente deve solo indirizzarti a un altro agente. Per avere una conversazione con l'agente 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 l'agente predefinito.
3. Seleziona il modello: gemini-pro.
4. Nella casella di testo Inserisci input utente, digita Hello e premi Invio.
5. L'agente risponde con un saluto.

Per salvare questa conversazione come esempio:

1. Fai clic sulla Pulsante Salva esempio in alto a destra nell'interfaccia.
2. Si apre il riquadro dell'editor di esempio. Puoi utilizzare questo editor per aggiungere, modificare, eliminare o riordinare le azioni.
3. Fornisci il nome di esempio: Greeting.
4. Aggiorna le risposte dell'agente in base alle esigenze.

5. Fai clic su Salva.

   

Aggiungi un esempio di località per l'addetto alle informazioni:

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 l'agente delle informazioni.
3. Seleziona il modello: gemini-pro.
4. Inserisci il messaggio: Where are you located?.
5. L'agente risponde con una posizione.
6. Salva questa conversazione come esempio denominato Location. Solo gli esempi di agenti predefiniti possono iniziare con un'azione utente, quindi devi eliminare l'azione che contiene "Dove ti trovi".

Aggiungi un esempio di orari per l'agente di informazioni:

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 l'agente dell'ordine:

1. Analogamente ai passaggi precedenti, ma denomina l'esempio Selection, seleziona l'agente dell'ordine e invia i seguenti messaggi:

   • I want to buy a shirt
   • Large
   • Green
   • Yes

   

Testa l'app dell'agente

L'app dell'agente è ora pronta per essere testata. Apri il riquadro del simulatore e parlare con l'agente. Non è necessario avere le stesse conversazioni di cui sopra. Ad esempio: puoi chiedere a questa app agente quali colori sono 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'app dell'agente tramite l'API

Consulta Interazioni con l'API.