Introducción

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.

Al final tendrás UiPathfinder.QuestParser: un agente que recibe solo una descripción de la misión, decide qué buscar, llama a la herramienta Monster Query y devuelve los campos clave del monstruo seleccionado, sin necesidad de una lista rellenada previamente.

Sin una herramienta, el agente depende de la persona que llama para obtener previamente los candidatos y pasarlos como datos. Añadir una herramienta cambia eso: el agente decide en runtime qué buscar, llama a la API y razona sobre los resultados en vivo. Este es el patrón detrás de la mayoría de los flujos de trabajo del agente de producción; el valor del agente proviene de su capacidad de obtener y razonar, no solo de clasificar lo que se le entrega.

Harás lo siguiente:

1. Build a Monster Query API Workflow that calls the 5e SRD.
2. Conéctalo a tu agente de Selector de Monster como herramienta.
3. Actualiza el contrato del agente para reflejar la nueva capacidad.
4. Prueba la herramienta completa utilizando el agente de extremo a extremo.

Tiempo estimado: 30-45 minutos

Qué estás creando

Componente	Detalles
Flujo de trabajo de API	Accepts searchName (string), calls the Open5e 5e SRD API, returns monsterResults array
Entrada del agente: questDescription	string; la descripción de la misión. El agente obtiene sus propios candidatos a través de la herramienta
Salida del agente: monsterIndex	string; the API's key identifier for the selected monster, for example srd_goblin
Salida del agente: monsterName	string; nombre para mostrar del monstruo seleccionado
Salida del agente: monsterType	string; creature type (for example, beast, undead, dragon). The API returns this as an object, so the agent reads type.name
Salida del agente: monsterCr	string; challenge rating. The API returns a number, such as 0.25, which the agent renders as text
Salida del agente: monsterReasoning	string; la explicación del agente de por qué seleccionó este monstruo para la búsqueda

---

Requisitos previos

• Studio Web : se ejecuta en tu navegador; no requiere instalación de escritorio. Abra Studio Web en Chrome, Edge o Firefox antes de comenzar.
• Cuenta de UiPath : regístrate o inicia sesión en UiPath Automation Cloud antes de comenzar.
• Node.js 18+ : necesario para instalar UiPath CLI. Instálalo desde nodejs.org si es necesario.
• UiPath CLI v1.198.0+ - required to deploy the starter. Check with uip --version; install or upgrade with npm install -g @uipath/cli.
• Un agente de Monster Selector en Studio Web : este lab se basa en el agente de Primeros pasos con los agentes de UiPath. Si completó ese laboratorio, su agente ya está allí. Si no es así, implementa el iniciador:

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

Abre Studio Web y confirma que MonsterSelector aparece en tu espacio de trabajo antes de comenzar el paso 1.