跳到主要内容

LTM 接入方式

Turing LTM 提供三种互补接入方式。它们共享同一套记忆语义,但数据边界和调用责任不同。

Turing LTM 三种接入方式与 Space 的关系

Public LTM API​

适合需要完全控制 Agent loop、Prompt 组装和读取时机的应用。应用负责:

  1. 提交新增 Event。
  2. 选择 Context、Search 或 Browser 读取原语。
  3. 把返回的参考材料放入模型上下文。
  4. 根据业务策略决定是否以及何时写入。

从 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 LTMturing-cli memory login、install、doctor、recall、rememberTuring 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 loopPublic 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 配置到应用。