Introducción

Extienda un agente de UiPath de código bajo con una herramienta de flujo de trabajo de API que consulte el SRD de D&D 5e en runtime.

Este lab crea parte de UiPathFinder, una aplicación de referencia con temas de D&D en UiPath. Amplía un agente creado en el laboratorio Primeros pasos con los agentes de UiPath . Creas un conector de API en vivo que busca el SRD (Documento de referencia del sistema) de D&D 5e y luego das a tu agente de selector de Monster ese conector como herramienta. El agente lo utiliza de forma autónoma en runtime: decide qué buscar, llama a la API y selecciona la mejor coincidencia de los resultados.

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. Cree un flujo de trabajo de la API de Monster Query que llame al SRD de D&D 5e.
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	Acepta searchName (cadena), llama a la API SRD de Open5e D&D 5e, devuelve la matriz monsterResults
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; identificador de slug del monstruo seleccionado
Salida del agente: monsterName	string; nombre para mostrar del monstruo seleccionado
Salida del agente: monsterType	string; tipo de criatura (por ejemplo, bestia, no-muerto, dragón)
Salida del agente: monsterCr	string; Calificación del desafío
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.1+ : necesario para implementar el iniciador. Consulta con uip --version.
• 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.