智能体
管理终端用户
查找终端用户，撤销全部令牌、封禁或恢复访问。
按宿主应用的用户 ID 查找终端用户，并在需要时停止或恢复其嵌入访问。操作范围是当前组织、当前智能体下的这个用户。
准备与选择操作
准备已有嵌入策略的服务智能体、组织管理权限，以及签发时使用的 external_user_id。先用隔离测试用户验证操作；撤销和封禁会中断其正在进行的对话。
| 目的 | 操作 | 后续访问 |
|---|---|---|
| 结束当前凭证的访问 | 吊销令牌 | 撤销该用户的全部现有令牌；宿主仍可签发新的 |
| 持续拒绝用户访问 | 封禁 | 撤销现有令牌，拒绝新签发 |
| 恢复签发资格 | 解封 | 允许新签发；已撤销的旧令牌不会恢复 |
只想撤销一张令牌时，使用令牌管理，不要执行用户级批量撤销。
查找并管理用户
- 打开「服务智能体 → 选择智能体 → 运营与管理 → 终端用户」。控件名称对应当前中文控制台。
- 在「按终端用户 ID 前缀搜索」输入 ID。列表显示首次出现、最后活跃、会话数、花费与状态。
- 点击用户 ID 打开详情；通过「最近会话」检查是否找对了用户。
- 在该用户行或详情中点击「吊销令牌」「封禁」或「解封」，核对确认框中的用户 ID，再点击对应确认按钮。
预期结果： 撤销显示「已吊销 N 张」；封禁后状态为「已封禁」；解封后为「正常」。列表中的花费和会话数据不会因这些操作被删除。
验证访问边界
撤销后，用旧令牌再次访问，应被拒绝；宿主重新确认登录身份后可以签发新令牌。封禁后，宿主的签发请求应收到 EMBED_USER_BLOCKED（HTTP 403）。解封后重新签发并发送消息，确认恢复；不要以旧令牌重试成功作为解封标准。
同时用另一个用户访问同一智能体，确认其访问未被本次操作影响。用户身份不能取自浏览器任意提交的 ID，应由宿主后端的登录态确定。
处理失败
查不到用户时，核对组织、公开智能体 ID 和签发时的完整用户 ID；控制台试用调试的数据不会进入客户用户列表。仅有前缀相似不能证明是同一个用户。
若封禁返回失败，重新读取状态后再决定是否重试：封禁状态可能已经保存，而撤销步骤尚未完成。不要在这种情况下显示“封禁完成”。记录 HTTP 状态和请求 ID，按限制与错误处理。