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étodo | Ruta | Operación |
|---|---|---|
GET | /v1/agent_message | Listar 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
| Nombre | Ubicación | Obligatorio | Descripción |
|---|---|---|---|
X-Tenant-ID | cabecera | sí | ID del equipo activo. Debe coincidir con el tenant vinculado al token de diagnóstico. |
page | consulta | no | Número de página |
per_page | consulta | no | Elementos 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
| Campo | Tipo | Descripción |
|---|---|---|
data | array | |
data[].agent_message_id | string | |
data[].agent_session_id | string | |
data[].content | object | |
data[].content_json | object | |
data[].created_at | integer | (marca de tiempo Unix) |
data[].deleted_at | integer | (marca de tiempo Unix) |
data[].metadata | object | |
data[].role | string | Valores permitidos: 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 | (marca de tiempo Unix) |
pagination | object | |
pagination.page | integer | Número de página actual |
pagination.per_page | integer | Número de elementos por página |
pagination.total | integer | Nú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
| Nombre | Ubicación | Obligatorio | Descripción |
|---|---|---|---|
id | ruta | sí | Identificador del recurso obtenido de los resultados de la API de tu equipo. |
X-Tenant-ID | cabecera | sí | 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
| Campo | Tipo | Descripción |
|---|---|---|
agent_message_id | string | |
agent_session_id | string | |
content | object | |
content_json | object | |
created_at | integer | (marca de tiempo Unix) |
deleted_at | integer | (marca de tiempo Unix) |
metadata | object | |
role | string | Valores permitidos: system, user, assistant, tool. |
sequence | integer | |
team_id | string | |
token_count | integer | |
tool_call_id | object | |
tool_name | string | |
updated_at | integer | (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
}