# 服务型智能体 · 运营与管理 (/docs/cloud/services/agent/embed/console-operate)



智能体上线之后，在「运营与管理」工作台看它跑得怎么样，并处理个别用户的问题。打开 Console「服务型智能体」，选中一个智能体，点页签栏左侧的「运营与管理」。五个页签：

| 页签    | 做什么                  | 状态 |
| ----- | -------------------- | -- |
| 概览    | 会话量、活跃用户、好评率、来源和版本分布 | 可用 |
| 会话    | 按终端用户、来源筛选会话，回放对话    | 可用 |
| 终端用户  | 查看用户，吊销令牌、封禁、解封      | 可用 |
| 用量与预算 | 花费与预算                | 可用 |
| 签发记录  | 谁在什么时候签发了令牌，吊销令牌     | 可用 |

接入与配置见[接入与配置](/docs/cloud/services/agent/embed/console-integrate)。

## 概览 [#概览]

右上角选时间范围：24 小时、7 天、30 天。

* **指标**：会话、活跃终端用户、花费、每会话花费、好评率、首字延迟 P50、错误率。没有对应样本时显示「—」。首字延迟、错误率、工具调用与需要关注的计数来自平台统计，无需配置 Observability。
* **会话量**：24 小时按小时、其余按天的趋势图。没有会话时显示「暂无会话」。
* **来源分布**：会话来自哪里——嵌入 · Kit 组件、嵌入 · iframe、托管对话页、API、自动化。
* **版本分布**：各版本的会话数和占比，当前版本带「当前版本」标记。想看新版本发布后流量是否切过去，用它。
* **花费趋势**：24 小时按小时，其余按天。
* **需要关注**：所选时间范围内的「来源被拦」「预算触顶」次数。
* **工具调用 Top 5**：按调用次数显示工具排行；没有调用时显示「暂无工具调用」。

## 会话 [#会话]

列表列出这个智能体的所有会话：标题、终端用户、来源、版本、最后活跃和状态（空闲、运行中、重试中、已结束、已归档）。消息数、花费、反馈三列目前显示「—」。

* **筛选**：输入终端用户 ID 点「筛选」，或在「来源」下拉选 Kit、iframe、托管页面、API、自动化。
* **回放**：点一行，右侧展开只读的对话回放，头部显示终端用户、来源、版本和创建时间。回放里不能发送消息，也不会改动会话。
* **归档**：回放头部的「归档」会让会话不能再继续发送消息，对话记录仍可查看，需确认。
* 列表较长时点「加载更多」。

期望：点开一个会话，右侧出现完整对话；点「关闭回放」收起。

## 终端用户 [#终端用户]

终端用户是宿主在签发令牌时给出的 `external_user_id`。表格列出终端用户 ID、首次出现、最后活跃、会话数、花费和状态（正常或已封禁），可按用户 ID 前缀搜索。点用户 ID 打开详情抽屉，里面有基本信息和最近会话，点最近会话会跳到「会话」页签。

每行有两个操作，点后都会弹出确认框：

| 操作   | 效果                                                |
| ---- | ------------------------------------------------- |
| 吊销令牌 | 吊销该用户当前所有有效令牌，正在进行的对话会被中断；宿主可以重新签发。完成后提示「已吊销 N 张」 |
| 封禁   | 宿主之后为该用户签发新令牌会被拒绝，现有令牌立即吊销。状态变为「已封禁」              |
| 解封   | 宿主可以再次为该用户签发令牌                                    |

已封禁的用户行上显示「解封」，其余显示「封禁」。「配置 · 安全」里显示的封禁人数与这里一致，封禁名单在这里管理。被封禁用户的签发请求会收到 `EMBED_USER_BLOCKED`，见[限制与错误](/docs/cloud/services/agent/embed/limits-and-errors)。

## 用量与预算 [#用量与预算]

页面显示本月花费、月度上限与触顶动作、7/30/90 天的每日花费、预算与限流、本月来源拆分，以及花费最高的终端用户 Top 20。本月统计按 UTC 自然月计算。点「修改上限」进入「配置 · 安全」。「花费构成」仍显示「即将上线」。

## 签发记录 [#签发记录]

每次宿主后端签发嵌入令牌都会留下一条记录：签发时间、终端用户、版本、签发者（成员或 API Key，显示前 8 位）、来源 origin、过期时间和状态（有效、已过期、已吊销）。记录里不包含令牌本身。

* 按终端用户 ID 筛选，点「筛选」；在「状态」下拉选全部、有效、已过期或已吊销。
* 有效的令牌右侧有「吊销」：确认后这张令牌立刻失效，正在进行的对话被中断，宿主可以重新签发，页面提示「令牌已吊销。」。只吊销这一张，同一用户的其他令牌不受影响；要一次吊销某个用户的全部令牌，用「终端用户」页签。
* 还没有记录时显示「还没有签发记录」，宿主通过 API 签发令牌后会出现在这里。

签发记录是排查「用户说打不开」的第一站：先找到该用户最近一条记录，看状态是不是已过期或已吊销，再看来源 origin 是否在来源白名单里。

下一步：[接入与配置](/docs/cloud/services/agent/embed/console-integrate) · [嵌入令牌与终端用户](/docs/cloud/services/agent/embed/tokens)