跳转到内容

核心概念

Organization(组织) 是安全与计费边界。End User 是应用在该组织内的身份,与登录 Console 的 Platform Account 和 Organization Membership 分离。创建 End User 不会授予 Console 访问权。

Organization API Key 代表组织,不代表某个用户;User API Key 代表一个 End User 及其所属组织。每条接口声明接受的 Key 类别,提交别人的 User ID 不会获得其私有资源权限。

资源 含义
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 对话历史。