- Introducción
- Primeros pasos con los agentes de UiPath
- Primeros pasos con los agentes de UiPath utilizando LangGraph
- Crear un agente de código bajo en Studio Web
- Añadir herramientas a tu agente de UiPath
- Primeros pasos con el lienzo de flujo en UiPath Maestro
Conéctese a su agente
Registra el flujo de trabajo de la API como una herramienta en el agente clasificador de quest, describe cuándo llamarlo y reemplaza la solicitud del sistema para que el agente lo utilice.
Paso 2: abrir el agente clasificador de búsqueda
Tu solución ahora contiene dos proyectos: el agente clasificador de búsqueda y el flujo de trabajo API Query - 5e Monsters que acabas de crear. En el explorador de proyectos, selecciona el proyecto de agente para abrirlo en Agent Builder. Si implementaste el iniciador, el proyecto de agente es Quest-Classifier-Agent.
Revisa la configuración actual del agente antes de realizar cambios:
- Entrada del proyecto:
questDescription(cadena). - Salidas del proyecto:
tier(cadena, uno de cuatro valores) yreasoning(cadena). - Solicitud del sistema: describe los cuatro niveles. Si Autopilot lo escribió, o implementaste el iniciador, lo más probable es que también le diga al agente que clasifique solo a partir de la descripción y que no utilice herramientas.
- Conjunto de evaluación: los cinco casos del laboratorio de código bajo. Los vuelves a ejecutar en el paso 6.
En este lab, no cambias la entrada ni las salidas. Añades una herramienta y reemplazas la solicitud del sistema para que el agente sepa cómo utilizarla.
Paso 3: conectar el flujo de trabajo de la API como herramienta
Registra el flujo de trabajo API Query - 5e Monsters como una herramienta en el agente y, a continuación, dale el nombre y la descripción que el agente lee en runtime.
Añadir la herramienta
Asegúrate de estar en la vista Lienzo : utiliza el botón Lienzo/Formulario en la parte superior de Agent Builder. El botón + en Herramientas solo es visible en la vista de Lienzo.
- En el lienzo del agente, selecciona + en Herramientas.
- En el panel Elegir herramienta , selecciona Flujo de trabajo de API en Caja de herramientas.
- En Recursos disponibles,
API Query - 5e Monsters, el flujo de trabajo que has añadido a esta solución en el paso 1. También puedes filtrar la lista con el cuadro Buscar flujos de trabajo de la API .
Si el flujo de trabajo no aparece en la lista, consulta el explorador de proyectos: API Query - 5e Monsters debe aparecer en la misma solución que el agente. Si lo creaste como una solución independiente, publícalo primero (Publicar > Para mí), y aparece aquí bajo su nombre de proyecto.
Mantener la herramienta en la solución del agente no necesita ningún paso de publicación, y las evaluaciones del agente la llaman como cualquier otra herramienta. En tus propios proyectos, da a una herramienta su propia solución y publícala cuando más de un agente necesite llamarla.
Configurar la descripción de la herramienta
Asigna un nombre y una descripción a la herramienta. Escribe la descripción como una instrucción para el agente:
- Nombre:
Monster Query - Descripción:
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. - NombreDeBúsqueda (si está vacío):
The monster name or partial name to search for
La descripción impulsa la selección de herramientas. El agente lee esta descripción, no el nombre de la herramienta, para decidir cuándo y cómo llamar a la herramienta.
El "nombre de criatura más específico" la instrucción es importante para esta API. Una búsqueda de dragon coincide con 43 criaturas, y las 10 que devuelven son todos dragones adultos, por lo que una búsqueda sobre un antiguo dragón rojo nunca ve al candidato adecuado. Una búsqueda de ancient red dragon devuelve exactamente un resultado.
Un flujo de trabajo de API es un tipo de herramienta. Los pasos para conectar y describir una herramienta son los mismos para cada tipo, y un agente también puede llamar:
- Flujos de trabajo de RPA
- Conectores de Integration Service, para sistemas como Slack, Outlook o un sistema de planificación de recursos empresariales (ERP)
- Document Understanding
- Casos y flujos de Maestro
- DeepRAG
- Servidores de protocolo de contexto de modelo (MCP)
- Otros agentes, incluidas las llamadas remotas de agente a agente
Paso 4: reemplaza la solicitud del sistema
La solicitud del sistema actual se escribió para un agente sin herramientas. Reemplázalo por completo en lugar de añadirlo: si le dice al agente que no use herramientas, una instrucción adjunta para llamar a Monster Query lo contradice y es posible que el agente nunca haga la llamada.
Para abrir el panel Propiedades , selecciona el agente en el lienzo o selecciona el icono de llave inglesa en la esquina superior derecha. Sustituye la solicitud del sistema por:
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.
El mapa de clasificación de desafíos establece el nivel mínimo, y el contexto de la misión puede aumentarlo:
| Criatura | Calificación del desafío | Nivel mínimo |
|---|---|---|
| Guardia | 0,125 | Trivial |
| Enjambre de ratas | 0.25 | Trivial |
| Guiverno | 6 | Estándar |
| Dragón rojo adulto | 17 | Heroico |
| Dragón rojo antiguo | 24 | Leyenda |
Una misión con guardias comienza en Trivial, pero una que dice que los guardias son muchos y nadie ha vuelto eleva el nivel.
Mantén los ejemplos en la solicitud coherentes con el mapa. Un ejemplo puede estar por encima del nivel mínimo de su criatura, pero nunca por debajo de él: enumerar "cazar un wyvern" como ejemplo Trivial contradice el mapa, porque el mínimo de un wyvern es Estándar. Una contradicción como esa hace que el nivel del agente sea impredecible.
Los esquemas de entrada y salida no cambian. La clasificación del desafío va en el texto reasoning .
Los agentes no son deterministas. Los términos de búsqueda y el razonamiento de tu agente varían de una ejecución a otra. Una ejecución correcta llama a la herramienta cuando una misión nombra a una criatura, la omite cuando no lo hace y cita solo las calificaciones de desafío que devolvió la herramienta.
Con la herramienta conectada y la solicitud del sistema reemplazada, puedes probar el agente en la siguiente sección.