数据智能体
数据智能体
- 文档首页
数据智能体智能分析 Agent使用智能分析Agent洞察报告
文档反馈
问问助手智能分析 Agent 为您提供洞察报告能力，当您需要对业务中的例行分析场景（如日报、周报、月报）进行数据分析，并期望基于现有数据集或仪表盘图表，由大模型自动生成稳定、可靠的分析报告时，您可使用洞察报告功能。本文为您介绍洞察报告的功能概述和操作要点。
智能分析Agent的洞察报告支持基于已有的数据集/图表/知识、分析结论等内容元素，通过灵活、自由地拖拽，来组合搭建，最终生成符合业务分析场景的报告框架。当前版本主要支持基于文字块、AI分析、AI总结三大内容元素模块来搭建洞察报告模板。
- 文字块：支持富文本编辑，用于撰写分析背景、结论摘要、数据口径说明等固定内容。
- AI 分析：报告的核心分析单元。需绑定数据源（数据集/图表）并输入分析指令，由大模型输出具体的分析结论与洞察。
- AI 总结：基于自然语言指令，对已生成的AI 分析模块的内容进行二次归纳、提炼或对比，形成最终结论。
- 洞察报告功能自3.4.0版本开始支持（灰度中），且功能默认关闭，如果您希望使用此功能，可联系火山引擎技术支持人员打开功能开关。
- 在使用洞察报告功能前，您必须先创建并配置好一个自定义智能体。自定义智能体是洞察报告能力的执行主体，您需要为其配置包括但不限于基础信息（名称、描述）、关联数据源（为洞察报告提供分析数据）等。
说明
- 智能分析Agent为您预置了一个通用智能体，当前通用智能体不支持体验洞察报告的功能。您需要基于自定义智能体搭建使用洞察报告。通用智能体与自定义智能体的差异和介绍详情请参见智能体类型说明：通用&自定义智能体。
- 创建并配置自定义智能体的操作请参见创建与配置流程速览。
- 当前搭建洞察报告时，如果您已联合部署了智能数据洞察（DataWind），支持直接基于DataWind的可视化图表来搭建报告内容模块。
创建好自定义智能体并打开洞察报告功能开关后，您可以在智能体使用页面单击洞察报告页签，进入洞察报告页面后单击新建报告，即可开始搭建洞察报告。
进入洞察报告配置页面后，您可以在页面的左上角先修改报告名称。
后续您可以基于文字块、AI分析、AI总结三类内容元素来搭建洞察报告的内容框架。
各内容元素的搭建指导如下。
文字块
细分 | 使用指导详情 |
|---|---|
适用场景 | 对标例行报告的导读、附录等固定内容部分。您可以通过此模块自定义任何文本内容，例如报告一级标题、分析背景、报告分析日期、核心结论摘要、指标口径解释等。 |
功能限制 |
|
AI 分析
细分 | 使用指导详情 |
|---|---|
适用场景 | 例行报告的核心部分。您可以在此模块中选择一个或多个数据源（数据集、仪表盘图表），并通过输入自然语言指令，要求大模型对指定的数据进行深度解读与分析。 |
功能限制 |
|
操作指导 |
|
分析结果回溯验证 | 如果您希望查看分析结果的详细分析过程和执行细节，您可单击对应分析模块，右侧弹出的页面会为您展示详细的分析过程。
|
AI 总结
细分 | 使用指导详情 |
|---|---|
适用场景 | 例行报告的总结部分，可以在此选择已生成的 AI 分析块，并且输入需要对 AI 分析块进行的关联总结，对多个模块的结论进行二次总结、摘要、推理。 |
操作指导 |
|
实践经验
细分 | 实践经验建议 |
|---|---|
模块规划 |
|
数据源 |
|
提示词 |
|
工具 |
|
洞察报告配置示例可参见下文参考：洞察报告示例。
设置参考结果
洞察报告为您提供“设置参考结果”的功能。在编辑洞察报告模板时，测试报告生成结果过程中，当报告内容质量较好时，您可以本次的分析模版配置设置为参考样本，后续每次报告生成时，均会参考样本的分析思路、分析内容结构等进行报告结果生成，可提高分析报告内容生成质量。
编辑状态下设置为高质量结果为参考结果 | 后续报告生成结果中查看/去除参考详情 |
|---|---|
|
|
引用DataWind图表
搭建洞察报告模板时，建议尽可能多使用DataWind的图表而非数据集，因为图表相较于数据集 N 个字段的取数，数据更加稳定。您可以在配置AI分析模块时，选择接入图表。
- 支持接入的图表范围包含DataWind可视化查询结果、仪表盘图表。
- 图表接入后，由大模型基于分析任务的提示词判断是否直接引用已接入的DataWind可视化图表。
- 在分析任务提示词输入框中，您可以明确要求需要包含某些图表，这样报告生成结果中展示对应图表的概率会更高。
- 例如，提示词包含：报告中需要包含“图表名称”。
- 直接展示引用对应图表的时候，只引用图表内容本身，不包括图表标题等额外信息。
- 注意：
- 如果您的报告查询DataWind可视化图表时，需灵活修改图表的筛选条件取值，则您需要结合报告变量能力，配置变量关联可视化图表的筛选器，详情可参见下文的 配置并使用报告变量 章节。
- 如果没有通过变量关联可视化图表的筛选器，则引用图表进行报告内容生成时，会直接使用可视化图表按默认筛选器取值过滤后的数据作为数据源。
配置并使用报告变量
当前为您提供了报告的全局变量能力，如果您有一些文本或数字变量，可能会在不同时期、不同场景下需要调整变化，您可使用全局变量功能。
添加变量
- 添加变量。您可以在洞察报告配置页面的顶端单击“{n}变量”按钮来添加全局变量。
- 在弹出的侧边栏中，添加变量，并配置变量类型和取值。
当前支持文本、日期、数值类的变量。对于日期类的变量，支持灵活设置动态日期（天/周/月时间粒度）或固定日期的变量取值。
关联筛选器
当前已经支持通过变量关联DataWind可视化查询的图表的筛选器进行联动使用，可实现关联DataWind可视化图表筛选器，进行动态查询。
- 准备工作。
- 在DataWind中，配置DataWind可视化查询图表筛选器，并勾选“自动查询”。
- 在智能分析Agent中，添加引用的DataWind图表。
- 在DataWind中，配置DataWind可视化查询图表筛选器，并勾选“自动查询”。
- 配置洞察报告变量与DataWind可视化图表的筛选器关联。
在弹出的页面中配置变量与可视化图表筛选器的关联关系。每个变量可选择和多个模块、图表进行绑定，但是变量类型（比如文本、日期、数值）需要与关联筛选器类型保持一致。- 变量类型为日期，则绑定的图表筛选器类型必须为日期或者文本；
- 若变量类型为文本，则绑定的图表筛选器类型必须为文本；
- 若变量类型为数值，则绑定的图表筛选器类型必须为数值。
- 完成上述配置后，可参考下文引用变量，则在生成洞察报告时，可自动将引用的可视化图表的筛选器取值替换为变量取值，将可视化图表按变量取值筛选后作为分析报告的数据来源。
引用变量
您可以在报告的文字编辑框处使用“@”来引用变量。
修改变量
如果后续您需要调整变量取值，可单击编辑变量修改取值，完成后刷新一下洞察报告，即可自动将引用的变量取值替换为最新的取值。
删除变量
如果您不再需要某变量，可在全局变量列表中单击删除，单击确认后，即可删除对应变量。
注意
删除该变量，对应模板中对应变量均会被删除。
- 完成洞察报告的配置后，您可单击“预览”按钮，分别预览网页和文档形式的报告结果。
- 预览无误后，您可以单击右上角的保存“”按钮，将配置结果保存下来。后续即可在智能分析Agent的使用页面中查看到对应的报告。
洞察报告支持将报告模板进行归档，归档后，后续您可在归档的历史版本中查看、快速还原各个历史版本的报告模板。 - 如果您希望将此报告共享给所有人查看，您可单击“发布为公共模板”按钮，根据界面提示完成发布，发布后，所有智能体使用者均可查看到此洞察报告。
- 报告背景：需要对健身房的不同性别用户进行用户画像分析，并且对比不同性别用户的差异，给出运营建议。
- 报告框架：文字块 -> AI 分析 1 -> AI 分析 2 -> AI 总结
- 文字块：报告介绍
- AI 分析 1：女性用户数据分析报告
- AI 分析 2：男性用户数据分析报告
- AI 总结：男性和女性用户的差异分析以及运营建议
- 最终报告展示：
Q1. 洞察报告和深度研究的差异是什么？
对比项 | 洞察报告 | 深度研究 |
|---|---|---|
适用场景 | 例行报告（日报｜周报｜日报｜固定主题分析报告） | 自由提问 |
数据源 | ABI仪表盘｜ABI数据集 | 仅支持ABI数据集 |
报告结构 | 用户自行定制更多，报告框架更固定 | 模型自由发挥更多，报告框架不一定固定 |
生成时间 | 同类报告更短 | 同类报告更长 |