Introduction

Extend a low-code UiPath agent with an API Workflow tool that queries the 5e SRD at runtime.

This lab builds part of UiPathfinder, an RPG Adventure system built on UiPath for a fictional Adventurer's Guild. It extends an agent built in the Getting Started with UiPath Agents lab. You build a live API connector that searches the 5e SRD (System Reference Document), then give your Monster Selector agent that connector as a tool. The agent uses it autonomously at runtime: deciding what to search for, calling the API, and selecting the best match from the results.

À la fin, vous aurez UiPathfinder.QuestParser: un agent qui reçoit uniquement une description de la demande, décide ce qu'il faut rechercher, appelle l'outil Monstre requête et renvoie les champs clés du Robot sélectionné, sans liste préremplie requise.

Sans outil, l'agent dépend de l'appelant pour préextraire les candidats et les transmettre sous forme de données. L'ajout d'un outil modifie les éléments suivants: l'agent décide au moment de l'exécution des éléments à rechercher, appelle l'API et raisonne sur les résultats en direct. Il s'agit du modèle qui sous-tend la plupart des workflows d'agent de production; la valeur de l'agent vient de sa capacité à récupérer et à raisonner, et pas seulement à classer ce qui lui est transmis.

Vous allez procéder comme suit:

1. Build a Monster Query API Workflow that calls the 5e SRD.
2. Connectez-le à votre agent Monsélectionner en tant qu'outil.
3. Mettez à jour le contrat de l’agent pour refléter la nouvelle fonctionnalité.
4. Testez l'ensemble de l'agent utilisant l'outil de bout en bout.

Temps estimé: 30 à 45 minutes

Ce que vous créez

Composant (Component)	Détails (Details)
Workflow d’API	Accepts searchName (string), calls the Open5e 5e SRD API, returns monsterResults array
Entrée de l’agent: questDescription	string; la description de la requête. L'agent récupère ses propres candidats via l'outil
Sortie de l’agent: monsterIndex	string; the API's key identifier for the selected monster, for example srd_goblin
Sortie de l’agent: monsterName	string; nom complet du robot sélectionné
Sortie de l’agent: monsterType	string; creature type (for example, beast, undead, dragon). The API returns this as an object, so the agent reads type.name
Sortie de l’agent: monsterCr	string; challenge rating. The API returns a number, such as 0.25, which the agent renders as text
Sortie de l’agent: monsterReasoning	string; l'explication de l'agent concernant la raison pour laquelle il a sélectionné ce Extrait pour la requête

---

Prérequis

• Studio Web : s'exécute dans votre navigateur; aucune installation de bureau requise. Ouvrez Studio Web dans Chrome, Edge ou Firefox avant de commencer.
• Compte UiPath : inscrivez-vous ou connectez-vous sur UiPath Automation Cloud avant de commencer.
• Node.js 18+ : requis pour installer la UiPath CLI. Installez depuis nodejs.org si nécessaire.
• UiPath CLI v1.198.0+ - required to deploy the starter. Check with uip --version; install or upgrade with npm install -g @uipath/cli.
• Un agent de sélection Monstre dans Studio Web : ce laboratoire s'appuie sur l'agent de la section Premiers pas avec les agents UiPath. Si vous avez terminé ce travail, votre agent est déjà là. Si ce n’est pas le cas, déployez le démarrage:

git clone https://github.com/cliff-simpkins/UiPath-Workshops.git
cd UiPath-Workshops/starters/monster-selector
uip login
uip solution upload .

Ouvrez Studio Web et confirmez que Monsecteur apparaît dans votre espace de travail avant de commencer l'étape 1.