Tablestore:Short-term memory

Prerequisites

• A memory store with the input type messages has been created. See Memory store management.

• Agent Storage SDK installed: Python ≥ 1.0.10, TypeScript ≥ 0.0.13

List short-term messages

Query raw session message records under a specified scope with pagination.

• The scope must include all four levels and does not support wildcards. Otherwise, no matching session can be found.

• If the memory store exists but no messages exist for the scope, a 200 status and an empty messages list are returned. This does not indicate an error.

• Optional minTimestamp/maxTimestamp (RFC3339) filter by time range, limit controls the page size, and nextToken is used for pagination.

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']}")

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}`);
}

Related documents

• Structured memory

• Memory store management