API des messages d’agent
Lisez les conversations auxquelles vous avez accès. Ne publiez pas d’exemples de réponses contenant du code ou des conversations privés.
Utiliser Authentification API pour les requêtes protégées. Les exemples utilisent vos propres ID de ressources et un jeton temporaire ; les exemples de réponses enregistrés sont synthétiques.
| Méthode | Chemin | Opération |
|---|---|---|
GET | /v1/agent_message | Lister les messages d’agent |
GET | /v1/agent_message/{id} | Obtenir un message d’agent |
Lister les messages d’agent
GET /v1/agent_message
Renvoie une liste paginée d’AgentMessage
Authentification : jeton bearer et en-tête d’équipe présentés ci-dessous.
Paramètres
| Nom | Emplacement | Requis | Description |
|---|---|---|---|
X-Tenant-ID | en-tête | oui | ID de l’équipe active. Doit correspondre au tenant lié au jeton de diagnostic. |
page | requête | non | Numéro de page |
per_page | requête | non | Éléments par page |
Exemple de requête
Définissez ADIOS_API_URL=https://api.adios.dev. Pour les requêtes protégées, définissez ADIOS_ACCESS_TOKEN et ADIOS_TEAM_ID comme dans le démarrage rapide. Définissez les autres variables ADIOS_* à partir des résultats de vos propres ressources.
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"
Réponse : HTTP 200
Liste d’AgentMessage
Champs de réponse
| Champ | Type | Description |
|---|---|---|
data | tableau | |
data[].agent_message_id | chaîne | |
data[].agent_session_id | chaîne | |
data[].content | objet | |
data[].content_json | objet | |
data[].created_at | entier | (horodatage Unix) |
data[].deleted_at | entier | (horodatage Unix) |
data[].metadata | objet | |
data[].role | chaîne | Valeurs autorisées : system, user, assistant, tool. |
data[].sequence | entier | |
data[].team_id | chaîne | |
data[].token_count | entier | |
data[].tool_call_id | objet | |
data[].tool_name | chaîne | |
data[].updated_at | entier | (horodatage Unix) |
pagination | objet | |
pagination.page | entier | Numéro de page actuel |
pagination.per_page | entier | Nombre d’éléments par page |
pagination.total | entier | Nombre total d’éléments |
Exemple illustratif ; il ne s’agit pas d’une réponse réelle :
{
"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
}
}
Obtenir un message d’agent
GET /v1/agent_message/{id}
Renvoie un seul AgentMessage
Définissez agent_message_id en utilisant les ID de vos propres réponses API.
Authentification : jeton bearer et en-tête d’équipe présentés ci-dessous.
Paramètres
| Nom | Emplacement | Requis | Description |
|---|---|---|---|
id | chemin | oui | Identifiant de ressource issu des résultats API de votre équipe. |
X-Tenant-ID | en-tête | oui | ID de l’équipe active. Doit correspondre au tenant lié au jeton de diagnostic. |
Exemple de requête
Définissez ADIOS_API_URL=https://api.adios.dev. Pour les requêtes protégées, définissez ADIOS_ACCESS_TOKEN et ADIOS_TEAM_ID comme dans le démarrage rapide. Définissez les autres variables ADIOS_* à partir des résultats de vos propres ressources.
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"
Réponse : HTTP 200
AgentMessage
Champs de réponse
| Champ | Type | Description |
|---|---|---|
agent_message_id | chaîne | |
agent_session_id | chaîne | |
content | objet | |
content_json | objet | |
created_at | entier | (horodatage Unix) |
deleted_at | entier | (horodatage Unix) |
metadata | objet | |
role | chaîne | Valeurs autorisées : system, user, assistant, tool. |
sequence | entier | |
team_id | chaîne | |
token_count | entier | |
tool_call_id | objet | |
tool_name | chaîne | |
updated_at | entier | (horodatage Unix) |
Exemple illustratif ; il ne s’agit pas d’une réponse réelle :
{
"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
}