Ir al contenido
AdiosDocumentación
Explorar la documentación

API de mensajes de agentes

Lee los registros de conversaciones autorizados. Mantén fuera de los ejemplos publicados las respuestas que contengan código o conversaciones privadas.

Usa Autenticación de la API para las solicitudes protegidas. Los ejemplos usan tus propios IDs de recursos y un token temporal; las respuestas de ejemplo guardadas son sintéticas.

MétodoRutaOperación
GET/v1/agent_messageListar mensajes del agente
GET/v1/agent_message/{id}Obtener mensaje del agente

Listar mensajes del agente

GET /v1/agent_message

Devuelve una lista paginada de AgentMessage

Autenticación: token bearer y la cabecera de equipo que se muestra a continuación.

Parámetros

NombreUbicaciónObligatorioDescripción
X-Tenant-IDcabecerasíID del equipo activo. Debe coincidir con el tenant vinculado al token de diagnóstico.
pageconsultanoNúmero de página
per_pageconsultanoElementos por página

Ejemplo de solicitud

Configura ADIOS_API_URL=https://api.adios.dev. Para las solicitudes protegidas, configura ADIOS_ACCESS_TOKEN y ADIOS_TEAM_ID como en el inicio rápido. Configura las variables adicionales ADIOS_* a partir de los resultados de tus propios recursos.

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"

Respuesta: HTTP 200

Lista de AgentMessage

Campos de respuesta

CampoTipoDescripción
dataarray
data[].agent_message_idstring
data[].agent_session_idstring
data[].contentobject
data[].content_jsonobject
data[].created_atinteger(marca de tiempo Unix)
data[].deleted_atinteger(marca de tiempo Unix)
data[].metadataobject
data[].rolestringValores permitidos: system, user, assistant, tool.
data[].sequenceinteger
data[].team_idstring
data[].token_countinteger
data[].tool_call_idobject
data[].tool_namestring
data[].updated_atinteger(marca de tiempo Unix)
paginationobject
pagination.pageintegerNúmero de página actual
pagination.per_pageintegerNúmero de elementos por página
pagination.totalintegerNúmero total de elementos

Ejemplo ilustrativo; no es una respuesta real:

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

Obtener mensaje del agente

GET /v1/agent_message/{id}

Devuelve un único AgentMessage

Configura agent_message_id usando IDs de tus propias respuestas de la API.

Autenticación: token bearer y la cabecera de equipo que se muestra a continuación.

Parámetros

NombreUbicaciónObligatorioDescripción
idrutasíIdentificador del recurso obtenido de los resultados de la API de tu equipo.
X-Tenant-IDcabecerasíID del equipo activo. Debe coincidir con el tenant vinculado al token de diagnóstico.

Ejemplo de solicitud

Configura ADIOS_API_URL=https://api.adios.dev. Para las solicitudes protegidas, configura ADIOS_ACCESS_TOKEN y ADIOS_TEAM_ID como en el inicio rápido. Configura las variables adicionales ADIOS_* a partir de los resultados de tus propios recursos.

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

Respuesta: HTTP 200

AgentMessage

Campos de respuesta

CampoTipoDescripción
agent_message_idstring
agent_session_idstring
contentobject
content_jsonobject
created_atinteger(marca de tiempo Unix)
deleted_atinteger(marca de tiempo Unix)
metadataobject
rolestringValores permitidos: system, user, assistant, tool.
sequenceinteger
team_idstring
token_countinteger
tool_call_idobject
tool_namestring
updated_atinteger(marca de tiempo Unix)

Ejemplo ilustrativo; no es una respuesta real:

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