uip o trabajos

Sintaxis y opciones para `uip o trabajos`, que inicia, detiene, reinicia e inspecciona las ejecuciones de procesos de Orchestrator y sus registros.

uip or jobs las ejecuciones de procesos: inicia trabajos desde procesos, los detiene y los reinicia, reanuda trabajos suspendidos e inspecciona registros, seguimientos, datos de Healing Agent e historial de estados. Cada trabajo se identifica mediante una clave GUID que es única a nivel mundial: la mayoría de los verbos resuelven la carpeta a partir de la clave automáticamente.

Sinopsis

uip or jobs <verb> [options]

Verbos

Verbo	Propósito
list	Enumerar trabajos, opcionalmente con ámbito de una carpeta y filtrados por estado, proceso, origen o rango de tiempo.
get	Obtener un trabajo por clave, incluidos los argumentos de entrada/salida y (para trabajos pendientes) razones de diagnóstico.
start	Iniciar uno o más trabajos para un proceso; opcionalmente, esperar a que finalice y descargar la salida.
stop	Detener o forzar la detención de uno o más trabajos en ejecución/pendientes.
restart	Crear un nuevo trabajo a partir de un trabajo defectuoso o detenido.
resume	Reanudar un trabajo suspendido, opcionalmente con argumentos de entrada actualizados.
logs	Obtener registros de ejecución de robot para un trabajo; filtrar por nivel o exportar a CSV.
traces	Obtener seguimientos de ejecución de LlmOps para un trabajo agéntico (tipo agente).
healing-data	Descarga los datos de recuperación de Healing-Agent (capturas de pantalla, datos de IU, registros) como ZIP.
history	Mostrar transiciones de estado para un trabajo.

uip o lista de trabajos

Enumera los trabajos en una carpeta o en todas las carpetas accesibles con --all-folders. Devuelve la clave del trabajo, el estado, el nombre del proceso, el tiempo y la información de la máquina. Se requiere exactamente uno de un selector de carpetas (--folder-path/--folder-key) o --all-folders: el comando se niega a ejecutarse con ambos o con ninguno.

Opciones

Corto	Largo	Valor	Predeterminado	Descripción
—	--folder-path	Ruta	—	Ámbito a una carpeta por ruta (por ejemplo, Shared). Proporciona esto, --folder-key o --all-folders.
—	--folder-key	GUID	—	Ámbito a una carpeta por clave.
—	--all-folders	Marca	Desactivado	Enumerar trabajos en todas las carpetas accesibles. Mutuamente excluyente con los selectores de carpeta.
—	--state	ENUM	—	Pending, Running, Successful, Faulted, Stopped, Stopping, Suspended, Resumed, Terminating.
—	--process-name	text	—	Contiene coincidencia en el nombre del proceso (versión).
—	--source	ENUM	—	Filtrar por tipo de origen de trabajo (por ejemplo, Manual, Schedule, Queue, Agent).
—	--created-after	ISO 8601	—	Trabajos creados a partir de esta fecha/hora.
—	--created-before	ISO 8601	—	Trabajos creados estrictamente antes de esta fecha/hora.
—	--started-after	ISO 8601	—	Trabajos iniciados en o después de esta fecha/hora.
—	--started-before	ISO 8601	—	Trabajos iniciados estrictamente antes de esta fecha/hora.
—	--ended-after	ISO 8601	—	Los trabajos finalizaron en o después de esta fecha/hora.
—	--ended-before	ISO 8601	—	Los trabajos finalizaron estrictamente antes de esta fecha/hora.
-l	--limit	Número	50	Tamaño de la página.
—	--offset	Número	0	Omitir recuento.
—	--sort-by	Campo	Id desc	Expresión de ordenación de OData.
—	--all-fields	Marca	Desactivado	Devuelve la carga útil de la API completa en lugar del resumen seleccionado.

Ejemplos

# The 50 most recent jobs across every accessible folder
uip or jobs list --all-folders

# Running jobs in a specific folder, newest first
uip or jobs list --folder-path "Shared" --state Running

# Pull only job keys and states, script-friendly
uip or jobs list --all-folders --state Faulted --limit 200 \
    --output-filter 'Data[].{key:Key, state:State}'

Forma de datos (--json de salida)

{
  "Code": "JobList",
  "Data": [
    {
      "Key": "b2c3d4e5-0000-0000-0000-000000000001",
      "State": "Running",
      "ProcessName": "InvoiceProcessing",
      "ReleaseKey": "c3d4e5f6-0000-0000-0000-000000000001",
      "Source": "Manual",
      "Type": "Unattended",
      "Priority": "Normal",
      "Machine": "prod-worker-01",
      "MachineKey": "a1b2c3d4-0000-0000-0000-000000000001",
      "StartTime": "2025-04-15T10:30:00Z",
      "EndTime": "",
      "CreationTime": "2025-04-15T10:29:55Z"
    }
  ],
  "Pagination": { "Returned": 1, "Limit": 50, "Offset": 0, "HasMore": false }
}

uip o trabajos obtener

Obtener un trabajo por clave GUID. Devuelve el estado, los argumentos de entrada/salida, el tiempo, la información de la máquina y los detalles del error si falla. Si el estado del trabajo es Pending, la salida también incluye PendingReasons (el informe de diagnóstico de la API sobre por qué el trabajo no se ha iniciado: disponibilidad del robot, capacidad, etc.). No se requiere contexto de carpeta.

Si el trabajo tiene un OutputFile, se descarga automáticamente en el directorio actual (o --output-dir) como output-<job-key>.dat. Pulse --no-download para omitir.

Argumentos

Nombre	Obligatorio	Propósito
<job-key>	Sí	Clave de trabajo (GUID). Encuéntralo con uip or jobs list.

Opciones

Corto	Largo	Valor	Predeterminado	Descripción
—	--output-dir	Ruta	directorio actual	Directorio para el OutputFile descargado.
—	--no-download	Marca	Desactivado	Omitir la descarga automática de OutputFile .
—	--all-fields	Marca	Desactivado	Devuelve la carga útil de la API completa.

Ejemplos

uip or jobs get b2c3d4e5-0000-0000-0000-000000000001

# Skip the output-file download (useful in read-only containers)
uip or jobs get b2c3d4e5-0000-0000-0000-000000000001 --no-download

# Extract just output arguments
uip or jobs get b2c3d4e5-0000-0000-0000-000000000001 \
    --output-filter 'Data.OutputArguments'

Forma de datos (--json de salida)

{
  "Code": "JobGet",
  "Data": {
    "Key": "b2c3d4e5-0000-0000-0000-000000000001",
    "State": "Successful",
    "ReleaseName": "InvoiceProcessing",
    "StartTime": "2025-04-15T10:30:00Z",
    "EndTime": "2025-04-15T10:32:11Z",
    "InputArguments": "{\"invoicePath\":\"/data/inv.pdf\"}",
    "OutputArguments": "{\"result\":\"Processed\"}",
    "HostMachineName": "prod-worker-01",
    "FolderKey": "a1b2c3d4-0000-0000-0000-000000000001"
  }
}

uip o inicio de trabajos

Inicia uno o más trabajos para un proceso. El <process-key> es el GUID devuelto por uip or processes list (no packages list). La carpeta es opcional: si no se proporciona --folder-path ni --folder-key , se infiere del proceso.

Usa uip or packages entry-points para ver los esquemas de argumentos de entrada/salida para una versión de paquete antes de comenzar.

Argumentos

Nombre	Obligatorio	Propósito
<process-key>	Sí	Clave de proceso (versión) (GUID) de uip or processes list.

Opciones

Identidad y tenant

Corto	Largo	Valor	Predeterminado	Descripción
—	--folder-path	Ruta	inferido	Ruta de la carpeta; inferirse del proceso si se omite.
—	--folder-key	GUID	inferido	Clave de carpeta; inferirse del proceso si se omite.

Estrategia de ejecución

Corto	Largo	Valor	Predeterminado	Descripción
—	--strategy	ENUM	ModernJobsCount	ModernJobsCount, All, Specific, JobsCount.
—	--jobs-count	Número	1	Cuántos trabajos crear (para estrategias basadas en recuento).
—	--runtime-type	ENUM	Configuración de carpeta	Unattended, Headless, Serverless, NonProduction, Development, TestAutomation.
—	--job-priority	ENUM	—	Low, Normal, High.
—	--reference	text	—	Cadena de referencia de forma libre almacenada en el trabajo.
—	--run-as-me	Marca	Desactivado	Ejecutar bajo la identidad de la persona que llama.
—	--healing-agent	Marca	Desactivado	Habilite Healing Agent (Autopilot para Robots) para esta ejecución, para recuperarse de fallos del selector y errores de runtime similares. Autopilot en el nivel de tenant ya debe estar habilitado.
—	--user-keys	CSV	—	GUID de usuario para ejecutar como (resueltos en robots no atendidos).
—	--machine-keys	CSV	—	GUID de la máquina al destino.

Entrada y archivos adjuntos

Corto	Largo	Valor	Predeterminado	Descripción
—	--input-arguments	JSON	—	Carga útil JSON en línea. Descarga automática a InputFile por encima de 10 000 caracteres. Mutuamente excluyente con --input-file.
—	--input-file	Ruta	—	Carga un archivo como el InputFile del trabajo. Mutuamente excluyente con --input-arguments.
—	--attachment	[name=]path	—	Cargue un archivo y adjúntelo. Repetible. --attachment ./doc.pdf nombres automáticos a partir del nombre del archivo; --attachment invoice=./report.pdf establece un nombre explícito.
—	--attachment-id	GUID	—	Adjuntar un archivo adjunto existente por ID. Repetible. Buscar ID con attachments list --job-key.
—	--environment-variables	text	—	Variables de entorno como pares KEY=VALUE separados por saltos de línea (no JSON). Validado antes del envío.

Esperando finalización

Corto	Largo	Valor	Predeterminado	Descripción
—	--wait-for-completion	Marca	Desactivado	Sondee hasta que el trabajo llegue a Successful, Faulted o Stopped.
—	--timeout	segundos	300	Tiempo de espera máximo (requiere --wait-for-completion).
—	--poll-interval	segundos	5	Intervalo de sondeo (requiere --wait-for-completion).
—	--output-dir	Ruta	directorio actual	Dónde guardar OutputFile (requiere --wait-for-completion).
—	--no-download	Marca	Desactivado	Omitir descarga OutputFile (requiere --wait-for-completion).

Nota:

--user-keys el GUID de cada usuario en su robot no atendido en la carpeta de destino. Los tipos de robot Attended y AttendedStudioWeb se filtran: los trabajos iniciados por CLI necesitan robots desatendidos. Si no existen robots desatendidos para los usuarios en esta carpeta, el comando falla.

Ejemplos

# Minimal — start one job for a process
uip or jobs start c3d4e5f6-0000-0000-0000-000000000001

# Start with input arguments and wait for completion
uip or jobs start c3d4e5f6-0000-0000-0000-000000000001 \
    --input-arguments '{"invoicePath":"/data/inv.pdf"}' \
    --wait-for-completion --timeout 600

# Upload a file as input and attach a supporting document
uip or jobs start c3d4e5f6-0000-0000-0000-000000000001 \
    --input-file ./payload.json \
    --attachment invoice=./report.pdf

Forma de datos (--json de salida)

Sin --wait-for-completion:

{
  "Code": "JobStarted",
  "Data": {
    "Jobs": [
      {
        "Key": "b2c3d4e5-0000-0000-0000-000000000099",
        "State": "Pending",
        "ProcessName": "InvoiceProcessing",
        "Source": "Manual",
        "Type": "Unattended",
        "Priority": "Normal",
        "Machine": "",
        "StartTime": "",
        "EndTime": "",
        "CreationTime": "2025-04-15T10:29:55Z"
      }
    ]
  }
}

Con --wait-for-completion, el Code es JobCompleted (o JobFaulted en caso de fallo) y Data tiene la misma forma que jobs get más un campo Duration . Si el trabajo falló, el proceso sale con el código 1.

Anulaciones de código de salida específicas del verbo

• --wait-for-completion + trabajo termina en Faulted: sale de 1 aunque el comando logró observar el resultado.
• --wait-for-completion + tiempo de espera alcanzado: sale de 1 con la clave de trabajo actual en Instructions para que pueda sondear con jobs get.

uip o trabajos detenidos

Detener uno o más trabajos en ejecución o pendientes. Con una sola clave, respeta --strategy (SoftStop o Kill). Con varias claves, siempre fuerza las paradas (eliminación) a través de la API masiva: --strategy se ignora en ese caso. No se necesita contexto de carpeta; resuelto a partir de la primera clave de trabajo.

Argumentos

Nombre	Obligatorio	Propósito
<job-keys...>	Sí	Una o más claves de trabajo (GUID).

Opciones

Corto	Largo	Valor	Predeterminado	Descripción
—	--strategy	ENUM	SoftStop	SoftStop (elegante) o Kill (inmediato). Solo se aplica a las paradas de una sola tecla.

Ejemplos

uip or jobs stop b2c3d4e5-0000-0000-0000-000000000001
uip or jobs stop b2c3d4e5-0000-0000-0000-000000000001 --strategy Kill
uip or jobs stop key-1 key-2 key-3   # bulk force-stop

Forma de datos (--json de salida)

Clave única:

{
  "Code": "JobStopped",
  "Data": {
    "JobKey": "b2c3d4e5-0000-0000-0000-000000000001",
    "Strategy": "SoftStop",
    "Status": "Stop requested"
  }
}

Varias claves devuelven Code: "JobsStopped" con JobKeys, Strategy: "Kill (force stop)" y una cadena Status .

reinicio de uip o trabajos

Crear un nuevo trabajo a partir de un trabajo defectuoso o detenido. La carpeta se resuelve a partir de la clave del trabajo.

Argumentos

Nombre	Obligatorio	Propósito
<job-key>	Sí	Clave de trabajo (GUID) para reiniciar.

Opciones

Corto	Largo	Valor	Predeterminado	Descripción

Ejemplos

uip or jobs restart b2c3d4e5-0000-0000-0000-000000000001
uip or jobs restart b2c3d4e5-0000-0000-0000-000000000001 --output-filter 'Data.Key'

Forma de datos (--json de salida)

{
  "Code": "JobRestarted",
  "Data": {
    "Key": "b2c3d4e5-0000-0000-0000-000000000050",
    "State": "Pending",
    "ProcessName": "InvoiceProcessing",
    "Status": "Restart requested"
  }
}

uip o reanudación de trabajos

Reanudar un trabajo suspendido. Los trabajos se suspenden cuando utilizan la actividad Suspend en un flujo de trabajo de larga duración. Opcionalmente, pase el nuevo --input-arguments para continuar con los datos actualizados.

Argumentos

Nombre	Obligatorio	Propósito
<job-key>	Sí	Clave del trabajo (GUID) para reanudar.

Opciones

Corto	Largo	Valor	Predeterminado	Descripción
—	--input-arguments	JSON	—	Argumentos de entrada de reemplazo.

Ejemplos

uip or jobs resume b2c3d4e5-0000-0000-0000-000000000001
uip or jobs resume b2c3d4e5-0000-0000-0000-000000000001 \
    --input-arguments '{"approved":true}'

Forma de datos (--json de salida)

{
  "Code": "JobResumed",
  "Data": {
    "Key": "b2c3d4e5-0000-0000-0000-000000000001",
    "State": "Resumed",
    "ProcessName": "ApprovalFlow",
    "Status": "Resume requested"
  }
}

registros de uip o trabajos

Obtener registros de ejecución de robot para un trabajo. Los registros se devuelven primero los más recientes. --level para filtrar por gravedad. Con --export, los registros se exportan del lado del servidor a CSV y se descargan cuando están listos.

Argumentos

Nombre	Obligatorio	Propósito
<job-key>	Sí	Clave de trabajo (GUID). Validado como UUID antes de cualquier llamada a la API.

Opciones

Corto	Largo	Valor	Predeterminado	Descripción
—	--level	ENUM	—	Fatal, Error, Warning, Info, Trace.
-l	--limit	Número	50	Tamaño de la página.
—	--offset	Número	0	Omitir recuento.
—	--export	Marca	Desactivado	Exporta a CSV a través de la API de exportación del lado del servidor.
-o	--output	Ruta	robot-logs-<job-key>.csv	Ruta CSV de salida. Solo con --export.

Ejemplos

uip or jobs logs b2c3d4e5-0000-0000-0000-000000000001 --level Error --limit 100
uip or jobs logs b2c3d4e5-0000-0000-0000-000000000001 --export -o ./run.csv
uip or jobs logs b2c3d4e5-0000-0000-0000-000000000001 \
    --level Error --output-filter 'Data[].Message'

Forma de datos (--json de salida)

Modo en línea:

{
  "Code": "JobLogs",
  "Data": [
    {
      "Level": "Error",
      "TimeStamp": "2025-04-15T10:31:02Z",
      "Message": "Selector not found: ctrl[name='submit']"
    }
  ]
}

--export emite Code: "JobLogsExported" con JobKey, FileName, Size y ExportId.

seguimientos de uip o trabajos

Obtener seguimientos de ejecución de LlmOps para un trabajo de agente: interacciones de LLM, llamadas de herramientas y decisiones de agente. Solo disponible para procesos de tipo agente. La carpeta se resuelve a partir de la clave del trabajo.

Argumentos

Nombre	Obligatorio	Propósito
<job-key>	Sí	Clave de trabajo (GUID).

Opciones

Corto	Largo	Valor	Predeterminado	Descripción

Ejemplos

uip or jobs traces b2c3d4e5-0000-0000-0000-000000000001
uip or jobs traces b2c3d4e5-0000-0000-0000-000000000001 \
    --output-filter 'Data.messages'

Forma de datos (--json de salida)

La carga útil de la API sin procesar se pasa sin cambios en Data:

{
  "Code": "JobTraces",
  "Data": { "...": "raw LlmOps trace payload" }
}

uip o trabajos Healing-Data

Descarga los datos de recuperación de Healing-Agent (Autopilot para Robots) como ZIP: capturas de pantalla, datos de elementos de IU y registros de recuperación. Solo disponible para trabajos en los que Healing Agent estaba activo. El comando desencadena una exportación asíncrona, sondea la API de exportación hasta que finaliza y luego descarga el ZIP resultante.

Argumentos

Nombre	Obligatorio	Propósito
<job-key>	Sí	Clave de trabajo (GUID).

Opciones

Corto	Largo	Valor	Predeterminado	Descripción
—	--directory-prefix	prefijo	—	Filtro de prefijo de ruta aplicado a los archivos exportados.
-o	--output	Ruta	healing-agent-data-<job-key>.zip	Ruta ZIP de salida.

Ejemplos

uip or jobs healing-data b2c3d4e5-0000-0000-0000-000000000001
uip or jobs healing-data b2c3d4e5-0000-0000-0000-000000000001 \
    -o ./recovery.zip
uip or jobs healing-data b2c3d4e5-0000-0000-0000-000000000001 \
    --output-filter 'Data.FileName'

Forma de datos (--json de salida)

{
  "Code": "JobHealingData",
  "Data": {
    "JobKey": "b2c3d4e5-0000-0000-0000-000000000001",
    "FileName": "healing-agent-data-b2c3d4e5-0000-0000-0000-000000000001.zip",
    "Size": 254318,
    "ExportId": 4711
  }
}

Nota:

La exportación del lado del servidor se sondea hasta 30 veces a intervalos de 2 segundos (60 segundos en total). Si no se completa en esa ventana, el comando sale 1 con el ID de exportación para que puedas volver a intentarlo.

uip o historial de trabajos

Obtener el historial de transición de estado para un trabajo (Pending → Running → Successful/Faulted). La carpeta se resuelve a partir de la clave del trabajo.

Argumentos

Nombre	Obligatorio	Propósito
<job-key>	Sí	Clave de trabajo (GUID).

Opciones

Corto	Largo	Valor	Predeterminado	Descripción

Ejemplos

uip or jobs history b2c3d4e5-0000-0000-0000-000000000001
uip or jobs history b2c3d4e5-0000-0000-0000-000000000001 \
    --output-filter 'Data[].{state:State, ts:Timestamp}'
uip or jobs history b2c3d4e5-0000-0000-0000-000000000001 --output table

Forma de datos (--json de salida)

{
  "Code": "JobHistory",
  "Data": [
    { "State": "Pending", "Timestamp": "2025-04-15T10:29:55Z", "JobId": 1001 },
    { "State": "Running", "Timestamp": "2025-04-15T10:30:00Z", "JobId": 1001 },
    { "State": "Successful", "Timestamp": "2025-04-15T10:32:11Z", "JobId": 1001 }
  ]
}

Códigos de salida

Consulta Códigos de salida para el contrato compartido. Anulaciones específicas de verbos:

• jobs start --wait-for-completion sale de 1 si el trabajo observado finaliza Faulted o se agota el tiempo de espera.
• jobs healing-data sale de 1 si la exportación del lado del servidor no se completa en ~60 segundos.

Comandos relacionados

• uip or processes : gestiona las vinculaciones del proceso (versión) a los que se dirige jobs start .
• uip or packages , especialmente packages entry-points para descubrir esquemas de argumentos de entrada/salida.
• uip or attachments : enumerar y descargar archivos adjuntos de trabajo.
• uip or users — resuelve los nombres de usuario en claves para --user-keys.
• uip or machines — resuelve los nombres de las máquinas en claves para --machine-keys.

Ver también

• Opciones globales : --output, --output-filter, --log-level, --log-file.
• Sesiones : cómo se resuelven el contexto del tenant y la carpeta.
• Tu primer proceso : un tutorial de extremo a extremo utilizando jobs start --wait-for-completion.