Connectez-vous à votre agent

Enregistrez le workflow d'API en tant qu'outil dans votre agent Extraire et mettez à jour le schéma d'entrée de l'agent.

Une fois le workflow publié, il est disponible dans Agent Builder en tant qu'outil connectable.

Étape 2 - Ouvrez l’agent Monitor Selector

Dans Studio Web, naviguez à votre solution MonsterSelector et ouvrez-la dans l'Agent Builder.

Prenez quelques instants pour vous renseigner sur son état actuel avant d’apporter des modifications:

• Entrée: questDescription et monsters (tableau des candidats transmis par l'appelant)
• Sortie: monsterIndex : le champ de données dynamique du robot choisi
• Requête système: indique à l'agent de choisir la meilleure correspondance dans la liste fournie

Dans ce labellisation, vous supprimez l'entrée monsters et l'exigence de pré-remplir les candidats. L'agent les récupère lui-même à l'aide de l'outil que vous venez de créer.

---

Étape 3 - Connecter le workflow d'API en tant qu'outil

Ajouter l’outil

Assurez-vous que vous êtes dans la vue Zone de dessin : utilisez le bouton bascule Zone de dessin/Formulaire en haut de l'Agent Builder. Le bouton + sous Outils est uniquement visible dans la vue Zone de dessin.

1. Sur le canevas de l'agent, sélectionnez + sous Outils.
2. Dans le panneau Boîte à outils , sélectionnez Workflow d’API.
3. Dans le panneau Ressources disponibles , sélectionnez le workflow que vous avez créé à l’étape 1.

Remarque :

Les ressources disponibles sont vides? Le workflow doit être publié avant d'apparaître ici. Retournez à l'étape 1 et terminez la sous-étape Publier dans votre flux , puis revenez et réessayez.

Configurer la description de l’outil

Donnez un nom et une description à l’outil. La description est ce que l'agent lit au moment de l'exécution pour décider quand et comment appeler l'outil; rédigez-le sous forme d'instruction pour l'agent, et non de libellé pour les humains:

• Nom : Monster Query
• Description : Searches the D&D 5e SRD for monsters matching a name or creature type. Returns up to 10 candidates with name, type, CR, size, alignment, and description. Call this tool when you need to find monster candidates for a quest.

Remarque :

La description détermine la sélection de l’outil. L'agent lit cette description (et non le nom de l'outil) pour décider quand et comment appeler l'outil. Une description vague produit une utilisation vague de l'outil. Soyez précis sur ce que l’outil renvoie et quand l’utiliser.

---

Étape 4 - Mettre à jour le contrat de l’agent

Lorsque l’outil est connecté, mettez à jour la définition de l’agent pour refléter le nouveau contrat: l’agent n’a plus besoin d’une liste de Robots préremplie et il renvoie désormais des données de Robot structurées incluant son propre raisonnement.

Les trois modifications apportées à cette étape fonctionnent conjointement: la suppression de monsters met fin à la dépendance de l’agent vis-à-vis de l’appelant pour les données; le schéma de sortie déclare ce que l’agent s’engage à renvoyer; l'invite mise à jour indique à l'agent comment utiliser sa nouvelle fonctionnalité. Aucun des trois ne fonctionne sans les autres.

Pour modifier la définition de l'agent, sélectionnez le nœud de l'agent sur le canevas pour ouvrir le panneau de définition à droite.

Supprimer les Filtres de l'entrée

Dans la définition de l’agent, supprimez la propriété monsters du schéma d’entrée. L'entrée mise à jour doit uniquement comporter questDescription.

Pour supprimer la propriété monsters :

1. Dans l'agent, ouvrez le gestionnaire de données en sélectionnant l'icône Ouvrir le gestionnaire de données le long de la barre de navigation gauche (cela ressemble à un presse-papiers).
2. Le panneau Data Manager comprend trois groupes: Entrées, Sorties et Variables; monsters doit se trouver dans la liste des entrées .
3. Pointez sur monsters pour révéler les icônes de modification et de suppression à droite du libellé: une icône en forme de crayon (modifier) et une icône de corbeille (supprimer).
4. Sélectionnez l'icône de suppression pour supprimer monsters.

Vous devriez maintenant n'avoir qu'une seule entrée: questDescription:

Champ	Saisie de texte	Requis	Description
questDescription	string	Oui (Yes)	Description de la requête

Ajouter le schéma de sortie

Ajoutez un schéma de sortie avec les cinq champs de la table de conception dans Ce que vous construisez.

Dans le même panneau Data Manager :

1. Pointez sur l'en-tête Sorties pour afficher l'icône Ajouter une propriété (+).
2. Sélectionnez Ajouter une propriété pour ajouter chacun des champs ci-dessous:

Champ	Saisie de texte
monsterIndex	string
monsterName	string
monsterType	string
monsterCr	string
monsterReasoning	string

Remarque :

monsterReasoning est généré par l'agent, et non à partir de l'API. L'agent écrit ce champ lui-même: il s'agit de l'explication de l'agent expliquant pourquoi le Robot sélectionné correspond à la requête. Contrairement aux quatre autres champs (qui proviennent des résultats de l'outil), monsterReasoning reflète le propre jugement de l'agent.

Mettre à jour l’invite système

Pour ouvrir le panneau Propriétés , sélectionnez l'agent sur le canevas ou sélectionnez l'icône en forme de clé dans le coin supérieur droit. Remplacez le message système par:

You are a quest classifier for an adventurer's guild. Given a quest description, your job is to find the most thematically appropriate monster from the D&D 5e SRD and to return information about that monster.

When given a quest description:
1. Analyze the quest to determine what kind of creature fits the context - consider creature type, challenge rating, environment, and theme.
2. Call the Monster Query tool with a search term that targets that creature type.
3. Review the returned candidates and select the best fit for the quest.
4. Return the selected monster's key fields and a monsterReasoning that explains why this monster fits the quest.

Always call the Monster Query tool before selecting a monster. Do not guess monster details from memory.

Important :

Les agents de codage sont non déterministes. Votre invite produira des résultats différents de ceux de l’exemple ci-dessus; ce qui est attendu. Ce qui compte, c'est que l'agent appelle l'outil, raisonne sur les candidats et renvoie les cinq champs de sortie requis.

---

Une fois l'outil connecté et le contrat de l'agent mis à jour, vous êtes prêt à tester l'ensemble du pipeline dans la section suivante.