# 上线检查清单 (/docs/developers/agent/embed/go-live)



在嵌入首次对外开放，或更换域名、身份接入方式、组件版本后执行本清单。先完成[测试嵌入接入](/docs/developers/agent/embed/testing)，每项保存可复查的结果，再开放访问。

## 确认上线条件 [#checklist]

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

## 准备回滚与支持 [#rollback]

保留已验证的宿主部署和组件版本。配置异常时，在「版本」选择旧版本并点击「回滚到此版本」，重新签发后验证；已签发令牌不变。需要立即停止某个用户访问时，使用[封禁或批量撤销](/docs/developers/agent/end-users)，并确认旧令牌已失败。

为支持人员保存故障时间、环境、公开智能体 ID、会话 ID、HTTP 状态、错误码与 `X-Request-Id`，不保存令牌或 API Key。按[限制与错误](/docs/developers/agent/embed/limits-and-errors)选择恢复动作，再从宿主完成一次对话验证。

相关参考：[配置智能体](/docs/developers/agent/configure) · [组件参考](/docs/developers/agent/embed/component-reference) · [智能体 API](/docs/api/native/agent)