跳转到主要内容
开始创作
开发文档

写入长期记忆

全量替换智能体的长期记忆列表。只更新 long_term_memory 字段,短期摘要、对话历史等其他状态保持不变。传入空数组则清空长期记忆。

全量替换智能体的长期记忆列表。只更新 long_term_memory 字段,短期摘要、对话历史等其他状态保持不变。传入空数组则清空长期记忆。

POST /openapi/v1/agents/set-memory

接口为全量替换语义(Full Replace):传入什么就写入什么,不做合并或去重。请求体 memories 为纯文本数组,服务端写入时自动转为 {text, ts} 格式(ts 为 UTC RFC3339,与 Agent 记忆压缩逻辑一致;文本未变则保留原时间戳,新增或修改的条目使用当前时间)。若需在现有记忆基础上追加,请先通过 agents/get 读取 chatState.long_term_memory,补充新条目后整体传入。memories 最多 30 条。长期记忆会在下次对话时自动注入系统提示词,AI 会自然运用而不主动罗列给用户。

请求参数

参数

类型

请求示例

{
  "agentId": 10,
  "memories": [
    "用户名字叫小明,今年8岁",
    "喜欢恐龙和太空",
    "住在北京"
  ]
}

响应示例

{
  "code": 0,
  "msg": "长期记忆已更新",
  "data": {
    "agentId": 10,
    "count": 3
  }
}