智能体
上线检查清单
对外开放嵌入前，核对版本、身份、来源、预算和故障恢复。
在嵌入首次对外开放，或更换域名、身份接入方式、组件版本后执行本清单。先完成测试嵌入接入，每项保存可复查的结果，再开放访问。
确认上线条件
- 配置与版本一致。 控制台「接入与配置 → 版本」显示预期嵌入版本；宿主新签发令牌产生的会话使用该版本。若签发请求显式传
version，确认它没有覆盖你的版本选择。 - 身份来自宿主登录态。 未登录请求无法从宿主取得令牌；A、B 两个测试用户互相看不到会话。API Key 仅在服务器，浏览器源码和响应中没有
PRAXIS_API_KEY的真实值。 - 匿名凭据使用正确。 若启用匿名访问，页面只公开 publishable key，已设置相应限额；不同浏览器存储的访客相互隔离，
visitor_secret不被分享。 - 目标来源已验证。 用实际 HTTPS 域名加载并完成回复；白名单外来源失败。iframe 在目标页面可显示；Hosted 使用独立页面，不能嵌入 iframe。上线配置关闭不再需要的 localhost 访问。
- 组件交付可重复。 已记录并验证使用的 Kit 版本、脚本地址及适用的完整性值；从空缓存加载成功。页面能发送消息并收到真实回复，而非仅收到
praxis.ready。 - 拒绝路径可恢复。 到期、撤销、封禁和来源拒绝均已测试。宿主退出后销毁旧组件；Hosted 到期后能从宿主获取新链接，不循环使用失效链接。
- 工具只执行允许的操作。 已测试有效输入、无效输入和无业务权限的用户；「每次询问」不会替代工具服务端鉴权。
- 预算与监控可用。 核对美元预算、有效期、请求与活跃会话上限；月度触顶动作符合业务预期。在「运营与管理」能找到宿主测试会话、来源和用量。
准备回滚与支持
保留已验证的宿主部署和组件版本。配置异常时，在「版本」选择旧版本并点击「回滚到此版本」，重新签发后验证；已签发令牌不变。需要立即停止某个用户访问时，使用封禁或批量撤销，并确认旧令牌已失败。
为支持人员保存故障时间、环境、公开智能体 ID、会话 ID、HTTP 状态、错误码与 X-Request-Id，不保存令牌或 API Key。按限制与错误选择恢复动作，再从宿主完成一次对话验证。