创建与管理 API Key
在控制台左侧独立的 API Keys 页面签发和管理服务端应用 Key，入口位于“接入”旁边。“接入”页的“管理 API Keys”也会打开这里。Key 属于当前账号的内部应用，使用当前账号的钱包；它不是新的用户账号或独立余额。
为文本接入创建受限 Key
- 先发布目标 Agent，记下 Agent ID。
- 创建 Key 时选择该 Agent 范围，以及
runtime:read和runtime:write。只读历史只需前者；执行真实工具时另外选tools:execute。 - 选择有效期。页面默认 90 天；接口允许 1–365 天。保存后立即复制唯一一次显示的明文到产品后端的受保护配置。
- 在产品后端验证身份、读取
/v1/runtime/bootstrap，再向有权限的 Agent 发起请求。不要将 Key 放入浏览器、Widget 属性、日志或公开示例。
各 scope 相互独立：runtime:write 不自动授予读取，configuration:write 也不自动授予 configuration:read。限定 Agent 的 Key 不能借配置 scope 读取全局配置或管理其他 Agent。个人钱包、账单、充值与管理员能力不向应用 Key 开放。权限表。
轮换、撤销与丢失
轮换会创建继承原范围的新 Key，旧 Key 暂时保持有效，便于先更新产品服务，再单独撤销旧 Key。撤销所选 Key 后，它立即失效，其他 Key 不受影响。最近使用时间是近似活动信息。
明文无法再次读取。签发响应丢失且未保存明文时，在列表中撤销该 Key，再用新的请求号创建；不要使用原请求号期待返回明文。一次性展示窗口关闭后也需这样处理。每账号最多 100 个有效 Key。用户重置密码或关闭账号会撤销全部 Key。产品后端接入。