Agente de UIP

Andamie, valide, actualice, revise y gestione agentes de bajo código utilizando la herramienta `agente de uip`.

uip agent es la herramienta Agente: andamia, valida, migra y revisa agentes de bajo código : los proyectos impulsados por agent.jsoncreados en Agent Builder/Studio Web. Instálalo con uip tools install agent, o invoca uip agent … y deja que se ejecute la instalación automática. Consulta Herramientas (complementos) para el modelo de instalación y herramientas uip para el comando que gestiona la instalación de herramientas.

This tool is distinct from the coded agent tool (uip codedagent), which targets Python agents built with LangGraph / LlamaIndex / OpenAI Agents. uip agent only operates on low-code agent projects: a directory containing agent.json, entry-points.json, project.uiproj, an evals/ tree, and features/ / resources/ folders — or, for an agent embedded in a flow in Maestro, a UUID-named subdirectory inside the flow project (--inline-in-flow).

Packaging and shipping an agent project goes through uip solution: the agent project is one project inside a solution. Resources (tools, contexts, escalations, I/O schema) are authored by editing agent.json.

Qué es un agente de UiPath

Un agente de código bajo se describe de forma declarativa mediante un único archivo agent.json : modelo, solicitudes, esquemas de entrada/salida, herramientas, contextos, escaladas y configuración. Los archivos compatibles describen los puntos de entrada que Studio Web utiliza para invocar el agente, el conjunto de evaluación predeterminado y cualquier recurso RAG/HITL.

El ciclo de vida real cubierto por uip agent es:

1. Scaffold a project on disk with uip agent init (standalone, or --inline-in-flow inside a Flow project). By default the project auto-registers into a surrounding solution's .uipx, or a new <Name>Solution is scaffolded automatically when none exists.
2. Cree editando manualmente agent.json (y los archivos en resources/, evals/).
3. Actualizar el proyecto (uip agent refresh) después de cada edición: aplica las migraciones de esquema pendientes y regenera entry-points.json / bindings_v2.json. Este es el único comando que escribe archivos derivados.
4. Validar el proyecto (uip agent validate) — estricto, de solo lectura: respuestas "¿aceptaría Studio Web este directorio tal como está?" sin escribir nada.
5. Revisa el proyecto contra un conjunto de reglas deterministas (uip agent review) para obtener un veredicto de calidad puntuado y, opcionalmente, registra la calificación a lo largo del tiempo (uip agent review-history add).
6. Configure los modelos LLM (uip agent model list), los espacios de memoria (uip agent memory), las barreras de seguridad (uip agent guardrails) y las herramientas (uip agent tool list) según sea necesario.
7. Depura el agente contra Studio Web (uip agent debug) para ejecutarlo de extremo a extremo con entradas de muestra antes del envío.
8. Enviar con uip solution pack / publish / upload / deploy — uip agent no tiene verbo de empaquetado o implementación propio.
9. Evalúa el agente en comparación con un conjunto de evaluación (uip agent eval run start): funciona en una solución impulsada por la nube (--solution-id o detectada automáticamente desde SolutionStorage.json) o, cuando ninguna de las dos está disponible, una ruta de evaluación implícita del espacio de trabajo local.

Verbos

Comando	Propósito
Init	Andamiar un nuevo proyecto de agente en el disco (independiente o en línea dentro de un proyecto de flujo).
Validar	Comprobación estricta de solo lectura: ¿aceptaría Studio Web este proyecto tal cual?
refresh	Aplicar las migraciones de esquema pendientes y regenerar entry-points.json / bindings_v2.json.
Revisar	Puntúa el proyecto según un conjunto de reglas deterministas (veredicto, puntuación, calificación, incidencias).
Historial de revisiones	Registra una calificación de revisión en el archivo de historial de revisión local del proyecto.
lista de herramientas	Enumera los recursos de herramientas configurados en el agente.
Memoria	Attach, list, and remove memory spaces, and add or list the items a deployed memory space holds.
Evaluación	Gestiona evaluadores, conjuntos de evaluación, casos de prueba y ejecuciones de evaluación.
Barandillas	Enumerar definiciones de barreras de seguridad, barreras de seguridad BYOG, modelos de LLM como juez y el catálogo de barreras de seguridad.
model	Enumera los modelos de LLM disponibles para el tenant autenticado.
Depurar	Ejecuta el agente en Studio Web con entradas de muestra y transmite el resultado.

Sinopsis

uip agent <verb> [subverb] [arguments] [options]

Siempre uip agent, nunca uip agents o uip a. agent es el commandPrefix de la herramienta (ver uip tools list).

Todos los verbos uip agent respetan las cuatro opciones globales (--output, --output-filter, --log-level, --log-file). Los códigos de salida siguen el contrato compartido.

Flujo de extremo a extremo

# 1. Scaffold (auto-registers into the surrounding solution, or creates one)
uip agent init ./my-agent --model gpt-5.4

# 2. Refresh after any edit to agent.json (migrates + regenerates derived files)
uip agent refresh ./my-agent

# 3. Validate the project is ready for upload (strict, read-only)
uip agent validate ./my-agent

# 4. Review for quality issues before shipping
uip agent review ./my-agent

# 5. Ship via the solution the project was registered into
uip solution pack . ./dist
uip solution upload .

# 6. Evaluate (against the cloud project once pushed, or the local workspace)
uip agent eval run start --set default --path ./my-agent --wait

# 7. Debug a specific run against Studio Web
uip agent debug ./my-agent -i '{"input":"hello"}'

Autenticación

debug, eval run *, memory item add, memory item list, guardrails list, guardrails llm-as-judge-models, guardrails catalog, and model list call UiPath services and require an active CLI session. Run uip login first. Refer to Authentication for the session model.

init, validate, refresh, review, review-history, tool list, memory add, memory list y memory remove son solo locales y no requieren una sesión.

Ver también

• Conceptos: herramientas (complementos) : el modelo de complemento y la fijación de versiones.
• solución de uip : empaqueta, publica e implementa la solución en la que reside un proyecto de agente.
• Autenticación : sesiones, tenants y carpetas.
• Opciones globales, códigos de salida.