API de ejecuciones de agentes

Inspecciona las ejecuciones persistentes del agente. El servicio de agentes gestiona su estado.

Usa Autenticación de la API para las solicitudes protegidas. Los ejemplos usan tus propios IDs de recursos y un token temporal; las respuestas de ejemplo guardadas son sintéticas.

Método	Ruta	Operación
`GET`	`/v1/agent_run`	Listar ejecuciones del agente
`GET`	`/v1/agent_run/{id}`	Obtener ejecución del agente

Listar ejecuciones del agente

GET /v1/agent_run

Devuelve una lista con paginas de AgentRun

Autenticación: token bearer y la cabecera de equipo que se muestra a continuación.

Parámetros

Nombre	Ubicación	Obligatorio	Descripción
`X-Tenant-ID`	cabecera	sí	ID del equipo activo. Debe coincidir con el tenant vinculado al token de diagnóstico.
`page`	consulta	no	Número de página
`per_page`	consulta	no	Elementos por página

Ejemplo de solicitud

Configura ADIOS_API_URL=https://api.adios.dev. Para las solicitudes protegidas, configura ADIOS_ACCESS_TOKEN y ADIOS_TEAM_ID como en el inicio rápido. Configura las variables adicionales ADIOS_* a partir de los resultados de tus propios recursos.

curl --fail-with-body --request GET "$ADIOS_API_URL/v1/agent_run" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Respuesta: HTTP 200

Lista de AgentRun

Campos de respuesta

Campo	Tipo	Descripción
`data`	array
`data[].action_digest`	string
`data[].agent_binding_id`	string
`data[].agent_binding_revision_id`	string
`data[].agent_definition_id`	string
`data[].agent_draft_id`	string
`data[].agent_draft_revision`	integer
`data[].agent_kit_content_digest`	string
`data[].agent_kit_entrypoint`	string
`data[].agent_kit_function`	string
`data[].agent_kit_version_id`	string
`data[].agent_run_id`	string
`data[].agent_session_id`	string
`data[].agent_suite_id`	string
`data[].agent_suite_version_id`	string
`data[].agent_version_digest`	string
`data[].agent_version_id`	string
`data[].agent_work_cycle_id`	string
`data[].approval_id`	string
`data[].base_sha`	string
`data[].branch`	string
`data[].budget_cost_micros`	integer
`data[].budget_tokens`	integer
`data[].cached_tokens`	integer
`data[].company_project_id`	string
`data[].completed_at`	integer	(marca de tiempo Unix)
`data[].created_at`	integer	(marca de tiempo Unix)
`data[].deleted_at`	integer	(marca de tiempo Unix)
`data[].effective_policy`	object
`data[].effective_policy_digest`	string
`data[].environment_checkpoint_id`	string
`data[].error`	object
`data[].estimated_cost_micros`	integer
`data[].execution_id`	string
`data[].execution_task_id`	string
`data[].head_sha`	string
`data[].idempotency_key`	string
`data[].input_tokens`	integer
`data[].last_activity_at`	integer	(marca de tiempo Unix)
`data[].lead_agent_run_id`	string
`data[].metadata`	object
`data[].mode`	string	Valores permitidos: build, debug, ops, review, chat, background.
`data[].model`	string
`data[].output_tokens`	integer
`data[].owner_id`	string
`data[].parent_agent_run_id`	string
`data[].preset`	string	Valores permitidos: security_review, code_review, verify_changes, engineering_review, finding_fix.
`data[].provider`	string
`data[].read_only`	boolean
`data[].retention_class`	string	Valores permitidos: ephemeral, standard, extended, compliance.
`data[].role_key`	string
`data[].source`	string	Valores permitidos: app, slack, cli, workflow, event, schedule, system.
`data[].source_snapshot_digest`	string
`data[].specialist_role`	string	Valores permitidos: lead, security, code_quality, test_verification.
`data[].started_at`	integer	(marca de tiempo Unix)
`data[].status`	string	Valores permitidos: pending, running, blocked, cancelling, complete, failed, cancelled.
`data[].step_count`	integer
`data[].structured_outcome`	object
`data[].suite_node_key`	string
`data[].suite_profile`	string
`data[].summary`	object
`data[].target_kind`	string	Valores permitidos: standalone, browser, workspace, workload, project, company_project, repository, pull_request, finding, custom.
`data[].target_ref`	string
`data[].team_id`	string
`data[].tool_call_count`	integer
`data[].tool_scope`	object
`data[].trace_id`	string
`data[].trigger_principal_id`	string
`data[].trigger_ref`	string
`data[].trigger_type`	string	Valores permitidos: manual, draft_test, pre_merge, schedule, event, workflow, compatibility, approval.
`data[].updated_at`	integer	(marca de tiempo Unix)
`pagination`	object
`pagination.page`	integer	Número de página actual
`pagination.per_page`	integer	Número de elementos por página
`pagination.total`	integer	Número total de elementos

Aquí se omite el ejemplo de colección derivado del esquema porque no cumple el esquema de respuesta publicado. Usa el contrato de campos anterior.

Obtener ejecución del agente

GET /v1/agent_run/{id}

Devuelve un único AgentRun

Configura agent_run_id usando IDs de tus propias respuestas de la API.