写入长期记忆
全量替换智能体的长期记忆列表。只更新 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
}
}