API delle esecuzioni degli agenti

Esamina le esecuzioni persistenti degli agenti. Lo stato delle esecuzioni è gestito dal servizio degli agenti.

Usa Autenticazione API per le richieste protette. Gli esempi usano i tuoi ID di risorse e un token temporaneo; gli esempi di risposte salvate sono sintetici.

Metodo	Percorso	Operazione
`GET`	`/v1/agent_run`	Elenca le esecuzioni degli agenti
`GET`	`/v1/agent_run/{id}`	Ottieni un’esecuzione dell’agente

Elenca le esecuzioni degli agenti

GET /v1/agent_run

Restituisce un elenco paginato di AgentRun

Autenticazione: token bearer e intestazione del team mostrate di seguito.

Parametri

Nome	Posizione	Obbligatorio	Descrizione
`X-Tenant-ID`	header	Sì	ID del team attivo. Deve corrispondere al tenant a cui è vincolato il token diagnostico.
`page`	query	No	Numero di pagina
`per_page`	query	No	Elementi per pagina

Esempio di richiesta

Imposta ADIOS_API_URL=https://api.adios.dev. Per le richieste protette, imposta ADIOS_ACCESS_TOKEN e ADIOS_TEAM_ID come nel guida rapida. Imposta le eventuali variabili aggiuntive ADIOS_* con i valori ottenuti dalle tue risorse.

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"

Risposta: HTTP 200

Elenco di AgentRun

Campi di risposta

Campo	Tipo	Descrizione
`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	(timestamp Unix)
`data[].created_at`	integer	(timestamp Unix)
`data[].deleted_at`	integer	(timestamp 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	(timestamp Unix)
`data[].lead_agent_run_id`	string
`data[].metadata`	object
`data[].mode`	string	Valori consentiti: 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	Valori consentiti: security_review, code_review, verify_changes, engineering_review, finding_fix.
`data[].provider`	string
`data[].read_only`	boolean
`data[].retention_class`	string	Valori consentiti: ephemeral, standard, extended, compliance.
`data[].role_key`	string
`data[].source`	string	Valori consentiti: app, slack, cli, workflow, event, schedule, system.
`data[].source_snapshot_digest`	string
`data[].specialist_role`	string	Valori consentiti: lead, security, code_quality, test_verification.
`data[].started_at`	integer	(timestamp Unix)
`data[].status`	string	Valori consentiti: 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	Valori consentiti: 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	Valori consentiti: manual, draft_test, pre_merge, schedule, event, workflow, compatibility, approval.
`data[].updated_at`	integer	(timestamp Unix)
`pagination`	object
`pagination.page`	integer	Numero di pagina attuale
`pagination.per_page`	integer	Numero di elementi per pagina
`pagination.total`	integer	Numero totale di elementi

L’esempio di raccolta ricavato dallo schema è omesso perché non rispetta lo schema di risposta pubblicato. Usa le specifiche dei campi riportate sopra.

Ottieni un’esecuzione dell’agente

GET /v1/agent_run/{id}

Restituisce un oggetto AgentRun

Imposta agent_run_id usando gli ID restituiti dalle tue risposte API.