CreateMemoryStore Create a memory store - Tablestore - Centre de documentation Alibaba Cloud

Prérequis

Vous avez créé une instance AgentStorage et celle-ci est à l'état normal. Vous disposez du endpoint et du nom de l'instance.
Vous avez généré une clé API.
Définissez la combinaison des types d'entrée et de sortie avant la création. Le paramètre inputType ne peut pas être modifié après la création.

Paramètres de la requête

Champ

Type

Obligatoire

Description

memoryStoreName

string

Oui

Nom du magasin de mémoire. Il ne peut contenir que des lettres, des chiffres et des traits de soulignement, pour une longueur maximale de 32 caractères.

description

string

Non

Description du magasin de mémoire, limitée à 1024 octets (UTF-8).

extractInstructions

string

Non

Instructions personnalisées pour l'extraction de la mémoire, limitées à 4096 caractères.

inputType

string

Conditionnellement obligatoire

Type d'entrée : messages ou file. Si vous utilisez les nouveaux champs de type, vous devez fournir ce paramètre conjointement avec outputTypes. Il ne peut pas être modifié après la création.

outputTypes

array

Conditionnellement obligatoire

Ensemble des types de sortie, dont les éléments sont structured ou file. Si vous utilisez les nouveaux champs de type, vous devez fournir ce paramètre conjointement avec inputType.

storageMode

string

Non

Champ de compatibilité : ots, file+ots ou filemem. Ne peut pas être utilisé simultanément avec inputType ou outputTypes. Nous recommandons d'utiliser les nouveaux champs de type pour les nouvelles requêtes.

Les combinaisons d'entrée et de sortie prises en charge sont les suivantes.

inputType

outputTypes

Description

messages

["structured"]

Génère une mémoire structurée à partir des messages.

messages

["file"]

Génère des fichiers de mémoire en lecture seule à partir des messages.

messages

["structured", "file"]

Génère à la fois une mémoire structurée et des fichiers de mémoire en lecture seule.

file

["file"]

L'application gère directement les fichiers de mémoire.

Si aucun champ de type n'est spécifié, le système crée par défaut un magasin de mémoire avec une entrée messages et une sortie structured afin d'assurer la compatibilité avec les appels existants.

Exemple de requête

Pour utiliser 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>/CreateMemoryStore \
  -H "x-ots-instancename: <instance-name>" \
  -H "x-ots-apikey: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
  "memoryStoreName": "agent_memory",
  "description": "Agent conversation memory store",
  "extractInstructions": "Focus on the user's dietary preferences and travel habits",
  "inputType": "messages",
  "outputTypes": ["structured", "file"]
}'

Créez un magasin de mémoire dont les fichiers sont gérés directement par l'application :

{
  "memoryStoreName": "agent_files",
  "inputType": "file",
  "outputTypes": ["file"]
}

Réponse

{
  "otsInstance": "your-instance-name",
  "memoryStoreName": "agent_memory",
  "description": "Agent conversation memory store",
  "extractInstructions": "Focus on the user's dietary preferences and travel habits",
  "inputType": "messages",
  "outputTypes": ["structured", "file"],
  "createdAt": "2026-08-31T07:19:48.935Z",
  "updatedAt": "2026-08-31T07:19:48.935Z"
}

Pour un magasin de mémoire créé avec les nouveaux champs de type, la réponse ne renvoie pas le champ storageMode. Lors d'une création avec le champ de compatibilité, la réponse renvoie conjointement les champs normalisés inputType, outputTypes et storageMode.