API des plans d’agent

Inspectez les plans sauvegardés et leurs étapes.

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_plan`	Lister les plans d’agent
`GET`	`/v1/agent_plan/{id}`	Obtenir un plan d’agent
`GET`	`/v1/agent_plan_step`	Lister les étapes des plans d’agent
`GET`	`/v1/agent_plan_step/{id}`	Obtenir une étape de plan d’agent

Lister les plans d’agent

GET /v1/agent_plan

Renvoie une liste paginée d’AgentPlan

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_plan" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Réponse : HTTP 200

Liste d’AgentPlan

Champs de réponse

Champ	Type	Description
`data`	tableau
`data[].agent_plan_id`	chaîne
`data[].agent_run_id`	chaîne
`data[].agent_session_id`	chaîne
`data[].created_at`	entier	(horodatage Unix)
`data[].deleted_at`	entier	(horodatage Unix)
`data[].metadata`	objet
`data[].status`	chaîne	Valeurs autorisées : pending, running, blocked, complete, failed, cancelled.
`data[].summary`	objet
`data[].team_id`	chaîne
`data[].title`	chaîne
`data[].updated_at`	entier	(horodatage Unix)
`data[].workspace_id`	chaîne
`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

Exemple illustratif ; il ne s’agit pas d’une réponse réelle :

{
  "data": [
    {
      "agent_plan_id": "000000000000000000000000001",
      "agent_run_id": "",
      "agent_session_id": "000000000000000000000000001",
      "created_at": 1791072000,
      "deleted_at": 0,
      "metadata": {},
      "status": "pending",
      "summary": "",
      "team_id": "000000000000000000000000001",
      "title": "Agent plan",
      "updated_at": 1791072000,
      "workspace_id": ""
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 1,
    "total": 1
  }
}

Obtenir un plan d’agent

GET /v1/agent_plan/{id}

Renvoie un seul AgentPlan

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

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

Paramètres

Nom	Emplacement	Requis	Description
`id`	chemin	oui	Identifiant de ressource issu des résultats API de votre équipe.
`X-Tenant-ID`	en-tête	oui	ID de l’équipe active. Doit correspondre au tenant lié au jeton de diagnostic.

Exemple de requête

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

Réponse : HTTP 200

AgentPlan

Champs de réponse

Champ	Type	Description
`agent_plan_id`	chaîne
`agent_run_id`	chaîne
`agent_session_id`	chaîne
`created_at`	entier	(horodatage Unix)
`deleted_at`	entier	(horodatage Unix)
`metadata`	objet
`status`	chaîne	Valeurs autorisées : pending, running, blocked, complete, failed, cancelled.
`summary`	objet
`team_id`	chaîne
`title`	chaîne
`updated_at`	entier	(horodatage Unix)
`workspace_id`	chaîne

Exemple illustratif ; il ne s’agit pas d’une réponse réelle :

{
  "agent_plan_id": "000000000000000000000000001",
  "agent_run_id": "",
  "agent_session_id": "000000000000000000000000001",
  "created_at": 1791072000,
  "deleted_at": 0,
  "metadata": {},
  "status": "pending",
  "summary": "",
  "team_id": "000000000000000000000000001",
  "title": "Agent plan",
  "updated_at": 1791072000,
  "workspace_id": ""
}

Lister les étapes des plans d’agent

GET /v1/agent_plan_step

Renvoie une liste paginée d’AgentPlanStep

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

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

Réponse : HTTP 200

Liste d’AgentPlanStep

Champs de réponse

Champ	Type	Description
`data`	tableau
`data[].agent_plan_id`	chaîne
`data[].agent_plan_step_id`	chaîne
`data[].agent_version_id`	chaîne
`data[].child_agent_run_id`	chaîne
`data[].completed_at`	entier	(horodatage Unix)
`data[].created_at`	entier	(horodatage Unix)
`data[].deleted_at`	entier	(horodatage Unix)
`data[].dependencies`	objet
`data[].description`	objet
`data[].error`	objet
`data[].execution_task_id`	chaîne
`data[].metadata`	objet
`data[].position`	entier
`data[].role_key`	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, passed, failed, blocked, skipped.
`data[].team_id`	chaîne
`data[].title`	chaîne
`data[].tool_name`	chaîne
`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 étape de plan d’agent

GET /v1/agent_plan_step/{id}

Renvoie un seul AgentPlanStep

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

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

Paramètres

Nom	Emplacement	Requis	Description
`id`	chemin	oui	Identifiant de ressource issu des résultats API de votre équipe.
`X-Tenant-ID`	en-tête	oui	ID de l’équipe active. Doit correspondre au tenant lié au jeton de diagnostic.

Exemple de requête

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

Réponse : HTTP 200

AgentPlanStep

Champs de réponse

Champ	Type	Description
`agent_plan_id`	chaîne
`agent_plan_step_id`	chaîne
`agent_version_id`	chaîne
`child_agent_run_id`	chaîne
`completed_at`	entier	(horodatage Unix)
`created_at`	entier	(horodatage Unix)
`deleted_at`	entier	(horodatage Unix)
`dependencies`	objet
`description`	objet
`error`	objet
`execution_task_id`	chaîne
`metadata`	objet
`position`	entier
`role_key`	chaîne
`specialist_role`	chaîne	Valeurs autorisées : lead, security, code_quality, test_verification.
`started_at`	entier	(horodatage Unix)
`status`	chaîne	Valeurs autorisées : pending, running, passed, failed, blocked, skipped.
`team_id`	chaîne
`title`	chaîne
`tool_name`	chaîne
`updated_at`	entier	(horodatage Unix)

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.