Introducción

Cree, evalúe y publique un agente de LangGraph codificado utilizando la UiPath CLI y las habilidades del agente de codificación.

En este lab, instalará UiPath CLI y las habilidades del agente de codificación, y luego utilizará su agente de codificación para crear, ejecutar y evaluar un agente de LangGraph. Harás lo siguiente:

1. Instala la UiPath CLI y las habilidades del agente de codificación.
2. Aplique andamios a un proyecto local y cree un agente de LangGraph guiado por habilidades.
3. Añade una herramienta de búsqueda externa en vivo al agente.
4. Ejecuta y evalúa el agente localmente.
5. Conecta el proyecto a UiPath Studio Web y envía tu primera versión.

Al final, tendrás un agente de LangGraph en funcionamiento creado a través de tu agente de codificación, guiado por las habilidades de UiPath, con seguimientos de evaluación que fluyen a Studio Web.

Hay tres enfoques para crear agentes de UiPath. Esto utiliza el SDK de LangGraph; también puedes crear agentes utilizando el Agent Builder y utilizando la UiPath CLI.

Tiempo estimado: 45-60 minutos

Qué estás creando

Este lab te guía a través de la creación de un clasificador de entrada de búsqueda para un gremio de aventureros ficticio: un agente LangGraph codificado que lee una descripción de búsqueda y la clasifica en uno de los cuatro niveles de dificultad.

Comienza como un clasificador simple de nodo único, por lo que el foco permanece en el flujo de trabajo CLI, no en la lógica del dominio. Luego, le das una herramienta para que pueda comprobar su respuesta con una API externa en vivo antes de finalizar un nivel, en lugar de adivinar solo a partir de las vibraciones.

Este es el diseño completo de lo que estás creando:

Componente	Detalles
Entrada: description	string; la descripción de la misión entrante
Salida: tier	Un tipo Literal restringido a exactamente "Trivial", "Standard", "Heroic" o "Legendary", no una cadena simple, por lo que el modelo no puede emitir un nivel fuera de vocabulario
Salida: reasoning	string; la explicación del agente para el nivel que eligió
Herramienta: get_challenge_rating	Una herramienta LangGraph, invocada solo cuando una misión nombra o implica una criatura específica, que busca su clasificación de desafío en la API del documento de referencia del sistema (SRD) de Open5e y la cita en el razonamiento

Nota:

¿Por qué añadir una herramienta? Una razón importante para ejecutar un agente de LangGraph en UiPath, en lugar de un agente de código bajo, es la compleja lógica de Python que puede llamar a sistemas externos, no solo clasificar texto. El paso de la herramienta en este lab demuestra que: el agente decide en runtime si una misión necesita verificación, llama a una API activa y razona sobre el resultado.

---

Requisitos previos

• Versión de CLI : validada con UiPath CLI v1.201.0 (instalada en el paso 1). Diferentes versiones pueden comportarse de forma diferente; informe de desviación con uip feedback send.
• Cuenta de UiPath : regístrate o inicia sesión en UiPath Automation Cloud antes de comenzar.
• Node.js 18+ : necesario para instalar UiPath CLI. Consulta con node --version. Descárguelo desde nodejs.org si es necesario.
• VS Code con un agente de codificación (Claude Code, Copilot o Cursor). Las instrucciones de laboratorio utilizan Claude Code, pero cualquier agente de codificación compatible funcionará.
• Terminal Bash : los comandos de este lab utilizan la sintaxis Bash. En VS Code, abre un nuevo terminal y selecciona Git Bash (o equivalente) como tipo de terminal. La sintaxis de PowerShell y CMD difiere y puede causar errores inesperados.
• uv : un gestor de paquetes de Python rápido. Instálalo con:

  pip install uv
  

  o consulta los documentos de instalación de uv para ver otras opciones.
• Derechos de administrador : la instalación de paquetes npm globales y dependencias de Python requiere permisos de administrador/elevados. Si utilizas un portátil de trabajo con restricciones, confirma que puedes instalar paquetes antes de comenzar, o trabaja con tu equipo de TI con antelación.

No se requiere ningún conocimiento previo de UiPath para este lab, pero lo hará ir más rápido.

---

Nota:

Dos "agentes" en este laboratorio. "Agente codificado" es el término de UiPath para un agente de Python implementado en la plataforma; este lab crea uno utilizando el SDK de LangGraph. Las instrucciones de laboratorio también hacen referencia a tu "agente de codificación" (Claude Code, Copilot, Cursor) para ayudar a escribir el código Python.

Cuando las instrucciones digan "pregunte a su agente de codificación" se refieren a tu asistente del entorno de desarrollo integrado (IDE); cuando dicen "ejecutar el agente" o "su agente de LangGraph" se refieren al agente de UiPath que se está creando.