UiPath Documentation
uipath-cli
latest
false
Guía del usuario de UiPath CLI
Importante :
Este contenido se ha traducido mediante traducción automática. La localización de contenidos recién publicados puede tardar entre una y dos semanas en estar disponible.

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 contiene agent.json).

Opciones​

MarcaPredeterminadoPropó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>2000Intervalo 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>10Minutos 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."
}
  • 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.

Ver también​

¿Te ha resultado útil esta página?

Conectar

¿Necesita ayuda? Soporte(opens in new window)

¿Quiere aprender? UiPath Academy(opens in new window)

¿Tiene alguna pregunta? Foro de UiPath(opens in new window)

Manténgase actualizado