> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.alephant.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.alephant.io/_mcp/server.

# 管理看板

> 使用艾维斯管理看板查看采用率、已验证产出、模型用量、反馈质量和需要关注的运营信号。

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

请把它作为产品和运营视图使用。需要排查单次请求时，请使用[追踪](/aivis/governance/tracing)和[查询历史](/aivis/governance/query-history)。需要查看模型用量和成本明细时，请使用[用量统计](/aivis/governance/usage)。

## 实际界面截图

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

## 入口与权限

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

## 看板展示内容

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

## 选择时间范围

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

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

| 查询参数       | 含义                            |
| ---------- | ----------------------------- |
| `range`    | `7`、`30`、`90` 或 `custom`。     |
| `start`    | 自定义范围的包含起始时间，使用 ISO datetime。 |
| `end`      | 自定义范围的排他结束时间，使用 ISO datetime。 |
| `timezone` | 用于日期边界和展示的 IANA 时区。           |

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

## 正确理解指标

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

## 继续下钻

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

## 后台分区

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

| 区域        | 后端路由                                  |
| --------- | ------------------------------------- |
| 总览        | `/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 天的无效范围会被拒绝。
* 点击手动刷新，确认刷新期间已有内容仍保持可见。
* 使用一次已知测试请求，对比[用量统计](/aivis/governance/usage)、[追踪](/aivis/governance/tracing)或[查询历史](/aivis/governance/query-history)中的总量和明细。
* 使用非管理员账号确认页面和 API 路由不可访问。

## 常见问题排查

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

## 安全与维护建议

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

## 相关页面

* [管理后台与角色](/aivis/admin-panel-and-roles)
* [用量统计](/aivis/governance/usage)
* [追踪](/aivis/governance/tracing)
* [查询历史](/aivis/governance/query-history)