智能分析 Agent 为您提供洞察报告能力,当您需要对业务中的例行分析场景(如日报、周报、月报)进行数据分析,并期望基于现有数据集或仪表盘图表,由大模型自动生成稳定、可靠的分析报告时,您可使用洞察报告功能。本文为您介绍洞察报告的功能概述和操作要点。
功能概述
智能分析Agent的洞察报告支持基于已有的数据集/图表/知识、分析结论等内容元素,通过灵活、自由地拖拽,来组合搭建,最终生成符合业务分析场景的报告框架。

当前版本主要支持基于以下三大内容元素模块来搭建报告:
- 文字块:支持富文本编辑,用于撰写分析背景、结论摘要、数据口径说明等固定内容。
- AI 分析:报告的核心分析单元。需绑定数据源(数据集/图表)并输入分析指令,由大模型输出具体的分析结论与洞察。
- AI 总结:基于自然语言指令,对已生成的文字块和AI 分析模块的内容进行二次归纳、提炼或对比,形成最终结论。
注意与前提
- 洞察报告功能自3.4.0版本开始支持,且功能默认关闭,如果您希望使用此功能,可联系火山引擎技术支持人员打开功能开关。
- 在使用洞察报告功能前,您必须先创建并配置好一个自定义智能体。自定义智能体是洞察报告能力的执行主体,您需要为其配置包括但不限于基础信息(名称、描述)、关联数据源(为洞察报告提供分析数据)等。
说明
- 智能分析Agent为您预置了一个通用智能体,当前通用智能体不支持体验洞察报告的功能。您需要基于自定义智能体搭建使用洞察报告。通用智能体与自定义智能体的差异和介绍详情请参见智能体类型说明:通用&自定义智能体。
- 创建并配置自定义智能体的操作请参见创建与配置流程速览。
- 当前搭建洞察报告时,如果您已联合部署了智能数据洞察(DataWind),支持直接基于DataWind的可视化图表来搭建报告内容模块。
搭建洞察报告
通用操作指导
创建好自定义智能体并打开洞察报告功能开关后,您可以在智能体使用页面单击洞察报告页签,进入洞察报告页面后单击新建报告,即可开始搭建洞察报告。

进入洞察报告配置页面后,您可以在页面的左上角先修改报告名称。

后续您可以基于文字块、AI分析、AI总结三类内容元素来搭建洞察报告的内容框架。

各内容元素的搭建指导如下。
文字块

细分 | 使用指导详情 |
|---|
适用场景 | 对标例行报告的导读、附录等固定内容部分。您可以通过此模块自定义任何文本内容,例如报告一级标题、分析背景、报告分析日期、核心结论摘要、指标口径解释等。 |
功能限制 | - 字数限制:不超过 2000 字。
- 支持的富文本格式:
- 字体样式:加粗、斜体、下划线、删除线
- 段落结构:一级标题(H1)、二级标题(H2)、三级标题(H3)、四级标题(H4)、正文、引用
- 列表:有序列表、无序列表
- 对齐方式:左对齐、居中、右对齐
- 文字颜色(特别适用于数据解读,如用红色表示下降,绿色表示增长)
- 超链接:可添加链接,指向相关的数据分析仪表盘或外部文档。
|
AI 分析
细分 | 使用指导详情 |
|---|
适用场景 | 例行报告的核心部分。您可以在此模块中选择一个或多个数据源(数据集、仪表盘图表),并通过输入自然语言指令,要求大模型对指定的数据进行深度解读与分析。 |
功能限制 | - 数据源选择:支持选择多个数据集或者仪表盘图表进行分析。
- 指令输入框:支持通过文字描述分析要求,限制不超过 2000 字。
- 支持选择知识:支持开启联网搜索,或者选择「飞书企业知识」或者「智能体内置知识」来辅助分析。
|
操作指导 | - 选择数据集。根据业务报告的分析需要选择当前内容模块相关的数据集。
 - 仅展示当前智能体已经配置,且使用用户有权限的数据集。
- 支持搜索,展示搜索词匹配下的所有数据集,支持勾选,清空搜索词则恢复展示所有数据集
- 选择可视化图表。如果您还联系部署了智能数据洞察(DataWind),您也可以在此处直接选择业务报告相关的可视化图表。
 - 您可以直接插入DataWind的可视化图表链接(可视化查询链接方式);也可以基于项目进行手动选择(级联选择方式),支持通过搜索关键词匹配相关图表。
- 您可以选择/插入有权限的图表(图表在DataWind控制台的功能菜单位置为:项目>仪表盘>sheet>图表) 。
- 选择可视化图表时,可选择是否“同时接入数据集”,如果当前报告模块需要「归因分析、异常检测」等分析方式时,建议同时接入数据集(自动过滤无权限的数据集)。
- 选择知识。

如果当前模块的数据/图表分析需要结合一些必要的业务背景知识,您可以将知识上传至智能分析Agent后,在此处选用对应的知识。 - 开启联网搜索、拓展等功能。您可按需选择是否需要同步开启联网搜索、SQL、python等工具,以便提高分析结果的准确性。
- 输入分析要求并执行分析,确认分析结果。

等待AI分析完成后,您可查看分析结是否符合预期,基于分析结果来调试数据集/图表、知识、分析要求描述等配置。
|
AI 总结
细分 | 使用指导详情 |
|---|
适用场景 | 例行报告的总结部分,可以在此选择已生成的 AI 分析块,并且输入需要对 AI 分析块进行的关联总结,对多个模块的结论进行二次总结、摘要、推理。 |
操作指导 | - 选择AI分析模块。支持选择任意已添加的AI 分析模块(上限 30 个)。
- 选择知识,并按需选择是否开启联网搜索。
- 输入报告总结的要求描述。支持通过文字描述解读分析要求,限制不超过 2000 字。
|
高级功能:配置并使用报告变量
当前为您提供了报告的全局变量能力,如果您有一些文本或数字变量,可能会在不同时期、不同场景下需要调整变化,您可使用全局变量功能。
- 添加变量。您可以在洞察报告配置页面的顶端单击“{n}变量”按钮来添加全局变量。

- 在弹出的侧边栏中,添加变量,并配置变量类型和取值。

当前支持文本和数值类的变量。 - 在报告中引用变量。您可以在报告的文字编辑框处使用“@”来引用变量。

- 修改变量。如果后续您需要调整变量取值,可单击编辑变量修改取值,完成后刷新一下洞察报告,即可自动将引用的变量取值替换为最新的取值。
预览、保存与发布

- 完成洞察报告的配置后,您可单击“预览”按钮,分别预览网页和文档形式的报告结果。
- 预览无误后,您可以单击右上角的保存“”按钮,将配置结果保存下来。后续即可在智能分析Agent的使用页面中查看到对应的报告。
- 如果您希望将此报告共享给所有人查看,您可单击“发布为公共模板”按钮,根据界面提示完成发布,发布后,所有智能体使用者均可查看到此洞察报告。
参考:洞察报告示例
- 报告背景:需要对健身房的不同性别用户进行用户画像分析,并且对比不同性别用户的差异,给出运营建议。
- 报告框架:文字块 -> AI 分析 1 -> AI 分析 2 -> AI 总结
- 文字块:报告介绍
- AI 分析 1:女性用户数据分析报告
- AI 分析 2:男性用户数据分析报告
- AI 总结:男性和女性用户的差异分析以及运营建议
- 最终报告展示:
常见问题
Q1. 洞察报告和深度研究的差异是什么?
对比项 | 洞察报告 | 深度研究 |
|---|
适用场景 | 例行报告(日报|周报|日报|固定主题分析报告) | 自由提问 |
数据源 | ABI仪表盘|ABI数据集 | 仅支持ABI数据集 |
报告结构 | 用户自行定制更多,报告框架更固定 | 模型自由发挥更多,报告框架不一定固定 |
生成时间 | 同类报告更短
每个模块可并行生成结果 | 同类报告更长
提问后一次性生成结果 |