- Información general
- Comience ya
- Conceptos
- Uso de UiPath CLI
- Guías prácticas
- Recetas de CI/CD
- Referencia de los comandos
- Información general
- Códigos de salida
- Opciones globales
- agente de código UIP
- codificador UIP
- Contextualización de UIP
- UIP Docsai
- Función uip
- barreras de seguridad de UIP
- Configuración de UIP llm
- puerta de enlace llm de uip
- Creación de UIP Maestro
- Registro maestro de UIP
- UIP model-hub
- Actividades Buscar
- actividades get-default-xaml
- Analizar
- lista de reglas del analizador
- Crear
- Limpieza
- instalación de data-fabric-entities
- lista de entidades de data-fabric
- diferencia de archivos
- obtener-repositorio-de-objetos-de-biblioteca
- obtener-objeto-repositorio
- Init
- lista de instancias
- Paquete
- inspeccionar paquetes
- instalación de paquetes
- versiones de paquetes
- Publicar
- Remoto
- restore
- ejecutar, depurar & Ejecución
- Configuración
- Inicio de Studio
- Búsqueda de plantillas
- entidad de adición de datos de prueba
- añadir-cola de datos de prueba
- añadir-variación de los datos de prueba
- TM
- UIA
- Validar
- ejemplos-de-flujo-de-flujo-obtener
- lista de ejemplos de flujo de trabajo
- Tareas de UIP
- Archivo adjunto
- Campo personalizado
- Defects
- Ejecuciones
- exportar-trabajos
- Migración
- EtiquetaDeObjeto
- Paquete
- escenario de rendimiento
- grupos de carga de escenarios de rendimiento
- datos de ejecución de perf-scenario
- informe de escenario de rendimiento
- Proyecto
- permisos del proyecto
- Solicitudes
- Informar
- Requisitos
- Resultado
- Iniciar
- Programaciones
- Registro de casos de prueba
- Casos de prueba
- Conjuntos de prueba
- registro de pasos de prueba
- Usuario
- Esperar
- Seguimientos de UIP
- Comentarios de seguimientos de UIP
- Migración
- Referencia y soporte
depuración del agente uip
Ejecute un agente de código bajo en Studio Web con entradas de muestra y transmita el resultado con `uip agent debug`.
uip agent debug ejecuta un agente de código bajo de extremo a extremo en Studio Web con las entradas que proporciones, sondeando hasta que finaliza la ejecución y cambia el estado de transmisión. Requiere inicio de sesión.
El proyecto debe utilizar un manifiesto project.uiproj: un proyecto que aún esté en el diseño project.json antiguo falla rápidamente con las instrucciones de conversión (los comandos de empaquetado como uip solution pack/publish siguen aceptando project.json; solo los comandos vinculados a Studio Web como este requiere el manifiesto más reciente).
Sinopsis
uip agent debug <project-path> [-i <json>] [--attachment <field=path>]... [--poll-interval <ms>] [--timeout <seconds>] [--login-validity <minutes>]
uip agent debug <project-path> [-i <json>] [--attachment <field=path>]... [--poll-interval <ms>] [--timeout <seconds>] [--login-validity <minutes>]
Todas las invocaciones respetan las opciones globales (--output, --output-filter, --log-level, --log-file). Los códigos de salida siguen el contrato estándar.
Argumentos
<project-path>obligatorio) : ruta al directorio del proyecto del agente (que contieneagent.json).
Opciones
| Marca | Predeterminado | Propósito |
|---|---|---|
-i, --inputs <json> | {} | Argumentos de entrada como un objeto JSON, por ejemplo '{"input":"hello"}'. Debe analizarse como un objeto sin formato. Para un campo de archivo adjunto de trabajo, pasa una referencia de archivo adjunto de Orchestrator existente, {"ID": "<attachment-id>"}, o utiliza --attachment para cargar un archivo local. |
--attachment <field=path> | — | Carga un archivo local en un campo de entrada de archivo adjunto de trabajo de agent.json. Repetible. El campo debe declararse como {"$ref": "#/definitions/job-attachment"} en inputSchema. Repite el mismo campo solo cuando su esquema es una matriz de archivos adjuntos de trabajo. La ruta se resuelve desde el directorio de trabajo actual, no desde el directorio del proyecto del agente. Los ID de los archivos adjuntos cargados se devuelven en Data.Attachments. |
--poll-interval <ms> | 2000 | Intervalo de sondeo en milisegundos. |
--timeout <seconds> | 600 segundos (10 minutos) | Máximo de segundos de espera para que finalice la ejecución. |
--login-validity <minutes> | 10 | Minutos mínimos restantes antes de la expiración del token necesarios para continuar. |
Ejemplos
uip agent debug ./my-agent -i '{"input":"hello"}'
uip agent debug ./my-agent --timeout 120 --poll-interval 5000
# Upload a local PDF into the job-attachment input field fileIn
uip agent debug ./my-agent --attachment fileIn=./invoice.pdf -i '{"question":"What is the total?"}'
uip agent debug ./my-agent -i '{"input":"hello"}'
uip agent debug ./my-agent --timeout 120 --poll-interval 5000
# Upload a local PDF into the job-attachment input field fileIn
uip agent debug ./my-agent --attachment fileIn=./invoice.pdf -i '{"question":"What is the total?"}'
Un valor --attachment para un campo también presente en --inputs anula el valor --inputs y el comando registra una advertencia. Una entrada de archivo adjunto de trabajo obligatoria que no tenga ni un valor --attachment ni un valor --inputs también produce una advertencia.
Forma de datos (--json de salida)
Correcto (Code: "AgentDebug"):
{
"Code": "AgentDebug",
"Data": {
"JobKey": "a1b2c3d4-0000-0000-0000-000000000401",
"TraceId": "b2c3d4e5-0000-0000-0000-000000000001",
"State": "Successful",
"Output": { "content": "hi there" }
},
"Instructions": "Debug run completed: Successful"
}
{
"Code": "AgentDebug",
"Data": {
"JobKey": "a1b2c3d4-0000-0000-0000-000000000401",
"TraceId": "b2c3d4e5-0000-0000-0000-000000000001",
"State": "Successful",
"Output": { "content": "hi there" }
},
"Instructions": "Debug run completed: Successful"
}
Output está presente solo cuando la ejecución produjo uno; Info solo está presente cuando el servicio devolvió información de diagnóstico adicional.
Cuando la ejecución carga archivos con --attachment, Data.Attachments enumera cada carga:
{
"Code": "AgentDebug",
"Data": {
"JobKey": "a1b2c3d4-0000-0000-0000-000000000401",
"TraceId": "b2c3d4e5-0000-0000-0000-000000000001",
"State": "Successful",
"Output": { "answer": "1,234.00 USD" },
"Attachments": [
{
"Field": "fileIn",
"AttachmentId": "c3d4e5f6-0000-0000-0000-000000000002",
"FileName": "invoice.pdf",
"MimeType": "application/pdf",
"Size": 48213
}
]
}
}
{
"Code": "AgentDebug",
"Data": {
"JobKey": "a1b2c3d4-0000-0000-0000-000000000401",
"TraceId": "b2c3d4e5-0000-0000-0000-000000000001",
"State": "Successful",
"Output": { "answer": "1,234.00 USD" },
"Attachments": [
{
"Field": "fileIn",
"AttachmentId": "c3d4e5f6-0000-0000-0000-000000000002",
"FileName": "invoice.pdf",
"MimeType": "application/pdf",
"Size": 48213
}
]
}
}
Para reutilizar un archivo cargado en una ejecución posterior sin volver a cargarlo, pasa su referencia en --inputs, por ejemplo '{"fileIn":{"ID":"c3d4e5f6-0000-0000-0000-000000000002"}}'.
Attachment errors — an invalid --attachment value (wrong field=path format, a field that is not a job-attachment input, a missing, empty, or directory path) fails before anything is uploaded or run, with Retry: "RetryWillNotFix". When Orchestrator refuses an upload, no debug job starts.
Estado terminal no exitoso : lo mismo Code: "AgentDebug", pero devuelto como un error (código de salida 1) con Message: "Debug run <state>." y Instructions apuntando a uip traces spans get <TraceId> para inspeccionar la ejecución.
Manifiesto del proyecto incompatible:
{
"Result": "Failure",
"ErrorCode": "invalid_argument",
"Message": "...",
"Instructions": "Convert the listed project(s) to a project.uiproj manifest before debugging: scaffold the accepted layout with 'uip api-workflow init <name>' inside the solution and move Workflow.json (plus entry-points.json and bindings_v2.json) into it, then remove the project.json-based entry from the .uipx. Note that 'uip solution pack' and 'uip solution publish' accept project.json — only Studio Web-bound commands require project.uiproj."
}
{
"Result": "Failure",
"ErrorCode": "invalid_argument",
"Message": "...",
"Instructions": "Convert the listed project(s) to a project.uiproj manifest before debugging: scaffold the accepted layout with 'uip api-workflow init <name>' inside the solution and move Workflow.json (plus entry-points.json and bindings_v2.json) into it, then remove the project.json-based entry from the .uipx. Note that 'uip solution pack' and 'uip solution publish' accept project.json — only Studio Web-bound commands require project.uiproj."
}
Relacionado
uip agent validate: se ejecuta primero para confirmar que el proyecto está bien formado; sugerido en las instrucciones de error de carga.uip traces spans get: inspecciona el seguimiento de una ejecución de depuración después de un estado fallido.