ListMemoryStoreMessages List short-term messages - Tablestore

Prérequis

Vous avez créé une instance AgentStorage et celle-ci est dans l'état normal. Récupérez le point de terminaison et le nom de l'instance.
Vous avez généré une clé API.
Règle de portée : l'interrogation de la mémoire à court terme nécessite une portée (Scope) complète. Les quatre champs (appId, tenantId, agentId, runId) sont obligatoires ; les caractères génériques (*) ne sont pas autorisés.

Paramètres de la requête

Champ

Type

Obligatoire

Description

memoryStoreName

string

Oui

Nom du magasin de mémoire.

scope

object

Oui

Portée (Scope) complète. Les quatre champs sont requis ; les caractères génériques (*) sont interdits.

limit

int

Non

Nombre de résultats à renvoyer.

nextToken

string

Non

Jeton de pagination pour la page suivante.

minTimestamp

string

Non

Horodatage minimal au format RFC3339.

maxTimestamp

string

Non

Horodatage maximal au format RFC3339.

Exemple de requête

Pour l'authentification par clé API, transmettez le nom de l'instance et la clé API via les en-têtes de requête x-ots-instancename et x-ots-apikey.

curl -X POST https://<endpoint>/ListMemoryStoreMessages \
  -H "x-ots-instancename: <instance-name>" \
  -H "x-ots-apikey: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
  "memoryStoreName": "agent_memory",
  "scope": {
    "appId": "app-001",
    "tenantId": "user-001",
    "agentId": "assistant",
    "runId": "session-001"
  },
  "limit": 100
}'

Réponse

Champ

Description

session

Objet conteneur du message de session.

session.scope

Portée (Scope) interrogée.

session.messages

Liste des messages.

session.messages[].messageId

ID du message.

session.messages[].role

Rôle du message.

session.messages[].speaker

Identifiant de l'interlocuteur.

session.messages[].content

Contenu du message.

session.messages[].timestamp

Horodatage du message au format RFC3339.

session.messages[].metadata

Métadonnées du message.

{
  "session": {
    "scope": { "appId": "app-001", "tenantId": "user-001", "agentId": "assistant", "runId": "session-001" },
    "messages": [
      {
        "messageId": "d0d9dd778a27e8cde773a243a5bab13c",
        "role": "user",
        "speaker": "user",
        "content": "[10:00 AM on 13 May, 2026] For future business trips, I will prioritize booking window seats",
        "timestamp": "2026-05-13T10:00:00Z",
        "metadata": { "channel": "chat", "source": "chat" }
      }
    ]
  }
}

Si le magasin de mémoire existe mais qu'aucun message n'est trouvé pour la portée (Scope) spécifiée, le code 200 est renvoyé avec une liste messages vide.