Créer une application agent

Preview

Ce produit ou cette fonctionnalité est soumis aux "Conditions des offres de pré-DG" dans la section "Conditions d'utilisation générales" des Conditions spécifiques au service. Les produits et fonctionnalités pré-DG sont disponibles "en l'état" et peuvent bénéficier d'une assistance limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Ce guide vous explique comment créer et tester une simple application d'agent de commande de chemises. Lorsque vous interagissez avec cette application d'agent, vous pouvez demander l'adresse du magasin, obtenir ses horaires d'ouverture ou commander une chemise.

Avant de commencer

Avant de lire ce guide, procédez comme suit :

1. Si ce n'est pas déjà fait, suivez les instructions de setup de Dialogflow.

À propos des applications d'agent

Une application agent est composée d'un ou de plusieurs agents. Chaque agent a un champ d'application clairement défini et limité. Un agent possède les données suivantes:

X	Élément
Nom	Nom permettant d'identifier l'agent.
Goal	Les objectifs sont des descriptions générales de ce que l'agent doit accomplir.
Instructions	Les instructions sont des étapes très générales à suivre pour atteindre l'objectif de l'agent.
Examples	Les exemples sont des exemples de conversations entre un utilisateur final et l'agent. Il s'agit en réalité d'exemples de requêtes few-shot pour le LLM.

Créer l'application

Pour créer l'application:

1. Accédez à la console Agent Builder:

   Console Agent Builder

2. Sélectionnez votre projet dans le menu déroulant de la console.

3. Si vous n'avez pas encore activé l'API, lisez et acceptez les conditions d'utilisation, puis cliquez sur Continuer et activer l'API.

4. Cliquez sur Create a New App (Créer une application) ou New App (Nouvelle application).

5. Sélectionnez Agent.

6. Indiquez "Shirt Ordering Assistant" pour le nom de l'application.

7. Sélectionnez une région.

8. Cliquez sur Créer.

9. L'interface utilisateur vous redirige vers l'agent par défaut nommé Default Agent.

10. Cliquez sur le bouton "Retour" pour afficher la liste des agents.

Créer l'agent de commande

L'agent Order (Commande) gère les commandes de chemises. Pour créer cet agent, procédez comme suit:

1. Cliquez sur Créer.
2. Saisissez le nom: Order.

3. Saisissez l'objectif suivant:

   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. Saisissez les instructions suivantes:

   - 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. Cliquez sur Enregistrer.

   

6. Cliquez sur le bouton "Retour" pour revenir à la liste des agents.

Créer l'agent d'information

L'agent Information gère les questions sur le magasin. Pour créer cet agent, procédez comme suit:

1. Cliquez sur Créer.
2. Saisissez le nom: Information.

3. Saisissez l'objectif suivant:

   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. Saisissez les instructions suivantes:

   - 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. Cliquez sur Enregistrer.

6. Cliquez sur le bouton "Retour" pour revenir à la liste des agents.

Mettre à jour l'agent par défaut

Lorsque vous avez créé l'application, un agent par défaut a été créé. Cet agent doit orienter la conversation vers les agents appropriés avec des objectifs spécifiques. Dans les instructions ci-dessous, vous pouvez voir comment l'agent par défaut référence les autres agents. Pour mettre à jour cet agent:

1. Cliquez sur l'agent par défaut. Une étoile est mise en surbrillance pour cet agent.

2. Saisissez l'objectif suivant:

   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. Saisissez les instructions suivantes:

   - 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. Cliquez sur Enregistrer.

5. Cliquez sur le bouton "Retour" pour revenir à la liste des agents.

Fournir des exemples

À ce stade, votre agent est fonctionnel. Toutefois, Vous devez fournir des exemples pour garantir la qualité des réponses.

Lorsque l'agent est ouvert, vous pouvez fournir des exemples manuellement à partir de l'onglet Exemples. Cependant, il est souvent plus facile d'avoir une conversation avec l'agent fonctionnel et d'enregistrer la conversation en tant qu'exemple.

Un exemple de conversation avec un agent par défaut est court. Cet agent doit simplement vous mettre en relation avec un autre agent. Pour avoir une conversation avec l'agent par défaut:

1. Fermez ou annulez tout panneau qui pourrait se trouver sur le côté droit de l'écran. Vous souhaitez afficher le panneau du simulateur qui contient la commande Send a message to see your agent response (Envoyer un message pour voir comment l'agent répond).
2. Sélectionnez l'agent par défaut.
3. Sélectionnez le modèle gemini-pro.
4. Dans la zone de texte qui indique Enter user input (Saisir l'entrée utilisateur), saisissez Hello, puis appuyez sur Entrée.
5. L'agent répond par un message d'accueil.

Pour enregistrer cette conversation en tant qu'exemple:

1. Cliquez sur le bouton Enregistrer l'exemple en haut à droite de l'interface.
2. L'exemple de panneau de configuration s'ouvre. Vous pouvez utiliser cet éditeur pour ajouter, modifier, supprimer ou réorganiser des actions.
3. Indiquez le nom d'exemple: Greeting.
4. Mettez à jour les réponses de l'agent si nécessaire.

5. Cliquez sur Enregistrer.

   

Ajoutez un exemple de lieu pour l'agent d'information:

1. Fermez ou annulez tout panneau qui pourrait se trouver sur le côté droit de l'écran. Si nécessaire, réinitialisez la conversation à l'aide du bouton de réinitialisation restart_alt.
2. Sélectionnez l'agent d'informations.
3. Sélectionnez le modèle gemini-pro.
4. Saisissez le message: Where are you located?.
5. L'agent répond en indiquant un lieu.
6. Enregistrez cette conversation en tant qu'exemple nommé Location. Seuls les exemples d'agents par défaut peuvent commencer par une action de l'utilisateur. Vous devez donc supprimer l'action contenant "Où vous trouvez-vous ?".

Ajoutez un exemple d'horaires d'ouverture pour l'agent d'information:

1. Comme pour les étapes ci-dessus, mais saisissez le message What are your hours? et nommez l'exemple Hours.

Ajoutez un exemple de sélection pour l'agent de commande:

1. Comme pour les étapes ci-dessus, mais nommez l'exemple Selection, sélectionnez l'agent de commande, puis envoyez les messages suivants:

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

   

Tester l'application agent

Votre application agent est maintenant prête à être testée. Ouvrez le panneau du simulateur et discutez avec l'agent. Vous n'avez pas besoin d'avoir les mêmes conversations que ci-dessus. Par exemple, vous pouvez demander à cette application d'agent quelles sont les couleurs disponibles pour les chemises. Si vous n'obtenez pas le comportement souhaité, affiner vos exemples et en créer d'autres améliorera les réponses.

Interagir avec l'application agent à l'aide de l'API

Consultez Interactions avec l'API.