使用指南
本文不按岗位角色划分，而是按当下要完成的事情划分。同一人在不同时间覆盖两个区间也很常见，例如今天提问看数，明天补表和调整语义。
Analytics Agent 的能力分两个区间：
| 区间 | 你做的事 | 你需要知道 |
|---|---|---|
| 分析数据 | 提问、读答案、看板、探索、反馈 | 分析域里有什么数据、如何用业务语言提问 |
| 管理维护 | 加表、配字段、建指标、设权限、查审计 | 数据模型、SQL 语法、权限体系 |
这两个区间不是彼此独立的。业务人员使用越接近日常业务沟通，管理维护侧越需要把分析域边界、字段语义、指标口径、知识、答案构建器、权限和验证工作准备充分。否则前台虽然可以自然语言提问，后台却缺少足够的语义和治理承接，问答效果就很难稳定。
管理维护可以理解为把通用大模型约束到企业分析场景中的过程：不是让模型直接猜企业数据，而是为它提供明确的业务上下文、可用资源、字段含义、指标口径、权限边界和验证反馈。这样业务人员才可以少依赖底层技术细节，多用自然语言完成分析。
分析数据
在分析数据区间，你用自然语言获得答案、探索指标、构建和使用看板。你不需要知道底层表名和 SQL。
你会用到这些功能
| 功能 | 做什么 | 入口 |
|---|---|---|
| 分析问答 | 用自然语言查数、看趋势、做对比 | |
| 数据标签 | 查看当前域有哪些表和字段，确认能问什么 | |
| 探索 | 围绕已配置的指标做基准/对比时间分析和下钻 | |
| 推荐问题 | 不知道怎么问时直接点击示例问题 | |
| SQL 语句 | 由 BI 分析师或维护者验证重要答案用了什么字段和条件 | |
| 记录 | 由 BI 分析师或维护者查看系统为什么这样回答、命中了哪些配置 | |
| 保存到看板 | 把有价值的图表沉淀到看板 | |
| 我的看板 / 共享看板 | 维护或查看团队看板 | |
| 定时任务 | 周期性推送分析结果或异常监控 | |
| 表格渲染 | 调整表格样式和布局 | |
| 看板版本 | 查看或回退看板变更历史 | |
| 图表刷新 | 设置看板数据自动更新频率 | |
| 反馈 | 答案不准、图表不对时提交校准反馈 | |
典型路径
分析数据的边界
当你遇到以下情况，说明进入了管理维护区间：
- 看推荐问题时发现域里缺表或少字段 → 需要加表或配字段语义
- 探索页看不到需要的指标 → 需要建指标或答案构建器
- 同一个业务词系统总是误解 → 需要配知识或字段别名
- 用户看不到应该看到的数据 → 需要检查权限或行级权限
如果这些工作由同一人承担，可以继续看下一节。
管理维护
在管理维护区间，工作的重点是让系统稳定理解数据、控制数据可见范围，并追踪关键配置变更。
管理维护的交付目标不是完成一组配置项，而是让业务人员在较少依赖底层字段、技术条件和 SQL 判断的情况下，也能获得符合业务口径和权限边界的答案。
你会用到这些功能
语义层
| 功能 | 做什么 | 入口 |
|---|---|---|
| 表管理 | 查看和添加可问答的表 | |
| 字段语义 | 配置别名、描述、类型、用途、隐藏 | |
| 虚拟列 | 用表达式创建派生字段 | |
| 指标 | 固化聚合口径 | |
| 答案构建器 | 封装复杂 SQL 模板，支持动态维度和过滤 | |
| 知识 | 补充业务术语、口径和同义词 | |
| 文件 | 上传文档用于文档问答 | |
| 索引管理 | 管理字段检索索引 | |
| 推荐问题 | 为分析域设计引导问题 | |
治理
| 功能 | 做什么 | 入口 |
|---|---|---|
| 用户管理 | 管理账号、用户组 | |
| 角色授权 | 创建角色，配置功能权限和资源权限 | |
| 行级权限 | 控制用户只能看到指定数据行 | |
| 分析域权限 | 控制谁能进入哪个域 | |
| 审计日志 | 追踪谁在什么时候做了什么操作 | |
| 反馈管理 | 集中查看和分派用户反馈 | |
| 数据源 | 管理底层数据连接 | |
| 模型配置 | 管理可用 LLM 模型 | |
| 定时任务治理 | 查看任务状态、发送地址、停用启用 | |
验证
| 功能 | 做什么 | 入口 |
|---|---|---|
| 问答验证 | 用典型问题测试配置是否生效 | |
| 健康度扫描 | 检查字段描述缺失、指标缺失、表关系异常 | |
典型路径
这条路径要形成闭环：业务人员用自然语言暴露问题，BI 分析师把问题转成可验证案例，语义层维护者修正字段、指标、知识或答案构建器，管理员检查权限和审计，最后再用同一批业务问题验证效果。没有这个闭环，单纯降低业务用户提问门槛并不能保证答案变准。
两类功能的关系
看板
看板是分析资产，不是管理操作。
| 区间 | 做什么 |
|---|---|
| 分析数据 | 创建看板、添加图表、组织内容、共享给团队 |
| 管理维护 | 需要时调整权限边界，通过审计追踪看板变更 |
定时任务
定时任务横跨两区间——谁都可以建，但治理侧需要管理。
| 区间 | 做什么 |
|---|---|
| 分析数据 | 设计监控场景，创建任务，编辑执行时间和内容 |
| 管理维护 | 治理发送地址、停用异常任务、检查执行权限 |
反馈
反馈是两区间之间的闭环入口。
| 区间 | 做什么 |
|---|---|
| 分析数据 | 提交“哪里不对”以及对应的业务判断 |
| 管理维护 | 在 |
列隐藏
列隐藏是语义配置，但能达到列级治理效果——它属于管理维护区间。
阅读路径
从分析数据开始
- 提问指南 — 好问题的结构
- 分析模式指南 — 查数、对比、趋势、排名、归因
- 阅读分析结果 — 看数值、表格、图表、SQL、记录
- 使用看板 — 从问答到看板
- 使用数据与探索 — 数据标签 + 结构化探查
- 处理反馈 — 提交和改进
- 消息通知 — 查看后台任务状态
- 更换 Logo、主题与图表配色 — 账号信息、Logo、主题和图表配色
从管理维护开始
- 分析域规划指南 — 先规划域，再加数据
- 配置分析域 — 创建域、加表、配表详情
- 配置字段语义 — 别名、描述、类型、用途
- 配置虚拟列 — 派生字段
- 答案构建器最佳实践 — SQL 模板设计
- 配置知识 — 口径和术语
- 排查问答准确性问题 — 诊断与修复
- 治理总览 — 权限、审计、域隔离
- 管理权限 — 账号、角色、域权限
- 查看审计日志 — 操作记录追踪
- 全量下载与数据导出治理 — 下载权限和导出审计
配置完成后的验证闭环
核心原则
- 按能力做事，不按岗位贴标签。同一人可以既分析数据又管理系统。
- 看板是分析资产，提问题和建看板的人管内容；权限和审计属于管理维护。
- 反馈是两区间之间的闭环——分析数据的人提交，管理维护的人修复。
- 分析域是治理边界。无关业务不宜混在同一个域里，权限治理也不宜全部压到行级权限上。
相关文档
联系我们