洞察智能体
概述
洞察智能体适用于用户针对某个业务问题进行分析调研的场景。当用户提出此类需求时，系统会自动进行规划，并调用相关工具，对业务问题展开深入分析，最终生成图文并茂的报告。该报告不仅能呈现业务现状，还能挖掘背后的原因、趋势等，为用户提供全面且有价值的洞察，例如回答 " 最近销售表现怎么样 " 这类业务分析问题，为决策提供有力支持。
前提条件
拥有 ChatBI 「查看」权限的用户，才可进入「洞察智能体」页面进行提问。
操作步骤
-
点击左侧导航栏的「洞察智能体」，进入洞察分析页面。
-
选择需要进行洞察分析的智能体，支持通过搜索框搜索需要的智能体。
-
点击推荐问题或输入问题并发送。在短时间内有大量用户同时提问时，提交的问题可能进入排队状态。用户可在对话区域查看「正在排队」提示、当前排队位置和已等待时间，了解任务进度。有空位后，系统会自动开始处理问题，无需重复提交。
系统开始处理后，会自动完成任务规划，进行不同工具的调用组合，最终生成图文结合的分析报告。当前可调用的工具列表如下：
| 工具名称 | 功能描述 | 截图说明 |
|---|---|---|
| 知识检索 | 从知识库中召回与用户问题相关的知识，用于构建分析背景与结构化回复。 |  |
| 数据查询 | 将用户问题转化为 SQL，通过计算引擎执行，返回结构化数据结果。 |  |
| Python 生成 | 将任务拆解为 Python 脚本执行，适用于复杂数据处理与可视化场景。 |  |
| 联网搜索 | 实时从公网获取相关信息，补充数据来源或验证结论。 说明：环境需通公网。 |  |
功能介绍
查看当前对话数据集
推荐问题
推荐关联问题
收藏
反馈
清空上下文
添加常用问题
输入联想
消息 ID
新开会话交互
个性化记忆
语音问答
问数可视化
洞察智能体在回答简单 L1 问数问题时，查询结果与 L1 保持一致，支持 查看分析参数、切换可视化、设置轴刻度、推荐关联问题 等操作，兼顾轻量问答的便捷性与深度分析的扩展性。
报告展示
报告生成完成后，在右侧默认展开报告内容。
当报告中的表格宽度超出屏幕时，表格底部会显示横向滚动条，拖动滚动条可查看右侧的全部列。
全屏查看报告
洞察报告支持全屏查看，便于在更大的展示区域中阅读报告内容。
报告生成后，打开需要查看的报告，点击报告右上角的「全屏」，即可进入全屏查看模式。
查看数据来源
洞察分析报告支持查看数据来源，便于追溯报告结论的数据依据，提升分析结果的可信度与可解释性。
前提条件
已在「智能体详情配置 > 基础信息 > 功能开关配置 > 洞察」中，开启「数据引用依据」功能。
操作步骤
在生成的报告页面中，点击对应结论旁的数字角标，即可查看该结论所依赖的具体数据信息，包括使用的数据集、SQL 查询逻辑等。
若用户对报告内容进行手动编辑并保存，原结论旁的数据来源角标将不再显示。因为修改后的内容由人工产生，系统无法继续保证其结论的可信度与可解释性，故不再提供数据来源追溯标识。
复制结论
洞察分析报告支持一键复制全文，复制后以 markdown 格式粘贴。
导出
在洞察分析报告右上角点击「导出」，可将报告导出为 PDF、Word 或 Excel 文件。PDF 和 Word 文件包含报告中的文本与图表，并保留报告的展示效果；Excel 文件包含报告中的全部表格。
当报告中的表格宽度超出屏幕显示范围时，导出的 PDF 仍会完整保留所有列，右侧内容不会被截断。
导出多轮对话结果
洞察分析支持将洞察模式下多轮对话产生的数据结果，一次性整理并导出为一个多 Sheet 数据文件（通常为 Excel），便于后续线下复盘、汇报或二次加工。
适用场景
适用于用户围绕同一主题连续进行多轮分析，且有多轮回答产生了可结构化的表格或明细数据。例如：
- 本月销售额是多少？
- 按区域拆分？
- 按门店拆分？
- 同比环比如何？
- 异常门店有哪些？
完成上述多轮分析后，用户可将各轮结果汇总导出，生成包含多个 Sheet 的数据文件，例如：
- Sheet1：整体销售概览
- Sheet2：区域销售拆分
- Sheet3：门店明细
- Sheet4：同比环比分析
- Sheet5：异常门店清单
操作步骤
- 进入 ChatBI 「洞察智能体」页面，围绕同一分析主题连续进行多轮提问。
- 提问完成后，在对话框中输入导出指令，例如：
帮我把上面的对话结果汇总生成一个Excel，系统会自动把结果汇总成一份多 Sheet 页 Excel。
- 点击「下载文件」后打开 Excel 查看，可看到每个分析结果对应一个 Sheet 页。
注意事项
- 仅当对话轮次产生了数据表格或可结构化结果时，才适合生成对应 Sheet；纯文字解释、结论总结类回答通常不会单独生成数据 Sheet。
- 导出的数据仍受用户的数据权限、行数限制及字段权限控制。
- 若多轮对话中的业务口径不一致，导出的多个 Sheet 会保留各自的查询结果，系统不会自动统一口径。
- 文件生成后，建议核对每个 Sheet 的标题、时间范围、筛选条件及数据行数，确保与预期一致。
使用建议
为获得结构更清晰的数据文件，建议在 L2 洞察模式中按专题逐步提问，例如：
- 「先看本月整体销售表现」
- 「再按区域拆分」
- 「继续按门店拆分」
- 「找出销售额下降最多的门店」
- 「导出以上分析结果为多 Sheet 文件」
这样生成的数据文件结构更清楚，也更适合业务复盘或汇报使用。
推送
前提条件
-
若需要以邮件方式进行推送，则需要：
-
若需要以自定义渠道方式进行推送，则需要已配置完成 自定义渠道。
操作步骤
支持通过邮件或自定义渠道推送洞察报告。推送前，用户可以修改通知标题和内容，并通过富文本编辑器调整内容格式或插入图片。
-
在报告页面右上角，点击「推送」按钮，弹出「消息发送」弹窗。
-
在「通知渠道」中选择「邮件」或「自定义渠道」，并根据所选渠道完成页面展示的推送配置：
- 通知渠道
- 选择「邮件」时，设置发件人和收件人。
- 选择「自定义渠道」时，选择已配置的自定义渠道和收件人。
- 「通知标题」默认为报告标题，支持修改。
- 「通知内容」默认为报告正文，报告中的图表会转换为图片插入正文，支持富文本编辑。
- 通知渠道
-
完成配置后，点击右下角「确定」，系统将通过所选渠道推送洞察报告。
说明若系统提示发送失败，请根据所选通知渠道检查相关配置：
- 选择「邮件」时，检查收件人的邮箱地址和邮件服务配置；
- 选择「自定义渠道」时，检查自定义渠道是否配置正确且可用。
SQL 详情查看与复制
在洞察分析过程中，当系统调用数据查询工具时，系统支持查看 SQL 详情与一键复制 SQL。
- 查看 SQL 详情：点击数据查询卡片，展开查看生成的 SQL 语句；
- 一键复制：点击复制按钮，将 SQL 语句复制到剪贴板，可直接用于数仓查询或进一步分析。
分析专家调用
在洞察分析中，用户可以通过选中专家的方式调用预配置的分析专家，分析专家如何配置可参考 创建分析专家。
进入洞察页面后，选中需要使用的分析专家，系统将按照该专家预定义的分析思路自动生成报告。
在对话过程中，也可以点击输入框左上方「分析专家」按钮切换当前使用的分析专家；选择需要切换的专家后，系统跳转至全新对话页面，并自动帮您选中该分析专家，您发起提问后，系统将按照该专家预定义的分析思路生成报告。
上传文件进行分析
洞察智能体支持用户上传 Excel、CSV 文件作为补充数据源进行分析，系统会结合上传文件的内容与智能体内已有数据集进行联合分析，输出更贴合用户实际数据的洞察报告。
当上传的 Excel 文件包含多个 Sheet 页时，系统会自动解析各 Sheet 的数据。
适用场景：当用户存在临时分析需求，且所需分析数据未沉淀至 BI 数据集时，可通过上传本地 Excel/CSV 文件，快速获取数据洞察结果。
前提条件：已在 洞察 配置中开启「文件上传」。
操作步骤
- 在洞察智能体输入框区域，点击「上传文件」按钮。
- 在弹出的文件选择窗口中，选择本地的 Excel（.xlsx/.xls）或 CSV（.csv）文件，点击「打开」完成上传。
- 上传完成后，输入提问内容并发送，系统会结合上传的文件数据进行洞察分析。
- 单次上传文件大小与数量存在系统限制，超出限制将会提示用户重新调整后上传。
- 上传的文件仅在当前会话中生效，不会沉淀至智能体的数据集。
- 上传的数据文件保留天数由 洞察文件保留天数 决定，默认为 30 天。
超限提醒
系统内置查询数量限制，在洞察分析过程中，当数据查询结果触发以下阈值时，会在分析过程中给出相应提示：
-
查询超限：当数据查询的数据量超过 20000 行时，系统会在对应的数据查询步骤旁展示「查询超限」标签，提示「查询数据量超过系统上限：20000 行，已对数据进行裁切」。
-
数据处理：当解读数据超过 1000 个单元格时，系统会自动对数据进行加工处理，保障洞察分析结果全面完整；在加工处理的同时，会在超限的数据旁展示「数据处理」标签，提示「由于数据结果超过 1000 个单元格，系统已自动对数据进行加工处理，并对处理后的数据进行洞察分析」。
规划模式
前提条件
已在「智能体详情配置 > 基础信息 > 功能开关配置」中开启「规划模式」。
使用说明
在前台问答时，点击「规划」确认开启规划模式。
开启规划模式后，将稳定输出分析思路，直到用户确认思路，关闭规划模式后再进行报告生成。
如何获取更好的洞察分析效果？
大模型（LLM）的思考过程类似于人类，当我们希望公司新来的实习生能够针对某些智能体进行数据分析时，我们也需要告诉他业务同事实际会从哪些视角思考问题，需要哪些指标来进行数据支撑。
因此，在使用「洞察分析」功能前，我们建议先在 业务知识库 完成相关思维链的配置，以「销售情况」场景为例，可以根据企业实际情况进行修改：
当用户询问一个时间段内销售情况怎么样时？比如
<本周/本月><整体/某区域/某产品>销售表现怎么样？<某区域/某产品（举例：华东区域/产品A）>在一个时间段内销售额/销量有多少？
类似以上的问题，都是询问整体或特定维度的销售表现，如果问题中没有明确时间段，默认指本月。
请按照以下思路逐层深入分析，整体报告运用金字塔原理，总结所有分析结论，输出完整正式报告（分段撰写，分析过程中不需要暂停来询问客户的输入，或者询问是否继续输出，请自动进行下面全部的分析过程），无需赘述最后一步的分析过程。`
<统计时间段内><整体/或指定维度>的总销售额、总销量分别是多少，客单价为多少（客单价=总销售额/总销量）。如果没有销售数据，则展示0。<展示<统计时间段内><整体/或指定维度>的销售额/销量与目标值、历史同期的对比情况，包括完成率、同比增长率、环比增长率（从关键维度优先展示）。<查询并展示<统计时间段内><整体/或指定维度>按照产品/区域/渠道等细分维度统计的销售额/销量及占比（从多到少进行展示）。<进一步展示<统计时间段内><整体/或指定维度>各细分维度下的销售明细数据（表格展示），使用limit 10来限制展示数量，避免数据行数太多。