API des exécutions d’agent

Inspectez les exécutions d’agent persistantes. Leur état est géré par le service d’agent.

Utiliser Authentification API pour les requêtes protégées. Les exemples utilisent vos propres ID de ressources et un jeton temporaire ; les exemples de réponses enregistrés sont synthétiques.

Méthode	Chemin	Opération
`GET`	`/v1/agent_run`	Lister les exécutions d’agent
`GET`	`/v1/agent_run/{id}`	Obtenir une exécution d’agent

Lister les exécutions d’agent

GET /v1/agent_run

Renvoie une liste paginée d’AgentRun

Authentification : jeton bearer et en-tête d’équipe présentés ci-dessous.

Paramètres

Nom	Emplacement	Requis	Description
`X-Tenant-ID`	en-tête	oui	ID de l’équipe active. Doit correspondre au tenant lié au jeton de diagnostic.
`page`	requête	non	Numéro de page
`per_page`	requête	non	Éléments par page

Exemple de requête

Définissez ADIOS_API_URL=https://api.adios.dev. Pour les requêtes protégées, définissez ADIOS_ACCESS_TOKEN et ADIOS_TEAM_ID comme dans le démarrage rapide. Définissez les autres variables ADIOS_* à partir des résultats de vos propres ressources.

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"

Réponse : HTTP 200

Liste d’AgentRun

Champs de réponse

Champ	Type	Description
`data`	tableau
`data[].action_digest`	chaîne
`data[].agent_binding_id`	chaîne
`data[].agent_binding_revision_id`	chaîne
`data[].agent_definition_id`	chaîne
`data[].agent_draft_id`	chaîne
`data[].agent_draft_revision`	entier
`data[].agent_kit_content_digest`	chaîne
`data[].agent_kit_entrypoint`	chaîne
`data[].agent_kit_function`	chaîne
`data[].agent_kit_version_id`	chaîne
`data[].agent_run_id`	chaîne
`data[].agent_session_id`	chaîne
`data[].agent_suite_id`	chaîne
`data[].agent_suite_version_id`	chaîne
`data[].agent_version_digest`	chaîne
`data[].agent_version_id`	chaîne
`data[].agent_work_cycle_id`	chaîne
`data[].approval_id`	chaîne
`data[].base_sha`	chaîne
`data[].branch`	chaîne
`data[].budget_cost_micros`	entier
`data[].budget_tokens`	entier
`data[].cached_tokens`	entier
`data[].company_project_id`	chaîne
`data[].completed_at`	entier	(horodatage Unix)
`data[].created_at`	entier	(horodatage Unix)
`data[].deleted_at`	entier	(horodatage Unix)
`data[].effective_policy`	objet
`data[].effective_policy_digest`	chaîne
`data[].environment_checkpoint_id`	chaîne
`data[].error`	objet
`data[].estimated_cost_micros`	entier
`data[].execution_id`	chaîne
`data[].execution_task_id`	chaîne
`data[].head_sha`	chaîne
`data[].idempotency_key`	chaîne
`data[].input_tokens`	entier
`data[].last_activity_at`	entier	(horodatage Unix)
`data[].lead_agent_run_id`	chaîne
`data[].metadata`	objet
`data[].mode`	chaîne	Valeurs autorisées : build, debug, ops, review, chat, background.
`data[].model`	chaîne
`data[].output_tokens`	entier
`data[].owner_id`	chaîne
`data[].parent_agent_run_id`	chaîne
`data[].preset`	chaîne	Valeurs autorisées : security_review, code_review, verify_changes, engineering_review, finding_fix.
`data[].provider`	chaîne
`data[].read_only`	booléen
`data[].retention_class`	chaîne	Valeurs autorisées : ephemeral, standard, extended, compliance.
`data[].role_key`	chaîne
`data[].source`	chaîne	Valeurs autorisées : app, slack, cli, workflow, event, schedule, system.
`data[].source_snapshot_digest`	chaîne
`data[].specialist_role`	chaîne	Valeurs autorisées : lead, security, code_quality, test_verification.
`data[].started_at`	entier	(horodatage Unix)
`data[].status`	chaîne	Valeurs autorisées : pending, running, blocked, cancelling, complete, failed, cancelled.
`data[].step_count`	entier
`data[].structured_outcome`	objet
`data[].suite_node_key`	chaîne
`data[].suite_profile`	chaîne
`data[].summary`	objet
`data[].target_kind`	chaîne	Valeurs autorisées : standalone, browser, workspace, workload, project, company_project, repository, pull_request, finding, custom.
`data[].target_ref`	chaîne
`data[].team_id`	chaîne
`data[].tool_call_count`	entier
`data[].tool_scope`	objet
`data[].trace_id`	chaîne
`data[].trigger_principal_id`	chaîne
`data[].trigger_ref`	chaîne
`data[].trigger_type`	chaîne	Valeurs autorisées : manual, draft_test, pre_merge, schedule, event, workflow, compatibility, approval.
`data[].updated_at`	entier	(horodatage Unix)
`pagination`	objet
`pagination.page`	entier	Numéro de page actuel
`pagination.per_page`	entier	Nombre d’éléments par page
`pagination.total`	entier	Nombre total d’éléments

L’illustration de la collection dérivée du schéma est omise ici, car elle ne respecte pas le schéma de réponse publié. Utilisez le contrat des champs ci-dessus.

Obtenir une exécution d’agent

GET /v1/agent_run/{id}

Renvoie un seul AgentRun

Définissez agent_run_id en utilisant les ID de vos propres réponses API.