提问指南
本文面向业务用户，说明如何用业务语言向 Analytics Agent 提问，并在需要时逐步把问题收敛清楚。
Analytics Agent 支持用自然语言进行数据分析。业务用户不需要先写 SQL，也不需要知道底层表名、字段名或系统配置。多数情况下，只要用日常业务语言说清楚“想看什么、看哪个范围、希望怎么展示”，系统就会结合分析域中的语义配置、指标和知识完成理解。
适用对象
- 业务负责人：快速查看核心经营指标、趋势和异常。
- 运营、销售、财务、人力等业务人员：围绕自己的业务域提问。
- 业务分析人员：把临时问题转化为可复用的问题模板或看板素材。
如果你负责建表、配置字段语义、指标、知识或答案构建器，请同时阅读语义配置和问答准确性排查相关文档。
提问前先确认分析域
进入分析页面后，页面顶部会显示当前分析域名称。分析域决定了 Analytics Agent 能使用哪些表、字段、指标、知识和权限边界。
如果你发现问题明明和业务相关，但系统回答“没有数据”或答案明显不符合业务范围，先确认是否选错了分析域。
如果你不确定当前分析域能问什么，可以先打开页面中的“数据”标签。该标签会展示当前分析域内可用的数据对象和字段。普通业务用户不需要记住字段名，只需要借助它判断当前分析域大致覆盖哪些业务数据；业务分析人员可以进一步参考字段名称来设计更稳定的问题。
常见情况：
- 你在销售分析域里问财务回款细节，可能无法命中正确数据。
- 你在测试域里问正式经营数据，结果可能只来自测试表。
- 你没有某个分析域的访问权限，就不能通过问答绕过权限边界获取数据。
好问题的基本写法
业务用户不需要按固定模板提问，可以先用一句自然语言说明业务问题：
这个问题已经比较清楚，因为它说出了：
- 业务对象：账户
- 关心内容：健康概览
- 分组方式：按 plan 对比
- 想看的结果：账户数、活跃账户数、活跃率、席位等
如果暂时不知道该看哪些指标，也可以先问得更宽一些：
然后根据系统返回的结果继续追问：
提问不需要一次把所有条件都说全。业务用户可以先问一个自然问题，再通过追问逐步收敛。
如果已经知道要看的对象、范围或时间，把这些信息补上，答案通常会更稳定。
常用提问方式
查一个数
适合确认单个指标。
这个问题对业务用户来说通常已经足够清楚，因为它说明了要看的业务对象和条件。
如果组织里存在多个相近说法，例如“活跃账户”“当前活动账户”“活跃订阅账户”含义不同，可以补一句业务口径：
业务用户不需要知道这个口径来自知识、指标还是字段配置。口径解释通常由分析域维护者通过字段语义、指标、知识或答案构建器提前配置好。
做分组对比
适合比较不同部门、地区、产品、渠道、客户类型。
看趋势
适合按天、周、月、季度查看变化。
如果你关心具体时间范围，可以补充时间：
看排名
适合找 Top N 或 Bottom N。
看占比
适合看结构和构成。
查明细
适合获取具体记录。
明细类问题可以补充“希望看到哪些信息”，例如账户名、国家、来源等。业务用户不需要知道底层字段名，只要说出业务上需要看的信息即可。
结合业务说明提问
如果管理员或分析师维护了业务说明、口径解释或文档资料，Analytics Agent 可以在回答中引用这些内容。
如何减少歧义
明确业务口径
如果一个词在公司里只有一种常用含义，可以直接问：
如果公司里有多个相近口径，可以用业务语言补充说明：
如果你不确定口径是什么，可以先问：
业务用户一般不需要写出
active_subscription = TRUE明确过滤条件
如果你只关心某个范围，可以直接说出来：
如果你知道要看哪些内容，也可以补充：
明确维度
如果你想做拆分对比，可以用“按什么拆开看”这样的说法：
也可以进一步说明要比较哪些结果：
明确时间范围
如果问题和趋势、增长、变化有关，补充业务上熟悉的时间范围通常会更稳妥。
如果不写时间范围，系统可能使用默认范围。默认范围不一定符合业务预期，因此趋势类问题更适合写上“最近 30 天”“今年以来”“本月和上月”等自然语言时间。
什么时候需要指定输出形式
Analytics Agent 会根据问题自动选择文字、表格或图表，但你也可以直接指定输出形式。
适合表格：
适合柱状图：
适合折线图：
适合饼图或环形图：
可以让系统继续追问
一次回答之后，可以继续围绕结果追问。
例如先问：
再追问：
追问时不一定需要重复完整上下文，但如果问题跨越多个业务对象，重新写清楚条件会更稳妥。
模型选择
在输入框左侧可以看到模型选择入口。模型能力和产品接入的模型清单更新很快，页面中实际可选模型会随产品版本、AI Gateway 接入情况、管理员配置和当前账号权限变化。
一般业务用户使用默认推荐模型即可。只有在管理员或分析师明确要求测试不同模型效果时，才需要切换模型。
如果你看到的模型列表与文档截图或他人页面不同，通常不是提问方式的问题。可能是当前网关还没有接入该模型、管理员没有启用该模型，或当前账号没有使用权限。业务用户通常不需要自行排查模型配置，可以联系管理员确认。
提问检查清单
提交问题前，可以快速检查：
- 是否选对分析域。
- 是否说清楚要看哪个业务对象，例如账户、订单、客户、商品。
- 是否说清楚想知道什么，例如数量、趋势、排名、占比、原因。
- 是否有明确范围，例如 Basic plan、某个地区、某个渠道。
- 趋势类问题是否写了自然语言时间范围。
- 明细类问题是否说出希望看到哪些业务信息。
- 业务口径容易混淆时，是否能用业务语言补充口径说明；如果不确定口径，可以直接询问当前分析域中的定义。
常见问题
问题太短，系统会怎样处理？
系统会根据分析域中的语义配置、指标、知识和上下文推断你的意图。问题越短，系统需要补充推断的地方越多，误解的概率也会更高。业务用户可以先简单问，再通过追问逐步补充条件。
我不知道字段名怎么办？
可以直接使用业务语言提问，例如“活跃账户”“取消率”“试用转化率”。字段名是配置者需要关心的事情，不是业务用户提问的前提。
如果系统总是误解某个词，应把问题反馈给分析域维护者，由维护者补充字段语义、指标或知识。
为什么同一个问题有时答案不一样？
可能原因包括：
- 数据发生变化。
- 分析域配置发生变化。
- 权限范围发生变化。
- 问题上下文不同。
- 使用的模型不同。
需要判断答案是否可信时，请查看答案下方的 SQL语句和记录。