Memories API

创建记忆

POST /memories
X-API-Key: msk_xxx
Content-Type: application/json

{
  "user_id": "user_123",
  "infer": true,
  "messages": [
    {"role": "user", "content": "我喜欢中文回复"}
  ],
  "metadata": {
    "project": "demo",
    "source": "chat"
  }
}

curl -X POST https://api.memaster.cn/memories \
  -H "X-API-Key: msk_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "user_123",
    "infer": true,
    "messages": [{"role":"user","content":"我喜欢中文回复"}],
    "metadata": {"project":"demo"}
  }'

列出记忆

GET /memories?user_id=user_123
X-API-Key: msk_xxx

当前列表接口会按实体过滤返回可见记忆，服务端默认最多返回 1000 条。

更新记忆

PUT /memories/{memory_id}
X-API-Key: msk_xxx
Content-Type: application/json

{
  "text": "用户偏好中文回复，并关注 AI 记忆产品。",
  "metadata": {
    "tags": ["偏好", "语言"]
  }
}

删除记忆

DELETE /memories/{memory_id}
X-API-Key: msk_xxx

字段说明

字段	说明
`user_id`	终端用户 ID
`agent_id`	Agent 或应用 ID
`run_id`	会话或任务 ID
`messages`	对话消息数组
`text`	直接写入的文本内容
`metadata`	自定义结构化元数据
`infer`	可选。设为 `true` 时，服务端会先用 LLM 抽取稳定记忆、去重后再写入；未设置时按原始消息写入。

本地接口测试 Search