CreateMemoryStore Crie um armazenamento de memória - Tablestore: Central de Documentação do Alibaba Cloud

Pré-requisitos

Uma instância do AgentStorage criada e no estado normal, com o endpoint e o nome da instância disponíveis.
Uma API Key criada.
Planeje a combinação do tipo de entrada com os tipos de saída do armazenamento de memória antes da criação. O parâmetro inputType não pode ser modificado após a criação do armazenamento de memória.

Parâmetros da solicitação

Campo	Tipo	Obrigatório	Descrição
`memoryStoreName`	string	Sim	Nome do armazenamento de memória. Aceita apenas letras, dígitos e sublinhados, com até 32 caracteres.
`description`	string	Não	Descrição do armazenamento de memória, limitada a 1024 bytes (UTF-8).
`extractInstructions`	string	Não	Instruções personalizadas para extração de memória, limitadas a 4096 caracteres.
`inputType`	string	Condicionalmente obrigatório	Tipo de entrada. Valores válidos: `messages` ou `file`. Ao usar os novos campos de tipo, especifique este parâmetro junto com `outputTypes`. Este parâmetro não pode ser modificado após a criação do armazenamento de memória.
`outputTypes`	array	Condicionalmente obrigatório	Conjunto de tipos de saída. Cada elemento deve ser `structured` ou `file`. Ao usar os novos campos de tipo, especifique este parâmetro junto com `inputType`.
`storageMode`	string	Não	Campo de compatibilidade. Valores válidos: `ots`, `file+ots` ou `filemem`. Não é possível especificar este parâmetro junto com `inputType` ou `outputTypes`. Para novas solicitações, use os novos campos de tipo.

As combinações de tipos de entrada e saída a seguir são compatíveis.

inputType	outputTypes	Descrição
`messages`	`["structured"]`	Gera memória estruturada a partir de mensagens.
`messages`	`["file"]`	Gera arquivos de memória somente leitura a partir de mensagens.
`messages`	`["structured", "file"]`	Produz simultaneamente memória estruturada e arquivos de memória somente leitura.
`file`	`["file"]`	A aplicação gerencia diretamente os arquivos de memória.

Se nenhum campo de tipo for especificado, o sistema cria por padrão um armazenamento de memória com o tipo de entrada messages e o tipo de saída structured, garantindo compatibilidade com chamadas existentes.

Exemplo de solicitação

Ao usar autenticação por API Key, especifique o nome da instância e a API Key nos cabeçalhos de solicitação x-ots-instancename e 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 user dietary preferences and travel habits",
  "inputType": "messages",
  "outputTypes": ["structured", "file"]
}'

Para criar um armazenamento de memória cujos arquivos a aplicação gerencia diretamente:

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

Resposta

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

Para um armazenamento de memória criado com os novos campos de tipo, a resposta não retorna storageMode. Já para um armazenamento criado com o campo de compatibilidade, a resposta inclui os valores normalizados de inputType, outputTypes e storageMode.