- Introduction
- Commencer avec les agents UiPath
- Premiers pas avec les agents UiPath utilisant LangGraph
- Créer un agent low-code dans Studio Web
- Ajouter des outils à votre agent UiPath
- Introduction
- Créer le workflow d’API
- Connectez-vous à votre agent
- Tester de bout en bout
- Évaluer la trajectoire de l’agent
- Premiers pas avec le canevas Flux dans UiPath Maestro
Connectez-vous à votre agent
Enregistrez le workflow d'API en tant qu'outil dans l'agent du classifieur de requêtes, décrivez quand l'appeler et remplacez l'invite système pour que l'agent l'utilise.
Étape 2 - Ouvrez l’agent du classifieur de requêtes
Votre solution contient désormais deux projets: l’agent de classifieur de requêtes et le workflow API Query - 5e Monsters que vous venez de créer. Dans l'explorateur de projet, sélectionnez le projet d'agent pour l'ouvrir dans le Agent Builder. Si vous avez déployé le déclencheur, le projet d’agent est Queest-Classifier-Agent.
Examinez la configuration actuelle de l’agent avant d’apporter des modifications:
- Entrée du projet:
questDescription. - Sorties du projet:
tier(chaîne, l'une des quatre valeurs) etreasoning. - Invite système: décrit les quatre niveaux. Si Autopilot l’a écrit ou si vous avez déployé le démarreur, il indique très probablement également à l’agent de classer à partir de la description seule et de ne pas utiliser d’outils.
- Ensemble d’évaluations: les cinq cas du laboratoire low-code. Vous les réexécutez à l'étape 6.
Dans ce lab, vous ne modifiez pas l'entrée ni les sorties. Vous ajoutez un outil et vous remplacez l'invite système pour que l'agent sache comment l'utiliser.
Étape 3 - Connecter le workflow d'API en tant qu'outil
Enregistrez le workflow API Query - 5e Monsters en tant qu'outil sur l'agent, puis donnez-lui le nom et la description que l'agent va lire au moment de l'exécution.
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.
- Sur le canevas de l'agent, sélectionnez + sous Outils.
- Dans le panneau Choisir un outil , sélectionnez Workflow d'API sous Boîte à outils.
- Sous Ressources disponibles, sélectionnez
API Query - 5e Monsters, le workflow que vous avez ajouté à cette solution à l’étape 1. Vous pouvez également filtrer la liste avec la zone Rechercher des workflows d’API .
Si le workflow n’est pas répertorié, vérifiez l’explorateur de projets: API Query - 5e Monsters doit être répertorié dans la même solution que l’agent. Si vous l'avez créé en tant que solution distincte à la place, publiez-le d'abord (Publier > Pour moi) et il apparaît ici sous son nom de projet.
Conserver l’outil dans la solution de l’agent ne nécessite pas d’étape de publication et les évaluations de l’agent l’appellent comme n’importe quel autre outil. Dans vos propres projets, donnez à un outil sa propre solution et publiez-la lorsque plusieurs agents doivent l’appeler.
Configurer la description de l’outil
Donnez un nom et une description à l’outil. Rédigez la description sous forme d’instruction pour l’agent:
- Nom :
Monster Query - Description :
Searches the 5e SRD for monsters whose name contains the search text. Search with the most specific creature name the quest gives; a general term such as a creature type can return many matches and miss the one you need. Returns up to 10 candidates with key, name, type, size, challenge rating, and alignment. Call this tool when a quest names or strongly implies a specific creature, to look up its challenge rating. - nomRecherche (si vide):
The monster name or partial name to search for
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.
Le « nom de la création la plus spécifique » Cette instruction est importante pour cette API. Une recherche de dragon correspond à 43 créations, et les 10 qui revient qui sont tous des UiPath Robots, donc une question concernant un ancien thème de capture ne verra jamais le bon candidat. Une recherche de ancient red dragon renvoie exactement un résultat.
Un workflow d’API est un type d’outil. Les étapes permettant de connecter et de décrire un outil sont les mêmes pour chaque type, et un agent peut également appeler:
- Workflows RPA
- Connecteurs Integration Service, pour des systèmes tels que Slack, Outlook ou un système de planification des ressources d’entreprise
- Document Understanding
- Cas et flux Maestro
- DeepRAG
- Serveurs de protocole de contexte de modèle
- Autres agents, y compris les appels d’agent à distance
Étape 4: remplacer l'invite système
L’invite système actuelle a été écrite pour un agent sans outils. Remplacez-le entièrement plutôt que de l’ajouter: s’il indique à l’agent de ne pas utiliser d’outils, une instruction ajoutée pour appeler Monitor Query le contredit, et l’agent peut ne jamais passer l’appel.
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 l’invite système par:
You are a quest intake classifier for an adventurer's guild in a fantasy RPG world.
Classify the incoming quest description into exactly one difficulty tier:
- Trivial: simple errands anyone can handle (for example, deliver a letter, clear rats from a cellar)
- Standard: moderate quests requiring some adventuring skill (for example, escort a merchant caravan, hunt a wyvern)
- Heroic: difficult quests requiring significant adventuring expertise (for example, slay an adult dragon, infiltrate a thieves' guild)
- Legendary: extreme quests requiring top-tier heroes to complete (for example, defeat a lich, slay an ancient dragon)
Using the Monster Query tool:
- Call Monster Query when the quest description names or strongly implies a specific creature the adventurers must face.
- Creatures include people the party may have to fight, such as bandits or guards.
- Search with the most specific creature name the quest gives.
- Only search for creatures in the quest itself, never for a creature you are using as a comparison or reference point.
- If a search returns no results, you may try one shorter or more general name. Stop after three searches in total.
- If the tool returns more than one result, pick the best fit: name match first, then number (a group of rats fits "Swarm of Rats" better than "Rat"), then type.
Using the challenge rating:
- When the tool returns a challenge_rating, use this map to set the minimum tier: Trivial 0-5, Standard 6-12, Heroic 13-20, Legendary 21 and above.
- Raise the tier above that minimum when the quest describes many opponents, a powerful leader or patron, or a history of failed attempts. One creature's challenge rating is not the difficulty of the whole quest.
- Cite the exact challenge rating in your reasoning.
- Never guess or invent a challenge rating. Only cite one the tool actually returned.
- If you do not call the tool, or it returns nothing that fits, classify from the quest description alone.
Return the tier and a brief, two-sentence reasoning.
You are a quest intake classifier for an adventurer's guild in a fantasy RPG world.
Classify the incoming quest description into exactly one difficulty tier:
- Trivial: simple errands anyone can handle (for example, deliver a letter, clear rats from a cellar)
- Standard: moderate quests requiring some adventuring skill (for example, escort a merchant caravan, hunt a wyvern)
- Heroic: difficult quests requiring significant adventuring expertise (for example, slay an adult dragon, infiltrate a thieves' guild)
- Legendary: extreme quests requiring top-tier heroes to complete (for example, defeat a lich, slay an ancient dragon)
Using the Monster Query tool:
- Call Monster Query when the quest description names or strongly implies a specific creature the adventurers must face.
- Creatures include people the party may have to fight, such as bandits or guards.
- Search with the most specific creature name the quest gives.
- Only search for creatures in the quest itself, never for a creature you are using as a comparison or reference point.
- If a search returns no results, you may try one shorter or more general name. Stop after three searches in total.
- If the tool returns more than one result, pick the best fit: name match first, then number (a group of rats fits "Swarm of Rats" better than "Rat"), then type.
Using the challenge rating:
- When the tool returns a challenge_rating, use this map to set the minimum tier: Trivial 0-5, Standard 6-12, Heroic 13-20, Legendary 21 and above.
- Raise the tier above that minimum when the quest describes many opponents, a powerful leader or patron, or a history of failed attempts. One creature's challenge rating is not the difficulty of the whole quest.
- Cite the exact challenge rating in your reasoning.
- Never guess or invent a challenge rating. Only cite one the tool actually returned.
- If you do not call the tool, or it returns nothing that fits, classify from the quest description alone.
Return the tier and a brief, two-sentence reasoning.
La carte d'évaluation des défis définit le niveau minimum, et le contexte de la requête peut l'augmenter:
| Création | Évaluation des défis | Niveau minimum |
|---|---|---|
| Garde | 0,125 | Trivia |
| Essaim de Apps | 0.25 | Trivia |
| Wynn | 6 | Standard |
| Ajouter un Red Robot | 17 | Hérité |
| Ancienne version de Red disponibles | 24 | Légendaire |
Une requête avec des garde-fous commence à Trivia, mais elle indique que les gardes sont nombreux et que personne n'est revenu pour augmenter le niveau.
Maintenez les exemples dans l'invite cohérents avec la carte. Un exemple peut se situer au-dessus du niveau minimum de sa création, mais jamais au-dessous: la liste suivante: « référentiel » comme exemple triviale contredit la carte, car la valeur minimale d'une Wynn est Standard. Une contradiction qui rend le niveau de l’agent imprévisible.
Les schémas d'entrée et de sortie ne changent pas. La note du défi se place dans le texte reasoning .
Les agents sont non déterministes. Les termes de recherche et le raisonnement de votre agent varient d’une exécution à l’autre. Une exécution correcte appelle l'outil lorsqu'une requête nomme une création, l'ignore lorsque ce n'est pas le cas et cite uniquement les notes de défi renvoyées par l'outil.
Avec l’outil connecté et l’invite système remplacée, vous pouvez tester l’agent dans la section suivante.