Aller au contenu
AdiosDocumentation
Parcourir la documentation

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éthodeCheminOpération
GET/v1/agent_messageLister 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

NomEmplacementRequisDescription
X-Tenant-IDen-têteouiID de l’équipe active. Doit correspondre au tenant lié au jeton de diagnostic.
pagerequêtenonNuméro de page
per_pagerequêtenonÉ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

ChampTypeDescription
datatableau
data[].agent_message_idchaîne
data[].agent_session_idchaîne
data[].contentobjet
data[].content_jsonobjet
data[].created_atentier(horodatage Unix)
data[].deleted_atentier(horodatage Unix)
data[].metadataobjet
data[].rolechaîneValeurs autorisées : system, user, assistant, tool.
data[].sequenceentier
data[].team_idchaîne
data[].token_countentier
data[].tool_call_idobjet
data[].tool_namechaîne
data[].updated_atentier(horodatage Unix)
paginationobjet
pagination.pageentierNuméro de page actuel
pagination.per_pageentierNombre d’éléments par page
pagination.totalentierNombre 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

NomEmplacementRequisDescription
idcheminouiIdentifiant de ressource issu des résultats API de votre équipe.
X-Tenant-IDen-têteouiID 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

ChampTypeDescription
agent_message_idchaîne
agent_session_idchaîne
contentobjet
content_jsonobjet
created_atentier(horodatage Unix)
deleted_atentier(horodatage Unix)
metadataobjet
rolechaîneValeurs autorisées : system, user, assistant, tool.
sequenceentier
team_idchaîne
token_countentier
tool_call_idobjet
tool_namechaîne
updated_atentier(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
}