depuración de flujo maestro de uip

Sintaxis y opciones para `depuración de flujo maestro de uip`, que carga un proyecto de flujo local en Studio Web y ejecuta una sesión de depuración en el servidor con actualizaciones de estado transmitidas.

uip maestro flow debug un proyecto de flujo local a Studio Web y ejecuta una sesión de depuración en el servidor, transmitiendo actualizaciones de estado por elemento a la consola y devolviendo un estado final.

Sinopsis

uip maestro flow debug <project-path>
               [--folder-id <id> | --folder-key <key> | --folder-path <path>]
               [--poll-interval <ms>]
               [-i, --inputs <json>]
               [--attachment <name=path>]...
               [--open-in-browser]
               [--login-validity <minutes>]

Requiere uip login. Prevalece las opciones globales. Los códigos de salida siguen el contrato estándar.

Argumentos

• <project-path> obligatorio) : ruta al directorio del proyecto Flow. Debe contener un project.uiproj.

Opciones

Opción	Predeterminado	Descripción
--folder-id <id>	Detectado automáticamente	Orchestrator folder (OrganizationUnitId), a positive integer. Mutually exclusive with --folder-key/--folder-path. If none of the three are given, the folder on the current login session is used.
--folder-key <key>	—	Orchestrator folder key (UUID) — resolved to the folder ID by the CLI. Mutually exclusive with --folder-id/--folder-path.
--folder-path <path>	—	Orchestrator folder path, e.g. Shared/Sub — resolved to the folder ID by the CLI. Mutually exclusive with --folder-id/--folder-key. Use uip or folders list to discover valid keys/paths.
--poll-interval <ms>	2000	Intervalo de sondeo en milisegundos mientras se espera a que Studio Web avance la sesión.
-i, --inputs <json>	—	Input arguments as a JSON string, or @path/to/file.json to read from a file.
--attachment <name=path>	—	Upload a local file to Orchestrator and bind it as a file-type input variable. Repeatable, e.g. --attachment file1=./resume.pdf. Overrides the same variable name if also present in --inputs.
--open-in-browser	—	Open the Studio Web session URL in a browser once available.
--login-validity <minutes>	10	Minutos mínimos antes de la caducidad del token para desencadenar una actualización automática.

Comportamiento

1. Valida el inicio de sesión y extrae la organización, el tenant, la URL base, el nombre de la organización y el token de autenticación de la sesión.
2. Carga el proyecto en Studio Web en la carpeta de destino.
3. Sondea un estado final, emitiendo líneas de estado por elemento como:

   Status: InProgress (2/5 elements completed)
     v Node_1 [Completed]
     > Node_2 [InProgress]
     - Node_3 [NotStarted]
   

4. En incidentes durante la ejecución, emite una línea de advertencia.
5. Sale de 0 si finalStatus es Completed o Successful; 1 de lo contrario.

Ejemplos

# Debug a local project, auto-detect folder, default poll interval
uip maestro flow debug ./invoice-flow

# Debug against a specific folder with inline JSON inputs
uip maestro flow debug ./invoice-flow --folder-id 2553016 \
  --inputs '{"amount":100,"customer":"Acme"}'

# Debug with inputs from a file
uip maestro flow debug ./invoice-flow --inputs @inputs.json

# Slower polling for long-running flows
uip maestro flow debug ./invoice-flow --poll-interval 5000

Forma de datos (--json de salida)

{
  "Code": "FlowDebug",
  "Data": {
    "jobKey": "b2c3d4e5-0000-0000-0000-000000000001",
    "instanceId": "c3d4e5f6-0000-0000-0000-000000000001",
    "runId": "d4e5f6a7-0000-0000-0000-000000000001",
    "finalStatus": "Completed",
    "solutionId": "e5f6a7b8-0000-0000-0000-000000000001",
    "studioWebUrl": "https://cloud.uipath.com/org/tenant/studio_/debug/e5f6a7b8",
    "elementExecutions": [
      { "elementId": "Node_1", "status": "Completed" }
    ],
    "variables": {}
  }
}

Abre studioWebUrl en un navegador para inspeccionar la sesión de forma interactiva.

Conversational-trigger handoff

A Flow whose entry point is core.trigger.conversation can only be driven by a chat UI — the CLI cannot start a debug session for it. Instead, it uploads the project to Studio Web and hands off:

{
  "Code": "FlowDebugStudioWebHandoff",
  "Data": {
    "solutionId": "e5f6a7b8-0000-0000-0000-000000000001",
    "studioWebUrl": "https://cloud.uipath.com/org/studio_/designer/a1b2c3d4?solutionId=e5f6a7b8",
    "handedOff": true
  }
}

No elementExecutions/finalStatus fields are present — nothing was run, so there's nothing to poll. Pass --open-in-browser to have the CLI open studioWebUrl automatically.

Faulted run — inline incidents

A faulted run is returned as a Result: "Failure" envelope (exit code 1), with incident details already inline on Data.incidents — no follow-up command is needed to see what broke:

{
  "Code": "FlowDebug",
  "Data": {
    "jobKey": "b2c3d4e5-0000-0000-0000-000000000001",
    "instanceId": "c3d4e5f6-0000-0000-0000-000000000001",
    "runId": "d4e5f6a7-0000-0000-0000-000000000001",
    "finalStatus": "Faulted",
    "incidents": [
      {
        "incidentId": "inc-1",
        "elementId": "Node_3",
        "errorCode": "Process.UnhandledException",
        "errorMessage": "Object reference not set to an instance of an object."
      }
    ]
  }
}

On a faulted run, the error Instructions point you at uip maestro flow debug-instance incidents <instanceId> to inspect the raw backend payload — see debug-instance for that lower-level control surface.

Ver también

• uip maestro flow debug-instance — step-by-step control over a debug session, for building custom tooling
• uip maestro flow validate — comprobación estática antes de ejecutar
• uip maestro flow process run : ejecutar un proceso publicado
• uip maestro flow job traces : seguimientos de flujo para un trabajo ya iniciado
• Autenticación
• Descripción general del flujo