Crear agentes codificados con Coding Agents

Andamiar, escribir, empaquetar y publicar agentes codificados basados en Python en UiPath Orchestrator completamente desde un agente de codificación y un terminal.

Un agente de codificación con la habilidad uipath-agents instalada puede andamiar, escribir, empaquetar y publicar agentes basados en Python en UiPath Orchestrator completamente desde tu terminal. Los agentes codificados son proyectos estándar de Python creados con agentes LangGraph, LlamaIndex u OpenAI, y UiPath se encarga de la orquestación, la programación, la escalada y la gobernanza una vez implementado el agente.

Para la configuración (instalar el agente, iniciar sesión, instalar habilidades), consulta Instalar y configurar.

Para obtener una referencia completa de los comandos uip codedagent , consulta la guía de UiPath CLI.

Requisitos previos

• La habilidad uipath-agents instalada para tu agente de codificación. Consulta Instalar y configurar.
• Una sesión iniciada (uip login).
• Python 3.11 o posterior.
• El gestor de paquetes uv.

Qué puede hacer el agente

Área	Qué puede hacer el agente	Ejemplo de solicitud
Inicializar un proyecto	Crea un nuevo proyecto de Python con uv, añade el paquete UiPath SDK de tu elección y ejecuta uip codedagent setup y uip codedagent new para andamiar la estructura del proyecto	"Inicializa un nuevo proyecto de agente codificado llamado procesador de facturas".
Escribir lógica de agente	Escribir e iterar en el código del agente Python utilizando agentes LangGraph, LlamaIndex u OpenAI	"Agregue una herramienta que llame al índice de conexión a tierra de contexto de UiPath para verificar la política de la empresa".
Configurar	Ejecutar uip codedagent init para conectar el proyecto de Python a la capa de orquestación de UiPath	"Configurar el agente para UiPath Orchestrator".
Paquete	Ejecutar uip codedagent pack para agrupar el agente como artefacto implementable	"Empaquete el agente".
Publicar	Ejecute uip codedagent publish para cargar el paquete en Orchestrator y crear automáticamente un proceso	"Publicar el agente en mi espacio de trabajo personal".
Sincronizar con Studio Web	Ejecute uip codedagent push para cargar archivos locales en el proyecto remoto de Studio Web, o uip codedagent pull para descargar todos los archivos del proyecto remoto a su espacio de trabajo local	"Enviar mis cambios locales a Studio Web".

El bucle de compilación

El agente de codificación sigue este ciclo al crear o iterar en un agente codificado:

Inicializar > Escribir > Evaluar > Paquete > Sincronizar con Studio Web (opcional) > Publicar > Establecer variables de entorno > Ejecutar

1. Inicializar : crea un nuevo proyecto de Python, añade el SDK de UiPath y aplica andamios a la estructura del proyecto:

   mkdir my-agent && cd my-agent
   uv init
   uv add uipath-langchain   # or uipath-llamaindex / uipath-openai-agents
   uip codedagent setup
   uip codedagent new my-agent
   uip login
   uip codedagent init
   

2. Escribir : pide al agente de codificación que escriba y edite la lógica del agente Python. Los agentes codificados son Python estándar y no están limitados a las capacidades específicas de UiPath.

3. Evaluar : prueba el agente antes de publicar:

   • Analizar : pide al agente de codificación que configure un conjunto de pruebas, lo ejecute y explique las puntuaciones.

   • Iterar : refina la solicitud o la lógica hasta que los resultados sean correctos.

4. Paquete : empaqueta el agente con uip codedagent pack para crear un artefacto implementable.

5. Sincronizar con Studio Web (opcional) : si deseas realizar más cambios en Studio Web:

   • Insertar : ejecuta uip codedagent push para cargar archivos locales en el proyecto remoto de Studio Web.
   • Extraer : ejecuta uip codedagent pull para descargar todos los archivos del proyecto remoto de Studio Web a tu espacio de trabajo local.

6. Publicar : publica el agente con uip codedagent publish --my-workspace para cargar el paquete en Orchestrator. Un proceso se crea automáticamente en tu espacio de trabajo personal en la primera publicación.

7. Establecer variables de entorno : en Orchestrator, abre la configuración del proceso y añade cualquier variable de entorno necesaria (claves de API, cadenas de conexión).

8. Ejecutar : inicia el trabajo.

Resultado: el agente se implementa en Orchestrator y se ejecuta como un proceso. UiPath gestiona la programación, los reintentos y el registro.

Paquetes SDK

Elige el paquete que coincida con el marco de tu agente:

Paquete	Framework
uipath-langchain	LangChain / LangGraph
uipath-llamaindex	LLamaIndex
uipath-openai-agents	Agentes de OpenAI

Los tres paquetes exponen las mismas capacidades de UiPath (contextualización, escalada con intervención humana, barreras de seguridad, archivos adjuntos de trabajo) a través de abstracciones nativas del marco.

Compilaciones de ejemplo

Abre tu agente de codificación y describe el agente que deseas crear. Como los agentes codificados son Python estándar, no hay límites en lo que puedes pedir: el SDK de UiPath añade orquestación, gobernanza e integración de la plataforma.

Qué preguntar	Qué se crea
"Cree un agente codificado que investigue un tema y produzca un informe de resumen".	Agente de investigación con llamadas de LLM
"Cree un agente codificado que analice un archivo CSV dado como entrada".	Agente conectado para recibir un archivo adjunto de trabajo como entrada
"Cree un agente codificado que utilice un índice de contextualización de UiPath para comprobar la política de la empresa".	Proceso RAG (generación aumentada por recuperación) contra un índice de conexión a tierra de contexto de UiPath

Ejemplos

Los siguientes repositorios contienen implementaciones de referencia:

• Muestras de LangChain de UiPath : más de 20 muestras que cubren barreras de seguridad, intervención humana, agentes distribuidos y agentes conversacionales.
• Ejemplos de LlamaIndex : patrones de integración de UiPath para LlamaIndex.
• Muestras de agentes de OpenAI : patrones de integración de UiPath para agentes de OpenAI.

Ver también

• Instalar y configurar : configuración del agente e instalación de habilidades.
• Crea agentes de código bajo con agentes de codificación : crea agentes de Agent Builder a partir de un agente de codificación.
• Documentación de UiPath Python SDK : referencia completa de SDK para agentes codificados.