核心概念
Organization(组织) 是安全与计费边界。End User 是应用在该组织内的身份,与登录 Console 的 Platform Account 和 Organization Membership 分离。创建 End User 不会授予 Console 访问权。
Organization API Key 代表组织,不代表某个用户;User API Key 代表一个 End User 及其所属组织。每条接口声明接受的 Key 类别,提交别人的 User ID 不会获得其私有资源权限。
从模板到会话
Section titled “从模板到会话”| 资源 | 含义 |
|---|---|
| AgentTemplate | 作者编写并保存的组织行为定义,包含指令及声明的依赖。保存即生效。 |
| Session | End User 的私有会话。创建时在首个 Configuration Epoch 冻结所选模板和 Session 设置。 |
| Turn | 由 Full Agent 或 Realtime Model 执行的一轮对话;Full Agent Turn 可在执行中采纳追加要求。 |
| Interaction | 一个稳定消息、取消或检查点重试命令对应的受理与原次执行结果;消息还记录实际采纳。 |
每个 Configuration Epoch 保留准入时的模板内容、摘要和 Session 设置。Sandbox 设置指定 Profile 和 Drive 内的工作目录。显式切换模板会开始新的 Configuration Epoch,当前归属、模型和依赖可用性仍决定能否执行。
Session 在创建时选择回答模型,省略时使用当前发布版本提供的默认模型,未提供时使用组织默认模型。模型选择独立于 Template,并可在会话中切换。活动 Turn 保留接纳时的模型,切换从下一 Turn 生效。增加可用模型无需新建模板或编辑。
一个会话最多有一个活动 Full Agent Turn;已完成的 Realtime Turn 不占用该名额。新的纯文字要求调整该 Turn,不排队创建后继 Turn。受理与实际采纳是两回事,原命令回执和执行历史提供恢复依据。草稿输出与成功的最终 assistant Message 分离。
设备通过你的应用在 Session 上声明并执行的 Client Tools 行动。文本 Turn 和委派语音 Turn 都可以调用它们。
上传文件拥有私有且固定的 fileId。上传意图与文件就绪分离,Turn 只选择已就绪内容。见文件。
转写元数据、无用户输入的播报和分页行为见读取 Realtime 对话历史。