架构
组织拥有共享配置。End User 拥有会话和文件。Session 在 Configuration Epoch 中冻结选定的模板和执行设置。
从模板到会话
Section titled “从模板到会话”| 资源 | 作用 |
|---|---|
| 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,不会排队创建另一个。保存的交互记录区分准入、纳入和原结果。详见核心概念及会话与轮次。
一次请求如何流转
Section titled “一次请求如何流转”- 应用后端使用 End User 的 User API Key,通过 POST events 提交命令,获得 JSON 回执。
- 服务解析会话的固定配方,检查当前访问权限及适用限额。
- Turn 运行模型。模型可以选择模板启用的工具,由受控操作提供工具结果。
- 应用后端从 Turn 读取进度和结果;持有 Organization API Key 时,也可通过 Backend Connection 接收 Session 事件,重连后按游标续接。断开连接不取消执行,取消需要显式命令。Interactions 与 Turns 提供原回执和已保存历史。
你的应用或设备可以在普通文本 Session 上声明 Client Tools 并执行调用。平台转发所需动作与结果;设备传输和物理执行由你的集成负责。语音设备动作委托给 Full Agent Turn,它使用同一组 Session Client Tools;Realtime 不提供直接设备或 Session 客户端工具。
窄屏上可横向滚动各张图,阅读完整标注。
转写元数据、无用户输入的播报和分页行为见读取 Realtime 对话历史。