跳转到内容

架构

组织拥有共享配置。End User 拥有会话和文件。Session 在 Configuration Epoch 中冻结选定的模板和执行设置。

End User 拥有 Session。Session 固定模板的内容摘要并包含多个 Turn。
资源 作用
Organization(组织) 配置与资源的安全和计费边界。
End User 应用在该组织内的身份,与 Console 的 Platform Account 和 Membership 分开。
AgentTemplate(模板) 共享行为:指令、启用的能力与依赖。单一可变实体,保存即生效。
Session(会话) End User 的私有对话。创建时冻结选定模板的当前内容。
Turn 会话中的一次 Full Agent 执行或已完成的 Realtime 交流。

示例:会话 A 以模板当前内容开始。你编辑并保存模板,新会话 B 使用保存后的内容;会话 A 的后续 Turn 仍使用原配方。固定配置保留执行依据,当前归属、策略和依赖可用性仍约束执行。

会话最多有一个活动 Full Agent Turn;已完成的 Realtime Turn 不占用该名额。执行期间的新纯文字要求调整该 Turn,不会排队创建另一个。保存的交互记录区分准入、纳入和原结果。详见核心概念及会话与轮次。

Session 客户端示例:客户后端用 User Key 向 API 提交消息;会话归属与当前检查通过后运行 Turn 和模型,允许的操作访问 Sandbox 或私有文件;进度和结果返回客户。物理设备由客户应用负责,文本 Session 的 Client Tools 由客户端声明并执行。
  1. 应用后端使用 End User 的 User API Key,通过 POST events 提交命令,获得 JSON 回执。
  2. 服务解析会话的固定配方,检查当前访问权限及适用限额。
  3. Turn 运行模型。模型可以选择模板启用的工具,由受控操作提供工具结果。
  4. 应用后端从 Turn 读取进度和结果;持有 Organization API Key 时,也可通过 Backend Connection 接收 Session 事件,重连后按游标续接。断开连接不取消执行,取消需要显式命令。Interactions 与 Turns 提供原回执和已保存历史。

你的应用或设备可以在普通文本 Session 上声明 Client Tools 并执行调用。平台转发所需动作与结果;设备传输和物理执行由你的集成负责。语音设备动作委托给 Full Agent Turn,它使用同一组 Session Client Tools;Realtime 不提供直接设备或 Session 客户端工具。

继续阅读能力与示例,或进入快速开始。

窄屏上可横向滚动各张图,阅读完整标注。

转写元数据、无用户输入的播报和分页行为见读取 Realtime 对话历史。