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.

Esta herramienta es distinta de la herramienta de agente codificada (uip codedagent), que se dirige a agentes Python creados con agentes LangGraph/LlamaIndex/OpenAI. uip agent solo funciona en proyectos de agente de código bajo: un directorio que contiene agent.json, entry-points.json, project.uiproj, un árbol evals/ y carpetas features/ / resources/ — o, para un agente incrustado en un Maestro Flow, un subdirectorio con nombre UUID dentro del proyecto de flujo (--inline-in-flow).

uip agent no tiene pack, publish, deploy, push, pull, run, list, share, file, config, context, escalation, input o comando output — empaquetar y enviar un proyecto de agente pasa por uip solution en su lugar (el proyecto de agente es un proyecto dentro de una solución). La creación de recursos (herramientas, contextos, escaladas, esquema de E/S) se realiza editando manualmente agent.json, no a través de un verbo CLI dedicado.

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. Aplica andamios a un proyecto en el disco con uip agent init (independiente o --inline-in-flow dentro de un proyecto de Maestro Flow). De forma predeterminada, el proyecto se registra automáticamente en .uipx de una solución circundante, o se aplica automáticamente un nuevo <Name>Solution cuando no existe ninguno.
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	Adjuntar, enumerar y eliminar espacios de memoria y elementos de memoria.
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 *, guardrails llm-as-judge-models y model list llaman a Studio Web/la puerta de enlace de LLM y requieren una sesión CLI activa. Ejecuta uip login primero. Consulta Autenticación para el modelo de sesión.

init, validate, refresh, review, review-history, tool list, memory, guardrails list y guardrails catalog 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.