Continúa en la misma sesión de Bash y en el mismo directorio de trabajo del inicio rápido. Primero comprueba que el cliente admita las operaciones que usa esta página:
jq -e '.data.operations as $ops | ["validateWorkflow","startRun","getRun","listRunNodes","listRunArtifacts"] - $ops | length == 0' capabilities.jsonElige un perfil de navegador Chromium. El ID del entorno es el envId del perfil. Si solo conoces el nombre del perfil, búscalo con ml-cli env find --keyword <keyword> o con POST /api/env/page de la Local API de navegador, y resuelve cualquier ambigüedad antes de ejecutar. Para confirmar el tipo de navegador, comprueba que POST /api/env/detail devuelva browserTypeId: 1. Pasa el ID como cadena. Las posiciones en la lista y los puertos de depuración no son ID de perfil.
Usa el mismo ID de plantilla, la misma versión, el mismo entorno y los mismos parámetros en la verificación previa y en la ejecución. Proporciona el valor de cada parámetro como {kind:"json",value:...}. Los parámetros privados se envían como texto plano, y los parámetros de archivo usan rutas locales absolutas (un array si hay varios archivos). Este ejemplo no tiene parámetros privados. Continúa solo cuando el informe de validación muestre valid: true y esté completo. Si el perfil está ocupado, espera hasta que la ejecución anterior libere su aislamiento.
: "${RPA_ENVIRONMENT_ID:?Set the actual Chromium profile ID first}"
jq --arg env "$RPA_ENVIRONMENT_ID" '
.data | {templateId:.id,version,environmentId:$env,
parameters:{targetUrl:{kind:"json",value:"https://example.com"}}}
' created.json > start-run.json &&
jq '{purpose:"run",source:{kind:"template",templateId,version},
environmentId,parameters}' start-run.json > validate-run.json &&
rpa_curl "$RPA_BASE_URL/validations" -H 'Content-Type: application/json' --data-binary @validate-run.json -o validation-run.json &&
jq '.data | {valid,issues,truncated,runtimeChecks}' validation-run.json &&
jq -e '.data.valid == true and .data.truncated == false' validation-run.json([ -s run.key ] || uuidgen > run.key) &&
rpa_curl "$RPA_BASE_URL/runs" \
-H 'Content-Type: application/json' \
-H "X-RPA-Catalog-Revision: $RPA_CATALOG_REVISION" \
-H "Idempotency-Key: $(cat run.key)" \
--data-binary @start-run.json -o started.json &&
RPA_RUN_ID="$(jq -er '.data.id' started.json)" &&
jq '.data | {id,status,template}' started.jsonHTTP 202 significa que la ejecución quedó registrada, no que terminó. Conserva el ID de la ejecución, la clave original y la revisión congelada de la plantilla. Un tiempo de espera agotado en el transporte no cancela la ejecución: usa la recuperación de solicitudes antes de enviar otra escritura.
for attempt in $(seq 1 100); do
rpa_curl "$RPA_BASE_URL/runs/$RPA_RUN_ID" -o run-detail.json || break
status="$(jq -r '.data.run.status' run-detail.json)"
echo "status: $status"
case "$status" in
success|failed|cancelled|stopped|missed) break ;;
queued) sleep 5 ;;
*) sleep 3 ;;
esac
doneEl bucle consulta una ejecución activa cada 3 segundos y una ejecución en cola cada 5 segundos, y se detiene después de 100 consultas. Los estados activos son queued, preparing, running y cancel_requested. Los estados terminales son success, failed, cancelled, stopped y missed. Mantén todas las solicitudes de observación en un máximo de 40 por minuto y respeta Retry-After ante un 429 o un 503.
jq '.data | {status:.run.status,hasNodeErrors:.run.hasNodeErrors,
isolation:.run.isolation,outputs:.result.outputs,error:.result.error}' run-detail.json &&
rpa_curl "$RPA_BASE_URL/runs/$RPA_RUN_ID/nodes?page=1&pageSize=20" -o run-nodes.json &&
rpa_curl "$RPA_BASE_URL/runs/$RPA_RUN_ID/artifacts" -o run-artifacts.jsonEl ejemplo devuelve outputs.result: "https://example.com/". Revisa data.run.hasNodeErrors, data.run.isolation.state y tanto data.result.outputs como data.result.error: una ejecución puede completarse correctamente aunque algunos nodos hayan fallado y se hayan omitido.
Los registros de ejecución de nodos están paginados. Mientras una ejecución está activa, lee desde la página 1 en cada pasada y combina los registros por items[].id. Cuando la ejecución alcance un estado terminal, lee todas las páginas sin filtro de estado. El endpoint de artefactos solo devuelve metadatos. Oculta los datos sensibles de la salida antes de compartirla.
La cancelación es una solicitud: sigue comprobando el estado terminal real y el estado de aislamiento. No reinicies automáticamente cuando el resultado sea incierto o el entorno siga en cuarentena. Para más detalles, consulta Obtener detalles de la ejecución, Listar ejecuciones de nodos y Observación de ejecuciones y recuperación de solicitudes.