接入方式总览
更新时间：2026-05-27
您可以根据 Agent 类型、技术栈和业务控制要求，选择更合适的接入方式。三种接入方式的主要区别在于：记忆调用由谁触发、是否需要写代码、是否可以跨客户端复用。
方式对比
| 接入方式 | 接入体验 | 是否替代原生记忆 | 适合场景 | 典型对象 | 详细文档 |
|---|---|---|---|---|---|
| REST API | 任何语言都可以直接通过 HTTP 调用 | 不会 | 最通用、最透明，便于后端服务接入 | Java、PHP、Ruby、Shell、低代码平台、自研系统 | API 接入 |
| MCP | 将记忆能力注册为标准工具，由 Agent 自主调用 | 不会 | 希望一个服务兼容多个 MCP 客户端 | Cursor、Windsurf、Claude Desktop、VS Code、Claude Code | MCP 接入 |
| Skill | 通过指令文件教 Agent 何时使用 CLI 或 API | 不会 | 编程 Agent 可执行命令，需要精细控制调用时机 | Claude Code、OpenCode、Codex CLI、自建 coding agent | Skill 接入 |
推荐选择
| 使用需求 | 推荐方式 |
|---|---|
| 只想快速给现有 Agent 增加记忆能力 | 优先选择 MCP |
| 需要跨多个工具复用同一套记忆服务 | 优先选择 MCP |
| 需要在业务流程中精确控制写入和检索 | 选择 REST API |
| 需要自定义 Agent 的记忆调用行为和触发规则 | 选择 Skill |
多租户建议： 需要多 Agent 团队共享记忆时，使用同一个 Bank 并用 tags 区分用户、项目或 Agent；需要严格用户隔离时，每个用户一个 Bank，或强制使用
user:xxx标签和all_strict匹配。
信息填写
| 信息 | 填写位置 | 注意事项 |
|---|---|---|
| API Base URL | MCP 配置的 URL、Skill 模板或 REST 请求 base URL | https://cloud.memory.bj.baidubce.com/api，注意：已包含 /api，不要再额外拼接 /api，接口路径直接在它后面拼接。 |
| API Key | 认证字段或 Authorization 请求头 |
只放在安全配置中，不写入文档、截图、前端代码或公开仓库 |
| Bank ID | MCP 的 URL 路径（单库模式）、Skill 模板或请求体 bank_id |
按用户、项目或团队规划，避免多个无关租户混用 |
| Tags | Retain、Recall、Reflect 参数 | 用于范围过滤，不建议用作内容分类 |
评价此篇文章