GetMemory Query memory - Tablestore - Centre de documentation Alibaba Cloud

Prérequis

Vous avez créé une instance AgentStorage dont le statut est normal, et vous disposez du endpoint et du nom de l'instance.
Vous avez créé une API Key.
Règles de portée : le champ scope est facultatif. S'il est renseigné, les quatre champs (appId, tenantId, agentId, runId) sont obligatoires et le caractère générique * n'est pas autorisé.

Paramètres de la requête

Champ

Type

Obligatoire

Description

memoryStoreName

string

Oui

Nom du magasin de mémoire.

memoryId

string

Oui

ID de la mémoire.

scope

object

Non

Facultatif. Portée complète utilisée pour vérifier la propriété de la mémoire. Si ce champ est fourni, les quatre sous-champs sont requis et le caractère générique * n'est pas autorisé.

Exemple de requête

Pour l'authentification par API Key, 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>/GetMemory \
  -H "x-ots-instancename: <instance-name>" \
  -H "x-ots-apikey: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{"memoryStoreName":"agent_memory","memoryId":"<memory-id>","scope":{"appId":"app-001","tenantId":"user-001","agentId":"assistant","runId":"session-001"}}'

Réponse

Champ

Description

memoryStoreName

Nom du magasin de mémoire.

memory

Unité de mémoire à long terme récupérée. La définition des champs est identique à celle de results[].unit dans la réponse SearchMemories (notation snake_case ; le vecteur d'embedding n'est pas renvoyé).

{
  "memoryStoreName": "agent_memory",
  "memory": {
    "id": "1b88d0d65a5b6c0d9142e9b7c7347048",
    "conversation_key": "app-001/user-001/assistant/session-001",
    "scope": { "appId": "app-001", "tenantId": "user-001", "agentId": "assistant", "runId": "session-001" },
    "unit_type": "entity_fact",
    "text": "[2026-08-25T05:52:19Z] I only use Python for scripting.",
    "keywords": ["Python", "scripting", "programming language", "preference"],
    "title": "User programming language preference",
    "version": 1,
    "salience": 0.8,
    "effective_at": "2026-08-25T05:52:19Z",
    "time_precision": "second",
    "created_at": "2026-08-25T05:52:19.185Z",
    "updated_at": "2026-08-25T05:52:30.509Z"
  }
}