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)
• Output: monsterIndex (string): the key of the chosen monster, for example srd_goblin
• 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. In the Choose tool panel, select API workflow under Toolbox.

3. Under Available resources, select the workflow you created in Step 1.

   Your workflow is listed by its project name, nested under a <workspace>/<solution> folder line - so if you renamed the solution in Step 1, look for API Query - 5e Monsters, not the solution name. You can also filter with the Search API workflows box above the list.

Remarque :

Available resources empty, or showing "No tools found"? The workflow must be published before it appears here. Return to Step 1 and complete the Publish to your feed sub-step, then come back and try again.

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 5e SRD for monsters matching a name or creature type. Returns up to 10 candidates with key, name, type, size, challenge rating, and alignment. 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.
5. Open the agent's Properties panel and remove the now-dangling monsters reference from the User prompt: select the x on the monsters chip. The User prompt should be left with only the questDescription chip.

Avertissement :

Deleting the input does not clear the prompt that references it. After step 4 the User prompt still carries a monsters chip, which Studio Web renders in red and flags with an error badge on Inputs. The agent will not run until you remove that chip, so do not skip step 5.

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