服务型智能体 · 运营与管理
在 Console 里看概览、回放会话、管理终端用户、查看和吊销令牌签发记录。
智能体上线之后,在「运营与管理」工作台看它跑得怎么样,并处理个别用户的问题。打开 Console「服务型智能体」,选中一个智能体,点页签栏左侧的「运营与管理」。五个页签:
| 页签 | 做什么 | 状态 |
|---|---|---|
| 概览 | 会话量、活跃用户、好评率、来源和版本分布 | 可用 |
| 会话 | 按终端用户、来源筛选会话,回放对话 | 可用 |
| 终端用户 | 查看用户,吊销令牌、封禁、解封 | 可用 |
| 用量与预算 | 花费与预算 | 可用 |
| 签发记录 | 谁在什么时候签发了令牌,吊销令牌 | 可用 |
接入与配置见接入与配置。
概览
右上角选时间范围: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,见限制与错误。
用量与预算
页面显示本月花费、月度上限与触顶动作、7/30/90 天的每日花费、预算与限流、本月来源拆分,以及花费最高的终端用户 Top 20。本月统计按 UTC 自然月计算。点「修改上限」进入「配置 · 安全」。「花费构成」仍显示「即将上线」。
签发记录
每次宿主后端签发嵌入令牌都会留下一条记录:签发时间、终端用户、版本、签发者(成员或 API Key,显示前 8 位)、来源 origin、过期时间和状态(有效、已过期、已吊销)。记录里不包含令牌本身。
- 按终端用户 ID 筛选,点「筛选」;在「状态」下拉选全部、有效、已过期或已吊销。
- 有效的令牌右侧有「吊销」:确认后这张令牌立刻失效,正在进行的对话被中断,宿主可以重新签发,页面提示「令牌已吊销。」。只吊销这一张,同一用户的其他令牌不受影响;要一次吊销某个用户的全部令牌,用「终端用户」页签。
- 还没有记录时显示「还没有签发记录」,宿主通过 API 签发令牌后会出现在这里。
签发记录是排查「用户说打不开」的第一站:先找到该用户最近一条记录,看状态是不是已过期或已吊销,再看来源 origin 是否在来源白名单里。