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 commande de chemises simple de l'agent. Lorsque vous interagissez avec cette application agent, vous pouvez demander l’emplacement du magasin, obtenir les horaires d'ouverture, ou faire une commande de chemises.

Avant de commencer

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

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

À 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.
Objectif	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. Fournir un "assistant de commande de chemises" 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ée Default Agent (Agent par défaut).

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éé pour vous. Cet agent doit orienter la conversation aux 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 indiquer exemples pour garantir des réponses de qualité.

Vous pouvez fournir manuellement des exemples tirés des Exemples lorsqu'un agent est ouvert. Cependant, il est souvent plus facile d'avoir une conversation avec et enregistrer la conversation comme 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 voulez voir le panneau du simulateur qui contient Envoyez un message pour voir comment votre 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 Saisissez 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 avec réinitialiser le bouton 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 "Lieu où vous vous trouvez".

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, et 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. Ouvrir le panneau du simulateur et discutons 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 de nouveaux améliorera les réponses.

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

Voir Interactions avec l'API