工具记忆
memory_add
显式保存一条记忆。
显式保存一条记忆。内容必填;kind 和 tags 由调用方定义,可选。不做自动摘要或分类。
以上是服务端发布的英文描述的译文;英文原文见英文页。工具名、参数名和取值保持原样。
| 字段 | 值 |
|---|---|
| 工具包 | Core (core) |
| 每次调用的预估成本 | $0 |
| 工具包每月上限 | 无 |
| 项目 | 按顺序确定:显式的 project → 请求头 → 凭据默认项目 → 工作区默认项目 |
参数
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
content | 是 | string | 记忆文本,最多 4096 字节,例如 'Reddit r/SaaS ignores self-promo; reply with help first.' |
kind | 否 | string | null | 你自己定义的可选分类,例如 'insight'、'decision'、'customer'。 |
tags | 否 | string[] | 用于过滤的可选标签,例如 ['reddit', 'pricing']。默认没有。 |
project | 否 | string | 项目 slug 或 id。省略则用凭据或工作区的默认项目。 |
示例调用
{
"content": "Reddit r/SaaS ignores self-promo; reply with help first.",
"kind": "insight",
"tags": [
"reddit",
"rules"
]
}REST:POST https://service.opennomos.com/v1/tools/memory_add,以上 JSON 作为请求体。MCP:tools/call,name: "memory_add",以上 JSON 作为 arguments。
示例结果
示例里的值是示意性的;结构来自服务端代码。
{
"project": {
"id": "prj_k3Vd9aQx2",
"slug": "acme-crm"
},
"memory": {
"id": "mem_Zr81nQw3",
"kind": "insight",
"content": "Reddit r/SaaS ignores self-promo; reply with help first.",
"tags": [
"reddit",
"rules"
],
"source": "Claude Code",
"created_at": "2026-10-16T09:00:00.000Z",
"updated_at": "2026-10-16T09:00:00.000Z"
}
}说明
- 记忆是显式的:不调用它就什么都不会保存。没有自动摘要、分类或置信度,
kind也没有固定的取值列表。 - 内容上限 4096 字节(UTF-8,所以大约 1,300 个汉字)。长清单请拆成多条,或者把人和帖子作为机会来登记。
- 写入按工作区限流(每分钟 60 次,按服务实例计)。
错误
被拒绝的调用(输入有误、id 未知、触发限流)返回 message 和 code;走 MCP 时结果带 isError: true。见错误。