DeleteMemory Delete memory - Tablestore - Centre de documentation Alibaba Cloud

Prérequis

Vous avez créé une instance AgentStorage dont l'état est normal, et vous avez récupéré le nom de l'instance ainsi que son endpoint.
Vous avez créé une clé API.
Règle de portée : le paramètre scope est facultatif. S'il est renseigné, les quatre champs (appId, tenantId, agentId et runId) deviennent obligatoires et l'utilisation du caractère générique * est interdite.

Paramètres de la requête

Champ

Type

Obligatoire

Description

memoryStoreName

string

Oui

Nom du magasin de mémoires.

memoryId

string

Oui

ID de la mémoire.

scope

object

Non

Portée complète facultative utilisée pour vérifier la propriété de la mémoire. Si ce paramètre est renseigné, les quatre champs sont obligatoires et le caractère générique * est interdit.

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>/DeleteMemory \
  -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

deleted

Indique si la suppression a réussi.

memoryId

ID de la mémoire supprimée.

memoryStoreName

Nom du magasin de mémoires.

{
  "deleted": true,
  "memoryId": "1b88d0d65a5b6c0d9142e9b7c7347048",
  "memoryStoreName": "agent_memory"
}