Tablestore:Memory Dream

Console

Étape 1 : Créer une tâche de consolidation

1. Connectez-vous au magasin de mémoire et, dans le volet de navigation de gauche, sélectionnez Agentic Task > Memory Dream.

2. Dans le coin supérieur droit, cliquez sur Create Task et configurez les paramètres suivants dans la boîte de dialogue :

   Élément de formulaire	Description	Paramètre correspondant
   Type de tâche	Sélectionnez Memory consolidation.	taskType=memory
   Portée d'entrée	Portée à consolider. Vous pouvez utiliser le caractère générique * pour couvrir plusieurs niveaux.	scopes
   Profondeur de traitement	Standard (une seule analyse bornée) ou High-effort (plusieurs cycles d'analyse).	effort=low / high
   Mode d'application	Générer uniquement des suggestions (recommandé ; appliquer après confirmation manuelle).	applyMode=proposal
   Mode de portée de sortie	Conserver la portée d'origine ou Promouvoir la portée.	scopeOutputMode=preserve_scope / promote_scope
   Instructions de consolidation	Facultatif. Exigences de consolidation personnalisées.	instructions

3. Après soumission, la tâche s'exécute de manière asynchrone et génère un ID de tâche (dreamId). L'état commence à évoluer depuis queued.

   Lorsque vous sélectionnez High-effort pour la profondeur de traitement, le mode d'application doit être safe_auto ou plan (contrainte liée à effort=high ).

Étape 2 : Examiner la tâche et les suggestions

1. Dans la liste des tâches Memory Dream, attendez que l'état de la tâche cible devienne Completed (completed). Cliquez sur Refresh pour mettre à jour l'état.

2. Cliquez sur la tâche pour ouvrir ses détails et afficher la action list produite. Chaque action contient le type d'action (ADD / UPDATE / DELETE / MERGE / NOOP), la mémoire cible, le nouveau contenu consolidé, la raison (reason), la confiance (confidence) et l'état.

3. En mode proposal, toutes les actions sont initialement à l'état To be applied (proposed) et ne modifient pas le magasin de mémoire tant qu'elles ne sont pas appliquées.

Étape 3 : Appliquer les actions et vérifier

1. Dans les détails de la tâche, sélectionnez les actions à appliquer (NOOP signifie qu'aucune modification n'est nécessaire et peut rester non sélectionné).

2. Cliquez sur Apply. Le service met à jour la mémoire à long terme selon les actions sélectionnées. Les actions DELETE sont irréversibles après suppression.

3. En mode plan, vous devez d'abord approuver la liste d'autorisation de suppression dans le plan avant l'exécution.

4. Après application, relisez la liste des mémoires sous Memory data management > Long-term memory pour confirmer que les résultats de consolidation répondent aux attentes.

SDK

Appelez les quatre interfaces dans l'ordre : créer la tâche, interroger l'état, examiner les propositions d'action et appliquer les actions.

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>",
)

# 1. Create the consolidation task
resp = client.create_memory_dream_task({
    "memoryStoreName": "agent_memory",
    "scopes": [{"appId": "app-001", "tenantId": "user-001", "agentId": "assistant", "runId": "session-001"}],
    "taskType": "memory",
    "effort": "low",
    "applyMode": "proposal",
    "instructions": "Merge duplicate memories and delete outdated items",
    "clientToken": "dream-001",
})
dream_id = resp.get("dreamId")

# 2. Poll the task status until it reaches a terminal state
task = client.get_memory_dream_task({
    "memoryStoreName": "agent_memory",
    "dreamId": dream_id,
})
print(f"status: {task.get('status')}, actions: {task.get('actions')}")

# 3. Review action proposals
actions = client.list_memory_dream_actions({
    "memoryStoreName": "agent_memory",
    "dreamId": dream_id,
    "limit": 100,
}).get("actions", [])

# 4. Apply the selected actions (skip NOOP)
client.apply_memory_dream_actions({
    "memoryStoreName": "agent_memory",
    "dreamId": dream_id,
    "mode": "actions",
    "actionIds": [a["actionId"] for a in actions if a["action"] != "NOOP"],
    "applier": "operator-001",
})

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

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

// 1. Create the consolidation task
const created = await client.createMemoryDreamTask({
  memoryStoreName: 'agent_memory',
  scopes: [{ appId: 'app-001', tenantId: 'user-001', agentId: 'assistant', runId: 'session-001' }],
  taskType: 'memory',
  effort: 'low',
  applyMode: 'proposal',
  instructions: 'Merge duplicate memories and delete outdated items',
  clientToken: 'dream-001',
});
const dreamId = created.dreamId;

// 2. Poll the task status until it reaches a terminal state
const task = await client.getMemoryDreamTask({
  memoryStoreName: 'agent_memory',
  dreamId,
});
console.log(task.status, task.actions);

// 3. Review action proposals
const { actions } = await client.listMemoryDreamActions({
  memoryStoreName: 'agent_memory',
  dreamId,
  limit: 100,
});

// 4. Apply the selected actions (skip NOOP)
await client.applyMemoryDreamActions({
  memoryStoreName: 'agent_memory',
  dreamId,
  mode: 'actions',
  actionIds: actions.filter((a) => a.action !== 'NOOP').map((a) => a.actionId),
  applier: 'operator-001',
});