← 返回文档中心

AI Agent

AI 接入指南

任意 AI 接入 OMemAI 的通用原则。普通用户优先 Gateway；MCP 是标准工具路线；REST 是备用路线。

Gateway 推荐

本地运行服务强制执行记忆流程，支持 0.2.6+ 自动化闭环。

MCP 标准工具

适合 Claude Desktop、Cursor 等支持 MCP 的客户端。

REST 备用

适合自研 Agent 和脚本，但依赖 Agent 自觉执行流程。

必须遵守的工作流

  1. 开始项目任务前，先确定项目，不确定就问用户。
  2. 加载项目上下文，读取当前事实、关键事实、历史事实、阶段摘要和下次继续提示。
  3. 需要历史时搜索记忆，默认限定当前项目。
  4. 每轮保存用户消息和 AI 回复，不要只在结束时保存。
  5. 阶段完成、上下文快满、出现关键事实/决策/风险/更正/下一步时生成记忆检查点。
  6. 不要编造记忆；接口、Gateway 或 MCP 失败时明确告诉用户记忆链路不可用。
  7. 不要跨项目污染；不要把密钥、Token、密码、私钥写入长期记忆。
  8. 优先使用当前事实；历史事实只作为历史。
  9. 接入后必须在接入健康页验证为“健康”。

推荐复制入口

打开提示词库，按 Gateway / MCP / REST 选择对应提示词。