API delle sessioni degli agenti

Gestisci lo stato della conversazione. Creare il solo record di una sessione non avvia un’esecuzione IA. Usa l’applicazione Adios o l’integrazione MCP per avviare il lavoro dell’agente.

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_session	Elenca le sessioni degli agenti
POST	/v1/agent_session	Crea una sessione dell’agente
GET	/v1/agent_session/{id}	Ottieni una sessione dell’agente
PUT	/v1/agent_session/{id}	Aggiorna una sessione dell’agente
DELETE	/v1/agent_session/{id}	Elimina una sessione dell’agente
GET	/v1/agent_session/{id}/state	Ottieni lo stato della sessione dell’agente
GET	/v1/agent_session/{id}/plan	Ottieni il piano della sessione dell’agente
POST	/v1/agent_session/{id}/runs/{run_id}/cancel	Annulla l’esecuzione dell’agente

Elenca le sessioni degli agenti

GET /v1/agent_session

Restituisce un elenco paginato di AgentSession

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

Risposta: HTTP 200

Elenco di AgentSession

Campi di risposta

Campo	Tipo	Descrizione
data	array
data[].agent_session_id	string
data[].channel_id	string
data[].company_project_id	string
data[].context_snapshot	object
data[].created_at	integer	(timestamp Unix)
data[].deleted_at	integer	(timestamp Unix)
data[].last_message_at	integer	(timestamp Unix)
data[].memory_summary	object
data[].metadata	object
data[].mode	string	Valori consentiti: build, debug, ops, review, chat.
data[].model	string
data[].owner_id	string
data[].provider	string
data[].sharing_scope	string	Valori consentiti: private, team.
data[].source	string	Valori consentiti: app, slack, cli.
data[].status	string	Valori consentiti: active, paused, blocked, complete, failed.
data[].team_id	string
data[].thread_id	string
data[].updated_at	integer	(timestamp Unix)
data[].workspace_id	string
data[].writable_repository_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_session_id": "000000000000000000000000001",
      "channel_id": "",
      "company_project_id": "",
      "context_snapshot": {},
      "created_at": 1791072000,
      "deleted_at": 0,
      "last_message_at": 0,
      "memory_summary": {},
      "metadata": {},
      "mode": "chat",
      "model": "",
      "owner_id": "",
      "provider": "",
      "sharing_scope": "private",
      "source": "app",
      "status": "active",
      "team_id": "000000000000000000000000001",
      "thread_id": "",
      "updated_at": 1791072000,
      "workspace_id": "",
      "writable_repository_id": ""
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 1,
    "total": 1
  }
}

Crea una sessione dell’agente

POST /v1/agent_session

Crea un nuovo oggetto AgentSession

Questa richiesta modifica dati o avvia un’azione. Controlla la destinazione e il corpo prima dell’invio.

Campi di richiesta (il corpo contiene un esempio modificabile):

Campo	Tipo	Obbligatorio	Descrizione
channel_id	string	No	Valore predefinito: "".
company_project_id	string	No	Valore predefinito: "".
context_snapshot	object	No
last_message_at	integer	No	(timestamp Unix) Valore predefinito: 0.
memory_summary	object	No
metadata	object	No
mode	string	Sì	Valori consentiti: build, debug, ops, review, chat. Valore predefinito: "chat".
model	string	No	Valore predefinito: "".
owner_id	string	No	Valore predefinito: "".
provider	string	No	Valore predefinito: "".
sharing_scope	string	Sì	Valori consentiti: private, team. Valore predefinito: "private".
source	string	Sì	Valori consentiti: app, slack, cli.
status	string	Sì	Valori consentiti: active, paused, blocked, complete, failed. Valore predefinito: "active".
team_id	string	Sì
thread_id	string	No	Valore predefinito: "".
workspace_id	string	No	Valore predefinito: "".
writable_repository_id	string	No	Valore predefinito: "".

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.

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 POST "$ADIOS_API_URL/v1/agent_session" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "team_id": "YOUR_TEAM_ID",
  "owner_id": "YOUR_USER_ID",
  "workspace_id": "YOUR_WORKSPACE_ID",
  "sharing_scope": "private",
  "source": "app",
  "mode": "chat",
  "status": "active"
}
JSON

Sostituisci YOUR_* nel corpo prima dell’invio. L’heredoc tra virgolette mantiene il JSON letterale.

Risposta: HTTP 201

AgentSession creato

Campi di risposta

Campo	Tipo	Descrizione
agent_session_id	string
channel_id	string
company_project_id	string
context_snapshot	object
created_at	integer	(timestamp Unix)
deleted_at	integer	(timestamp Unix)
last_message_at	integer	(timestamp Unix)
memory_summary	object
metadata	object
mode	string	Valori consentiti: build, debug, ops, review, chat.
model	string
owner_id	string
provider	string
sharing_scope	string	Valori consentiti: private, team.
source	string	Valori consentiti: app, slack, cli.
status	string	Valori consentiti: active, paused, blocked, complete, failed.
team_id	string
thread_id	string
updated_at	integer	(timestamp Unix)
workspace_id	string
writable_repository_id	string

Esempio illustrativo; non è una risposta dal vivo:

{
  "agent_session_id": "000000000000000000000000001",
  "channel_id": "",
  "company_project_id": "",
  "context_snapshot": {},
  "created_at": 1791072000,
  "deleted_at": 0,
  "last_message_at": 0,
  "memory_summary": {},
  "metadata": {},
  "mode": "chat",
  "model": "",
  "owner_id": "",
  "provider": "",
  "sharing_scope": "private",
  "source": "app",
  "status": "active",
  "team_id": "000000000000000000000000001",
  "thread_id": "",
  "updated_at": 1791072000,
  "workspace_id": "",
  "writable_repository_id": ""
}

Ottieni una sessione dell’agente

GET /v1/agent_session/{id}

Restituisce un oggetto AgentSession

Imposta agent_session_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

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_session/${ADIOS_AGENT_SESSION_ID}" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Risposta: HTTP 200

AgentSession

Campi di risposta

Campo	Tipo	Descrizione
agent_session_id	string
channel_id	string
company_project_id	string
context_snapshot	object
created_at	integer	(timestamp Unix)
deleted_at	integer	(timestamp Unix)
last_message_at	integer	(timestamp Unix)
memory_summary	object
metadata	object
mode	string	Valori consentiti: build, debug, ops, review, chat.
model	string
owner_id	string
provider	string
sharing_scope	string	Valori consentiti: private, team.
source	string	Valori consentiti: app, slack, cli.
status	string	Valori consentiti: active, paused, blocked, complete, failed.
team_id	string
thread_id	string
updated_at	integer	(timestamp Unix)
workspace_id	string
writable_repository_id	string

Esempio illustrativo; non è una risposta dal vivo:

{
  "agent_session_id": "000000000000000000000000001",
  "channel_id": "",
  "company_project_id": "",
  "context_snapshot": {},
  "created_at": 1791072000,
  "deleted_at": 0,
  "last_message_at": 0,
  "memory_summary": {},
  "metadata": {},
  "mode": "chat",
  "model": "",
  "owner_id": "",
  "provider": "",
  "sharing_scope": "private",
  "source": "app",
  "status": "active",
  "team_id": "000000000000000000000000001",
  "thread_id": "",
  "updated_at": 1791072000,
  "workspace_id": "",
  "writable_repository_id": ""
}

Aggiorna una sessione dell’agente

PUT /v1/agent_session/{id}

Aggiorna un oggetto AgentSession esistente

Imposta agent_session_id usando gli ID restituiti dalle tue risposte API.

Questa richiesta modifica dati o avvia un’azione. Controlla la destinazione e il corpo prima dell’invio.

Campi di richiesta (il corpo contiene un esempio modificabile):

Campo	Tipo	Obbligatorio	Descrizione
channel_id	string	No	Valore predefinito: "".
company_project_id	string	No	Valore predefinito: "".
context_snapshot	object	No
last_message_at	integer	No	(timestamp Unix) Valore predefinito: 0.
memory_summary	object	No
metadata	object	No
mode	string	Sì	Valori consentiti: build, debug, ops, review, chat. Valore predefinito: "chat".
model	string	No	Valore predefinito: "".
owner_id	string	No	Valore predefinito: "".
provider	string	No	Valore predefinito: "".
sharing_scope	string	Sì	Valori consentiti: private, team. Valore predefinito: "private".
source	string	Sì	Valori consentiti: app, slack, cli.
status	string	Sì	Valori consentiti: active, paused, blocked, complete, failed. Valore predefinito: "active".
team_id	string	Sì
thread_id	string	No	Valore predefinito: "".
workspace_id	string	No	Valore predefinito: "".
writable_repository_id	string	No	Valore predefinito: "".

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

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 PUT "$ADIOS_API_URL/v1/agent_session/${ADIOS_AGENT_SESSION_ID}" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "team_id": "YOUR_TEAM_ID",
  "owner_id": "YOUR_USER_ID",
  "workspace_id": "YOUR_WORKSPACE_ID",
  "sharing_scope": "private",
  "source": "app",
  "mode": "chat",
  "status": "active"
}
JSON

Sostituisci YOUR_* nel corpo prima dell’invio. L’heredoc tra virgolette mantiene il JSON letterale.

Risposta: HTTP 200

AgentSession aggiornato

Campi di risposta

Campo	Tipo	Descrizione
agent_session_id	string
channel_id	string
company_project_id	string
context_snapshot	object
created_at	integer	(timestamp Unix)
deleted_at	integer	(timestamp Unix)
last_message_at	integer	(timestamp Unix)
memory_summary	object
metadata	object
mode	string	Valori consentiti: build, debug, ops, review, chat.
model	string
owner_id	string
provider	string
sharing_scope	string	Valori consentiti: private, team.
source	string	Valori consentiti: app, slack, cli.
status	string	Valori consentiti: active, paused, blocked, complete, failed.
team_id	string
thread_id	string
updated_at	integer	(timestamp Unix)
workspace_id	string
writable_repository_id	string

Esempio illustrativo; non è una risposta dal vivo:

{
  "agent_session_id": "000000000000000000000000001",
  "channel_id": "",
  "company_project_id": "",
  "context_snapshot": {},
  "created_at": 1791072000,
  "deleted_at": 0,
  "last_message_at": 0,
  "memory_summary": {},
  "metadata": {},
  "mode": "chat",
  "model": "",
  "owner_id": "",
  "provider": "",
  "sharing_scope": "private",
  "source": "app",
  "status": "active",
  "team_id": "000000000000000000000000001",
  "thread_id": "",
  "updated_at": 1791072000,
  "workspace_id": "",
  "writable_repository_id": ""
}

Elimina una sessione dell’agente

DELETE /v1/agent_session/{id}

Elimina un oggetto AgentSession

Imposta agent_session_id usando gli ID restituiti dalle tue risposte API.

Questa richiesta modifica dati o avvia un’azione. Controlla la destinazione e il corpo prima dell’invio.

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

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 DELETE "$ADIOS_API_URL/v1/agent_session/${ADIOS_AGENT_SESSION_ID}" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Risposta: HTTP 200

Risorsa eliminata.

Campi di risposta

Campo	Tipo	Descrizione
message	string

Esempio illustrativo; non è una risposta dal vivo:

{
  "message": "Deleted successfully"
}

Ottieni lo stato della sessione dell’agente

GET /v1/agent_session/{id}/state

Leggi lo stato della sessione.

Imposta agent_session_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

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_session/${ADIOS_AGENT_SESSION_ID}/state" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Risposta: HTTP 200

Risposta riuscita. Controlla lo stato restituito per le operazioni che avviano attività asincrone.

Per questa operazione personalizzata non è pubblicato uno schema completo del corpo della risposta. Controlla il contenuto e lo stato restituiti; qui non si presume alcun formato del payload.

Ottieni il piano della sessione dell’agente

GET /v1/agent_session/{id}/plan

Leggi il piano attuale della sessione.

Imposta agent_session_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

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_session/${ADIOS_AGENT_SESSION_ID}/plan" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Risposta: HTTP 200

Risposta riuscita. Controlla lo stato restituito per le operazioni che avviano attività asincrone.

Per questa operazione personalizzata non è pubblicato uno schema completo del corpo della risposta. Controlla il contenuto e lo stato restituiti; qui non si presume alcun formato del payload.

Annulla l’esecuzione dell’agente

POST /v1/agent_session/{id}/runs/{run_id}/cancel

Richiedi l’annullamento di un’esecuzione attiva nella sessione.

Imposta agent_session_id, agent_run_id usando gli ID restituiti dalle tue risposte API.

Questa richiesta modifica dati o avvia un’azione. Controlla la destinazione e il corpo prima dell’invio.

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.
run_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

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 POST "$ADIOS_API_URL/v1/agent_session/${ADIOS_AGENT_SESSION_ID}/runs/${ADIOS_AGENT_RUN_ID}/cancel" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Risposta: HTTP 200

Risposta riuscita. Controlla lo stato restituito per le operazioni che avviano attività asincrone.

Per questa operazione personalizzata non è pubblicato uno schema completo del corpo della risposta. Controlla il contenuto e lo stato restituiti; qui non si presume alcun formato del payload.