智能体嵌入

服务型智能体 · 运营与管理

在 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 是否在来源白名单里。

下一步:接入与配置 · 嵌入令牌与终端用户

导出

本页内容