API de execuções de agentes

Inspecione as execuções persistentes de agentes. O estado de execução é gerenciado pelo serviço de agentes.

Usar Autenticação da API para pedidos protegidos. Exemplos usam seus próprios IDs de recursos e um token temporário; exemplos de resposta salvos são sintéticos.

Método	Caminho	Operação
`GET`	`/v1/agent_run`	Listar as execuções do agente
`GET`	`/v1/agent_run/{id}`	Obter execução de agente

Listar as execuções do agente

GET /v1/agent_run

Retorna uma lista paginada de AgentRun

Autenticação: token bearer e o cabeçalho de equipe mostrado abaixo.

Parâmetros

Nome	Localização	Obrigatório	Descrição
`X-Tenant-ID`	cabeçalho	sim	ID da equipe ativa. Deve corresponder ao tenant vinculado a um token de diagnóstico.
`page`	consulta	não	Número da página
`per_page`	consulta	não	Itens por página

Exemplo de requisição

Defina ADIOS_API_URL=https://api.adios.dev. Para requisições protegidas, defina ADIOS_ACCESS_TOKEN e ADIOS_TEAM_ID como na início rápido. Defina quaisquer variáveis adicionais ADIOS_* variáveis dos seus próprios resultados de 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"

Resposta: HTTP 200

Lista de AgentRun

Campos de resposta

Campo	Tipo	Descrição
`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`	inteiro
`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`	inteiro
`data[].budget_tokens`	inteiro
`data[].cached_tokens`	inteiro
`data[].company_project_id`	string
`data[].completed_at`	inteiro	(Timestamp Unix)
`data[].created_at`	inteiro	(Timestamp Unix)
`data[].deleted_at`	inteiro	(Timestamp Unix)
`data[].effective_policy`	objeto
`data[].effective_policy_digest`	string
`data[].environment_checkpoint_id`	string
`data[].error`	objeto
`data[].estimated_cost_micros`	inteiro
`data[].execution_id`	string
`data[].execution_task_id`	string
`data[].head_sha`	string
`data[].idempotency_key`	string
`data[].input_tokens`	inteiro
`data[].last_activity_at`	inteiro	(Timestamp Unix)
`data[].lead_agent_run_id`	string
`data[].metadata`	objeto
`data[].mode`	string	Valores permitidos: build, debug, ops, review, chat, background.
`data[].model`	string
`data[].output_tokens`	inteiro
`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`	booleano
`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`	inteiro	(Timestamp Unix)
`data[].status`	string	Valores permitidos: pending, running, blocked, cancelling, complete, failed, cancelled.
`data[].step_count`	inteiro
`data[].structured_outcome`	objeto
`data[].suite_node_key`	string
`data[].suite_profile`	string
`data[].summary`	objeto
`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`	inteiro
`data[].tool_scope`	objeto
`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`	inteiro	(Timestamp Unix)
`pagination`	objeto
`pagination.page`	inteiro	Número da página atual
`pagination.per_page`	inteiro	Número de itens por página
`pagination.total`	inteiro	Número total de itens

A ilustração de coleção derivada do esquema é omitida aqui porque não satisfaz o esquema de resposta publicado. Use o contrato de campo acima.

Obter execução de agente

GET /v1/agent_run/{id}

Retorna um objeto AgentRun

Defina agent_run_id usando IDs das suas próprias respostas da API.