# memory_forget

> 按 id 忘掉一条记忆。

URL: https://mcp-docs.opennomos.com/zh/docs/tools/memory/memory_forget

> 按 id 忘掉一条记忆。被移除的条目会立刻从读取和搜索结果中消失。

> 以上是服务端发布的英文描述的译文；英文原文见[英文页](https://mcp-docs.opennomos.com/docs/tools/memory/memory_forget.md)。工具名、参数名和取值保持原样。

| 字段 | 值 |
| --- | --- |
| 工具包 | Core (`core`) |
| 每次调用的预估成本 | $0 |
| 工具包每月上限 | 无 |
| 项目 | 按顺序确定：显式的 `project` → 请求头 → 凭据默认项目 → 工作区默认项目 |

## 参数

| 参数 | 必填 | 类型 | 说明 |
| --- | --- | --- | --- |
| `id` | 是 | `string` | 来自 memory_add 或 memory_search 的记忆 id。 |

## 示例调用

```json
{
  "id": "mem_Zr81nQw3"
}
```

REST:`POST https://service.opennomos.com/v1/tools/memory_forget`，以上 JSON 作为请求体。MCP:`tools/call`,`name: "memory_forget"`，以上 JSON 作为 `arguments`。

## 示例结果

示例里的值是示意性的；结构来自服务端代码。

```json
{
  "project": {
    "id": "prj_k3Vd9aQx2",
    "slug": "acme-crm"
  },
  "memory_id": "mem_Zr81nQw3",
  "forgotten": true
}
```

## 说明

- 记忆会立刻从读取和搜索中消失，30 天后清除（每日任务）。

## 错误

被拒绝的调用（输入有误、id 未知、触发限流）返回 `message` 和 `code`；走 MCP 时结果带 `isError: true`。见[错误](https://mcp-docs.opennomos.com/zh/docs/reference/errors.md)。