管理看板

以 Markdown 格式查看

管理看板是艾维斯面向管理者和运营人员的总览页面。它帮助管理员判断 AI 能力是否被使用、Agent 与自动化结果是否成功,以及哪些用量、反馈或覆盖率指标需要关注。

请把它作为产品和运营视图使用。需要排查单次请求时,请使用追踪查询历史。需要查看模型用量和成本明细时,请使用用量统计

艾维斯 Admin AI 成效 Dashboard 设计蓝图,展示完整 Admin 入口、管理者 Hero、KPI 卡片、趋势、排行、关注项和数据边界

实际界面截图

以下截图展示管理看板在实际数据下的主要区域。截图中的数值仅用于说明页面布局和指标位置,实际结果以当前部署数据为准。

艾维斯管理看板实际界面,展示 AI 成效总览、已核验 AI 成效、活动趋势和反馈质量 艾维斯管理看板实际界面,展示最受欢迎的 AI 能力、热门 Agent、活跃员工和需要关注事项

入口与权限

项目建议
入口打开艾维斯管理后台并进入 /admin/dashboard
所需权限页面仅向拥有完整管理后台访问权限的管理员开放。
主要受众管理者、运营负责人、AI 平台管理员和获授权审计人员。
数据边界看板用于聚合监督,不能替代单次请求审计或权限复核。

看板展示内容

区域回答的问题
采用率总览选定周期内有多少符合条件的用户活跃,以及组织内 AI 使用占比是多少。
已验证 AI 产出AI 回答了多少问题、Agent 完成了多少任务、自动化成功运行了多少次。
活动趋势按天展示成功 AI 产出,并区分问题回答、Agent 任务和自动化运行。
模型用量模型调用量、成功和失败次数、有效 Token、已计量成本、Token 覆盖率和定价覆盖率。
反馈质量正向和负向评分、反馈覆盖率、正向率,以及样本量是否足够。
Top 能力哪些 AI 能力产生了最多完成结果,以及有多少唯一用户使用。
Top Agent哪些 Agent 完成了最多交互或自动化结果。
活跃用户哪些用户活跃、最近活跃时间,以及活动类型分布。
需要关注Agent 任务失败或取消、自动化失败或跳过、产出覆盖不完整、反馈样本不足、Token 覆盖不完整或定价覆盖不完整。

选择时间范围

看板支持最近 7 天、30 天、90 天三个快捷范围,也支持自定义日期范围。自定义范围会按浏览器选择的时区解释,且不能超过 366 个自然日。

页面会把选定范围写入 URL 查询参数:

查询参数含义
range73090custom
start自定义范围的包含起始时间,使用 ISO datetime。
end自定义范围的排他结束时间,使用 ISO datetime。
timezone用于日期边界和展示的 IANA 时区。

页面可见时,看板会自动刷新;也可以点击手动刷新按钮。刷新期间已有数据会继续显示,新的数据加载完成后再更新。

正确理解指标

信号如何解读
Updated 时间某个看板区域返回的最新生成时间。
上一周期对比如果上一周期超出已追踪覆盖范围,会隐藏或显示为不可用。
产出覆盖不完整选定范围包含 AI 产出追踪完全启用之前的时间,因此总数可能不完整。
Token 覆盖率部分模型调用可能没有返回 Token 元数据。Token 总数只代表已计量覆盖,不一定是完整用量。
定价覆盖率部分调用可能没有已知价格。未定价调用不是零成本,而是缺少定价覆盖。
反馈样本量反馈质量至少需要 5 条已评分回复,才会被视为样本量足够。

继续下钻

从看板出发后续页面
模型用量明细打开用量统计。部分部署只在符合条件的版本中开放。
回复质量和单条反馈在管理员可查看查询历史时,打开查询历史
Top Agent打开智能体,复核 owner、配置和共享范围。
活跃用户打开用户、群组与角色,复核访问权限和群组边界。

后台分区

页面会独立加载多个看板区域。某个区域失败时,其他区域仍可正常渲染,失败卡片也可以单独重试。

区域后端路由
总览/api/admin/dashboard/overview
活动趋势/api/admin/dashboard/activity-trend
反馈/api/admin/dashboard/feedback
Top 能力/api/admin/dashboard/capabilities
Top Agent/api/admin/dashboard/agents
活跃用户/api/admin/dashboard/users
LLM 用量/api/admin/dashboard/llm-usage

验证

  • 使用管理员账号登录并打开 /admin/dashboard
  • 在最近 7 天、30 天、90 天之间切换,确认 URL 和看板数值随之更新。
  • 应用自定义范围,并确认超过 366 天的无效范围会被拒绝。
  • 点击手动刷新,确认刷新期间已有内容仍保持可见。
  • 使用一次已知测试请求,对比用量统计追踪查询历史中的总量和明细。
  • 使用非管理员账号确认页面和 API 路由不可访问。

常见问题排查

现象优先检查项
无法打开看板确认用户拥有完整管理后台访问权限,并处在正确部署或工作区中。
某个卡片显示不可用先重试该区域,再检查对应后端路由和数据库指标查询。其他卡片可能仍是最新的。
上一周期对比不可用上一周期可能早于追踪开始时间,或超出可用覆盖范围。
Token 或成本总量偏低先检查 Token 覆盖率和定价覆盖率,再判断展示总数是否可视为完整。
反馈质量不可用确认已启用查询历史和反馈收集,并且选定周期内至少有 5 条已评分回复。
活动量低于预期检查所选时区、时间范围,以及上游机器人、Agent 或自动化请求是否成功到达艾维斯。

安全与维护建议

  • 将看板访问视为管理权限,因为它会暴露用户活动、Agent 表现、模型用量和成本模式。
  • 不要把活跃用户排行导出或转发到未批准的运营和审计渠道之外。
  • 启用新的 Agent、机器人、自动化、模型或追踪路径后,应复查看板数据。
  • 将“需要关注”作为运营信号,再到追踪或查询历史中排查底层请求。
  • 将看板上线到已有部署时,应记录已知覆盖率缺口。

相关页面