LTM 接入方式
Turing LTM 提供三种互补接入方式。它们共享同一套记忆语义,但数据边界和调用责任不同。
Public LTM API
适合需要完全控制 Agent loop、Prompt 组装和读取时机的应用。应用负责:
- 提交新增 Event。
- 选择 Context、Search 或 Browser 读取原语。
- 把返回的参考材料放入模型上下文。
- 根据业务策略决定是否以及何时写入。
从 LTM API 参考 或 快速开始 开始。
Managed Chat
适合已经使用 Chat Completions、但不想自己维护 Recall 和 Capture 流程的应用。请求在 turing_options.memory 中绑定 Space 和 Actor,平台负责:
- 在模型调用前读取有界记忆并注入 evidence。
- 只调用一次主模型,并返回正常的 Chat Completions 响应。
- 在合格的终态回答后异步 Capture 新记忆。
- 通过 response headers 和 Trace 暴露 Memory outcome,方便排查。
工具调用中间态不会提前 Capture;如果主模型发生 fallback,Memory 会整体旁路。
CLI + Skills
适合 Codex、Claude Code、OpenClaw 等具备 Skill 和本地 Shell 能力的 Agent。Turing CLI 提供登录、Recall、Remember 和 Search 命令,Portable Skill 负责把这些命令接入 Agent 工作流。
Portal 用户省略 CLI 配置中的 space_id 时,CLI + Skills 使用当前用户、当前环境的默认 Personal Space。用户还可创建多个自定义个人 Space,client 也可拥有多个 Space;显式填写有权访问的 space_id 即可选择其中一个。多个 Agent 和 Managed Chat 要访问同一份记忆,需要使用相同 ID,不能按名称绑定。
SkillHub 与 CLI
CLI + Skills 使用同一份 Portable Skill。CLI 和 Skill 已在 SkillHub 上线,可直接安装并按 Agent Memory 指南完成配置和验证。
| Skill | 配合的 CLI 能力 | 入口 |
|---|---|---|
| Turing LTM | turing-cli memory login、install、doctor、recall、remember | Turing CLI · SkillHub: Turing LTM · 使用文档 |
Skill 负责把 Agent 的记忆意图转换为 CLI 的机器协议;CLI 负责凭据、默认或显式 Space 绑定、Recall / Remember 和标准 JSON 输出。应用也可通过 Public API 或 Managed Chat 显式选择 client 范围内的 Space。
完整的本地命令、配置和诊断方式见 Turing CLI:LTM 记忆。
与 Developer Platform 协同
Developer Platform 负责把抽象概念变成可观察的操作;文档负责解释契约和提供可复制的请求。两者应按同一组任务组织:
| 平台工作区 | 用户要回答的问题 | 右侧“接口文档”应打开 |
|---|---|---|
| 记忆空间 | 我在给谁保存记忆? | Space 与边界 |
| 写入记忆 | 为什么返回 Accepted 但暂时查不到? | 写入 Event |
| 读取记忆 | Context、Search、Browser 有什么区别? | 读取原语 |
| 记忆接入 | 应该选 API、Managed Chat 还是 CLI? | 本页对应的接入方式 |
| 审计与诊断 | 这条记忆从哪里来、哪次请求用了它? | LTM 核心概念 |
推荐的交互是:平台右侧打开窄抽屉,保留当前 Space、环境和语言上下文;抽屉中的“查看完整文档”再跳到 docs 站点。文档中的示例只使用占位 API Key 和当前页面可复制的 Space 字段,不把平台内部 demo 数据写死。
如何选择
| 需求 | 推荐方式 |
|---|---|
| 自己控制每一轮 Prompt 和 Agent loop | Public LTM API |
| 已经有 Chat Completions,希望最少改代码 | Managed Chat |
| 本地开发 Agent 共享个人偏好 | CLI + Skills |
| 多个用户或 Agent 共享项目事实 | Public API / Managed Chat + Project Space |
进入 LTM 开发者平台,先创建 Space,再用 Event Playground 和 Memory Explorer 验证派生、读取和审计链路,最后复制 API 或 Managed Chat 配置到应用。