API dei piani degli agenti

Esamina i piani salvati e i relativi passaggi.

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_plan`	Elenca i piani degli agenti
`GET`	`/v1/agent_plan/{id}`	Ottieni il piano dell’agente
`GET`	`/v1/agent_plan_step`	Elenca i passaggi del piano dell’agente
`GET`	`/v1/agent_plan_step/{id}`	Ottieni un passaggio del piano dell’agente

Elenca i piani degli agenti

GET /v1/agent_plan

Restituisce un elenco paginato di AgentPlan

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

Risposta: HTTP 200

Elenco di AgentPlan

Campi di risposta

Campo	Tipo	Descrizione
`data`	array
`data[].agent_plan_id`	string
`data[].agent_run_id`	string
`data[].agent_session_id`	string
`data[].created_at`	integer	(timestamp Unix)
`data[].deleted_at`	integer	(timestamp Unix)
`data[].metadata`	object
`data[].status`	string	Valori consentiti: pending, running, blocked, complete, failed, cancelled.
`data[].summary`	object
`data[].team_id`	string
`data[].title`	string
`data[].updated_at`	integer	(timestamp Unix)
`data[].workspace_id`	string
`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

Esempio illustrativo; non è una risposta dal vivo:

{
  "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
  }
}

Ottieni il piano dell’agente

GET /v1/agent_plan/{id}

Restituisce un oggetto AgentPlan

Imposta agent_plan_id usando gli ID restituiti dalle tue risposte API.

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

Parametri

Nome	Posizione	Obbligatorio	Descrizione
`id`	path	Sì	Identificativo della risorsa ottenuto dai risultati API del tuo team.
`X-Tenant-ID`	header	Sì	ID del team attivo. Deve corrispondere al tenant a cui è vincolato il token diagnostico.

Esempio di richiesta

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"

Risposta: HTTP 200

AgentPlan

Campi di risposta

Campo	Tipo	Descrizione
`agent_plan_id`	string
`agent_run_id`	string
`agent_session_id`	string
`created_at`	integer	(timestamp Unix)
`deleted_at`	integer	(timestamp Unix)
`metadata`	object
`status`	string	Valori consentiti: pending, running, blocked, complete, failed, cancelled.
`summary`	object
`team_id`	string
`title`	string
`updated_at`	integer	(timestamp Unix)
`workspace_id`	string

Esempio illustrativo; non è una risposta dal vivo:

{
  "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": ""
}

Elenca i passaggi del piano dell’agente

GET /v1/agent_plan_step

Restituisce un elenco paginato di AgentPlanStep

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

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"

Risposta: HTTP 200

Elenco di AgentPlanStep

Campi di risposta

Campo	Tipo	Descrizione
`data`	array
`data[].agent_plan_id`	string
`data[].agent_plan_step_id`	string
`data[].agent_version_id`	string
`data[].child_agent_run_id`	string
`data[].completed_at`	integer	(timestamp Unix)
`data[].created_at`	integer	(timestamp Unix)
`data[].deleted_at`	integer	(timestamp Unix)
`data[].dependencies`	object
`data[].description`	object
`data[].error`	object
`data[].execution_task_id`	string
`data[].metadata`	object
`data[].position`	integer
`data[].role_key`	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, passed, failed, blocked, skipped.
`data[].team_id`	string
`data[].title`	string
`data[].tool_name`	string
`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 passaggio del piano dell’agente

GET /v1/agent_plan_step/{id}

Restituisce un oggetto AgentPlanStep

Imposta agent_plan_step_id usando gli ID restituiti dalle tue risposte API.

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

Parametri

Nome	Posizione	Obbligatorio	Descrizione
`id`	path	Sì	Identificativo della risorsa ottenuto dai risultati API del tuo team.
`X-Tenant-ID`	header	Sì	ID del team attivo. Deve corrispondere al tenant a cui è vincolato il token diagnostico.

Esempio di richiesta

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"

Risposta: HTTP 200

AgentPlanStep

Campi di risposta

Campo	Tipo	Descrizione
`agent_plan_id`	string
`agent_plan_step_id`	string
`agent_version_id`	string
`child_agent_run_id`	string
`completed_at`	integer	(timestamp Unix)
`created_at`	integer	(timestamp Unix)
`deleted_at`	integer	(timestamp Unix)
`dependencies`	object
`description`	object
`error`	object
`execution_task_id`	string
`metadata`	object
`position`	integer
`role_key`	string
`specialist_role`	string	Valori consentiti: lead, security, code_quality, test_verification.
`started_at`	integer	(timestamp Unix)
`status`	string	Valori consentiti: pending, running, passed, failed, blocked, skipped.
`team_id`	string
`title`	string
`tool_name`	string
`updated_at`	integer	(timestamp Unix)

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