Tous les produits
Search

Ce produit

    Tablestore:Short-term memory

    Centre de documentation

    Tablestore:Short-term memory

    Dernière mise à jour :Oct 09, 2026

    Gérez les messages à court terme (messages de session bruts) dans le magasin de mémoire. La Mémoire structurée génère ces messages (via AddMemories). Cette rubrique traite uniquement de leur consultation.

    Prérequis

    • Vous avez créé un magasin de mémoire avec le type d'entrée messages. Consultez la rubrique Gestion du magasin de mémoire.

    • Le SDK Agent Storage est installé : Python ≥ 1.0.10 ou TypeScript ≥ 0.0.13

    Lister les messages à court terme

    Consultez les enregistrements de messages de session bruts dans une portée spécifiée, avec prise en charge de la pagination.

    • Le paramètre scope doit inclure les quatre niveaux et ne prend pas en charge les caractères génériques. Sinon, aucune session correspondante n'est trouvée.

    • Si le magasin de mémoire existe mais qu'aucun message n'est présent pour la portée indiquée, le système renvoie un code d'état 200 et une liste messages vide. Il ne s'agit pas d'une erreur.

    • Les paramètres optionnels minTimestamp et maxTimestamp (format RFC3339) filtrent par plage horaire. Le paramètre limit définit la taille de la page, tandis que nextToken gère la pagination.

    Console

    1. Connectez-vous à la console Agent Storage, ouvrez le magasin de mémoire cible et accédez à la page Short-term memory.

    2. Sélectionnez l'application, tenant, and Agent spécifiques, puis utilisez le session selector situé dans le coin supérieur droit pour choisir une session.

    3. La liste affiche les messages de conversation bruts de la session (rôle, contenu et horodatage).

    SDK

    Python

    from tablestore_agent_storage import AgentStorageClient

client = AgentStorageClient(
    api_key="<your-api-key>",
    ots_endpoint="https://<instance>.<region>.ots.aliyuncs.com",
    ots_instance_name="<instance-name>",
)

resp = client.list_memory_store_messages({
    "memoryStoreName": "agent_memory",
    "scope": {
        "appId": "app-001",
        "tenantId": "user-001",
        "agentId": "assistant",
        "runId": "session-001",
    },
    "limit": 50,
})

session = resp.get("session", resp)
for msg in session.get("messages", []):
    print(f"[{msg['role']}] {msg['content']}")

    TypeScript

    import { AgentStorageClient } from '@tablestore/agent-storage';

const client = new AgentStorageClient({
  apiKey: '<your-api-key>',
  endpoint: 'https://<instance>.<region>.ots.aliyuncs.com',
  instanceName: '<instance-name>',
});

const resp = await client.listMemoryStoreMessages({
  memoryStoreName: 'agent_memory',
  scope: {
    appId: 'app-001',
    tenantId: 'user-001',
    agentId: 'assistant',
    runId: 'session-001',
  },
  limit: 50,
});

const session = resp.session ?? resp;
for (const msg of session.messages) {
  console.log(`[${msg.role}] ${msg.content}`);
}

    API

    Appelez l'opération ListMemoryStoreMessages pour lister les messages à court terme. Pour une description complète des champs, consultez la rubrique Lister les messages à court terme.

    Documentation connexe