API dei messaggi degli agenti

Leggi i dati delle conversazioni autorizzate. Non includere negli esempi pubblicati risposte contenenti codice privato o conversazioni.

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_message`	Elenca i messaggi degli agenti
`GET`	`/v1/agent_message/{id}`	Ricevi il messaggio dell'agente

Elenca i messaggi degli agenti

GET /v1/agent_message

Restituisce un elenco paginato di AgentMessage

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

Risposta: HTTP 200

Elenco di AgentMessage

Campi di risposta

Campo	Tipo	Descrizione
`data`	array
`data[].agent_message_id`	string
`data[].agent_session_id`	string
`data[].content`	object
`data[].content_json`	object
`data[].created_at`	integer	(timestamp Unix)
`data[].deleted_at`	integer	(timestamp Unix)
`data[].metadata`	object
`data[].role`	string	Valori consentiti: system, user, assistant, tool.
`data[].sequence`	integer
`data[].team_id`	string
`data[].token_count`	integer
`data[].tool_call_id`	object
`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

Esempio illustrativo; non è una risposta dal vivo:

{
  "data": [
    {
      "agent_message_id": "000000000000000000000000001",
      "agent_session_id": "000000000000000000000000001",
      "content": "",
      "content_json": {},
      "created_at": 1791072000,
      "deleted_at": 0,
      "metadata": {},
      "role": "system",
      "sequence": 0,
      "team_id": "000000000000000000000000001",
      "token_count": 0,
      "tool_call_id": "",
      "tool_name": "",
      "updated_at": 1791072000
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 1,
    "total": 1
  }
}

Ricevi il messaggio dell'agente

GET /v1/agent_message/{id}

Restituisce un oggetto AgentMessage

Imposta agent_message_id usando gli ID restituiti dalle tue risposte API.