Cree agentes de código bajo con agentes de codificación

Andamiar, configurar, evaluar y publicar agentes de código bajo de UiPath completamente desde un agente de codificación y un terminal, sin un navegador después del inicio de sesión inicial.

Un agente de codificación con habilidades de UiPath instaladas puede andamiar, configurar, validar y publicar agentes de código bajo de UiPath completamente desde tu terminal, sin necesidad de navegador después del inicio de sesión inicial. Describes el agente que deseas crear, el agente de codificación crea e itera los archivos del proyecto y carga el resultado en Studio Web.

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

Requisitos previos

• La habilidad uipath-agents instalada para tu agente de codificación. Consulta Instalar y configurar.
• Una sesión iniciada (uip login).

Qué puede hacer el agente

Cada fila cubre una etapa del ciclo de vida del agente. El agente de codificación elige los comandos uip agent correctos de la habilidad instalada: indicas el resultado, no el comando.

Área	Qué puede hacer el agente	Ejemplo de solicitud
Andamio	Crear un nuevo proyecto de agente con la estructura de directorios completa, incluidos agent.json esquemas de entrada/salida y los conjuntos de evaluación predeterminados	"Crear un nuevo agente de análisis de sentimiento para los comentarios entrantes de las redes sociales".
Configurar solicitudes y esquemas	Edite la solicitud del sistema, la plantilla de mensaje de usuario, los esquemas de entrada/salida y la configuración del modelo LLM en agent.json	"Actualiza la solicitud del sistema para gestionar los datos de la factura y añade un campo de confianza al esquema de salida".
Añadir y gestionar herramientas	Añadir procesos de RPA, otros agentes, flujos de trabajo de API, flujos de Maestro, herramientas de conector de Integration Service, contextualización y aplicaciones de escalada	"Agregue una herramienta de búsqueda de SharePoint y un proceso RPA para la validación de documentos".
Actualizar y validar	Ejecuta uip agent refresh para escribir artefactos y sincronizar esquemas de punto de entrada, luego uip agent validate para comprobar la estructura JSON (solo lectura); corregir errores automáticamente	"Valida el agente y corrige cualquier error".
Cargar y descargar	Cargue el proyecto local a Studio Web (uip solution upload) o descargue una solución de Studio Web existente para editar localmente (uip solution download)	"Cargar el agente en Studio Web para que pueda revisarlo".
Evaluar	Cree conjuntos de evaluación y casos de prueba, ejecútelos en el runtime del agente y revise las puntuaciones y los seguimientos de ejecución	"Ejecuta el conjunto de evaluación de regresión y muéstrame qué casos de prueba obtuvieron una puntuación inferior a 0,7".
Empaquetar e implementar	Empaqueta y publica la solución a través de uip solution pack y uip solution publish, impleméntala como un proceso e inicia un trabajo	"Implementa el agente de facturas en la carpeta de producción".

El bucle de compilación

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

Scaffold > Configurar > Añadir recursos > Actualizar > Validar > Corregir > Cargar

1. Andamio : crea la solución con uip solution init y, a continuación, aplica andamios al agente con uip agent init.

2. Configurar : establece las solicitudes, los esquemas y la configuración del modelo agent.json.

3. Añadir recursos : crea un archivo resource.json en resources/<tool-name>/ para cada herramienta que necesite el agente.

4. Actualizar : escribe artefactos y sincroniza esquemas de punto de entrada uip agent refresh.

5. Validar : comprueba la estructura JSON con uip agent validate (solo lectura).

6. Corrección : corrige cualquier error de validación y luego vuelve a Actualizar. Se esperan varios ciclos y son normales.

7. Cargar : una vez que el proyecto esté limpio, cárgalo en Studio Web con uip solution upload.

Resultado: el proyecto de agente ahora es visible en Studio Web y está disponible para su revisión, evaluación o implementación.

Estructura del proyecto de agente

Cuando el agente de codificación ejecuta uip solution init y uip agent init, crea la siguiente estructura:

<AgentName>/
├── agent.json               # System prompt, user message template, LLM settings, input/output schemas
├── project.json             # Project metadata
├── entry-points.json        # Entry point definitions, kept in sync with agent.json schemas
├── bindings_v2.json         # Resource binding references
├── SolutionStorage.json     # Written after push — captures the Studio Web solution ID
│
├── resources/               # One directory per tool
│   └── <tool-name>/
│       └── resource.json    # Tool config: type, connector key, schema, connection ID
│
├── connections/             # Connection references for bound Integration Service tools
│
├── evals/                   # Evaluation configuration
│   ├── evaluators/          # Evaluator definitions (semantic similarity, trajectory by default)
│   └── eval-sets/           # Test case collections
│
└── userProfile/
    └── debug_overwrites.json  # Local connection overrides for debugging

Tipos de herramientas

El agente de codificación registra los tipos de herramientas creando directamente los archivos resource.json en resources/<tool-name>/. El campo type de cada archivo determina el tipo de herramienta. El soporte de ejecución de runtime varía: algunos tipos pueden registrarse para la compatibilidad de Studio Web pero aún no se ejecutan en el runtime del agente.

Tipo de herramienta	resource.json Tipo	Se ejecuta en runtime del agente
Conector de Integration Service	integration	Sí
Proceso de Orchestrator (RPA)	process	Sí (no interactivo)
Subagente	agent	Sí
Flujo de trabajo de API	api	Solo registro
Flujo de Maestro	processOrchestration	Solo registro
Extracción y Procesamiento de Documentos (IXP)	ixp	Solo registro

La contextualización, las aplicaciones de escalada y los servidores MCP se añaden como recursos de solución independientes en lugar de archivos resource.json tipo herramienta. El agente de codificación los crea y los sincroniza en el proyecto con uip solution resources refresh.

Compilaciones de ejemplo

Abre tu agente de codificación y describe el agente que deseas. El agente carga la habilidad Agentes de UiPath y se encarga del resto.

Qué preguntar	Qué se crea
"Crear un nuevo agente de análisis de sentimiento para los comentarios entrantes de las redes sociales".	Agente independiente con una solicitud del sistema personalizada y esquemas de entrada/salida estructurados
"Añade un agente del gestor de redes sociales que delegue en el agente de análisis de sentimientos la gestión de un lote de comentarios entrantes".	Solución multiagente con un agente gestor que utiliza el agente de análisis de sentimiento como herramienta
"Constrúyeme un flujo con un agente de IA para redactar correos electrónicos profesionales".	Proyecto de flujo con un nodo de agente en línea conectado a los nodos de inicio y final

Evaluar tu agente

El agente de codificación puede impulsar un bucle completo de compilación-evaluación-mejora:

1. Crea y configura el agente localmente.
2. Cargar en Studio Web (uip solution upload): las evaluaciones se ejecutan en el runtime del agente y requieren que el proyecto se cargue primero.
3. Ejecuta un conjunto de evaluación y espera los resultados.
4. Revisa las puntuaciones por caso de prueba, los seguimientos de ejecución y los mensajes de error.
5. Ajusta las solicitudes o la configuración en función de los fallos.
6. Carga el agente actualizado (uip solution upload).
7. Vuelve a ejecutar el conjunto de evaluación.

Resultado: la ejecución de la evaluación se completa correctamente, con puntuaciones visibles para cada caso de prueba e indicaciones claras de qué casos aprobaron o fallaron.

El ejemplo pregunta:

• "Crea un conjunto de evaluación llamado pruebas-de-regresión con cinco casos de prueba que cubran los principales escenarios de entrada de facturas".
• "Ejecuta el conjunto de evaluación de pruebas de regresión y muestra los resultados".
• "El tercer caso de prueba falló con una puntuación de trayectoria baja: actualice la solicitud del sistema para que la selección de herramientas sea más explícita y vuelva a ejecutar".

Están disponibles los siguientes tipos de evaluadores:

Evaluador	Qué mide
Similitud semántica	Compara semánticamente la salida esperada con la salida real
Trayectoria	Comprueba si el agente siguió el uso de la herramienta esperado y los pasos de razonamiento
Precisión del contexto	Puntúa la relevancia del contexto recuperado para la consulta
Fidelidad	Puntúa si las respuestas del agente están basadas en el contexto proporcionado

Ver también

• Getting started with UiPath agents — hands-on lab for building and deploying a low-code agent from the CLI.
• Instalar y configurar : configuración del agente e instalación de habilidades.
• Crea agentes codificados con agentes de codificación : agentes codificados basados en Python desde un terminal de agente de codificación.
• Descripción general de habilidades : el modelo de habilidad que impulsa este comportamiento.
• Referencia de agente de uip : referencia de comandos completa para el ciclo de vida del agente, herramientas, evaluaciones, inserción, extracción e implementación.