1. 概述
1.1 版本
| 报表服务器版本 | 插件版本 |
|---|---|
| 11.0 | V1.0.2 |
注：使用过程中如有疑问请联系技术支持进行咨询。
1.2 功能简介
为提升报表开发效率，降低业务人员使用门槛，FineReport 推出 AI 助手 插件。该功能面向 FineReport 报表开发用户，借助自然语言理解技术，智能辅助用户完成报表设计，大幅提升开发效率。
AI 助手目前支持以下能力：
智能代码生成与解读：支持通过需求描述自动生成 JavaScript、公式、SQL 等脚本，并可对已有代码进行逐句解读，便于理解与修改。
图表自动生成：根据用户需求自动推荐合适图表类型，并完成图表数据绑定与样式配置，减少手动设置。
智能表格构建：自动填充表格数据内容，智能生成标题、字段名称等，提高表格制作效率。
模板开发辅助：支持通过简单描述快速生成报表或可视化看板，包括内部数据集、图表和表格等内容；同时可对当前已有模板结构与数据逻辑进行智能解析，帮助用户快速理解与优化。
帮助文档搜查：支持用户根据需求进行提问，基于最新版本帮助文档提供准确且详细的解决方案。
AI 助手为报表开发提供了从 生成 到 解读 的全流程智能支持，进一步降低了报表搭建的技术门槛，适用于日常开发、快速原型搭建、复杂模板理解等多类场景。
注：AI 助手不会将预览后的实际数据发送给大模型，仅向大模型提供当前模板的结构信息、数据库表的字段信息，以及在涉及数据集生成时传递极少量示例数据。
1.3 视频介绍
2. 插件简介
2.1 插件安装
点击下载插件：FR模板制作AI助手（Beta）
设计器插件安装方法参照：设计器插件管理
服务器安装插件方法参照：服务器插件管理
2.2 前期准备
插件安装后，设计器菜单栏会出现「AI 助手」设置项，点击「模型配置」即可在 AI 助手弹窗进行配置。如下图所示：
1）对话模型
对话模型中需填写 API URL、模型名称和 API KEY。
请尽量使用 deepseek v3，对应 API KEY 可以从模型厂商平台获取，部分平台的 deepseek v3 模型配置方式如下表所示：
| 平台 | 地址和模型名称 | API KEY |
|---|---|---|
| 火山引擎 | API URL：https://ark.cn-beijing.volces.com/api/v3 模型名称：deepseek-v3-250324 | 1）在左侧「开通管理」中搜索 DeepSeek-v3 模型，点击右侧「开通服务」进行开通 2）开通后在「API KEY 管理」中创建并复制 API KEY |
| DeepSeek | API URL：https://api.deepseek.com 模型名称：deepseek-chat | 创建并复制 API KEY |
2）RAG增强生成
开启 RAG 增强生成可以提高 JavaScript 、公式的生成准确性，有两种方式以供选择：
知识图谱增强：无需自行配置的向量模型，默认选择。
向量模型增强：需填写 API URL、模型名称和 API 密钥。需要使用 豆包 的向量模型。
2.3 功能入口
2.3.1 菜单栏
设计器菜单栏「AI 助手」支持三种助手的入口：
帮助文档助手：报表使用问题
报表模板制作助手：设计器使用和模板制作问题
Dashboard看板制作助手：大屏看板制作问题
2.3.2 侧边栏
报表右侧属性面板中点击「AI 助手」即可打开 AI 助手页面。
支持选择「模板制作」、「表格」、「图表」和「帮助文档」Tab 进行提问。
2.3.3 单项入口
1）JavaScript 助手入口
在「超级链接-JavaScript」配置页面点击「JavaScript 助手」按钮即可唤起页面。
以普通报表右侧单元格属性中的超级链接为例，如下图所示：
注：FVS 可视化看板内「JavaScript助手」入口与普通报表一致。
2）公式助手入口
在「公式编辑器」内点击右侧「公式助手」即可唤起页面。
以在普通报表单元格内插入公式为例，如下图所示：
注：FVS 可视化看板内「公式助手」入口与普通报表一致。
3）SQL 助手入口
在数据库查询界面，点击「AI 辅助」按钮即可唤起 SQL 助手。如下图所示：
3. 功能使用说明
3.1 如何提问
在 AI 助手问答界面，在对话框中输入对应需求即可。
为获得更准确、高效的解答，建议参考 AI 助手对话界面中的示例提问方式，或遵循以下提问规则：
简洁明确：每次仅提出一个具体问题，避免多个问题同时堆叠，便于 AI 助手准确识别需求。
拆分复杂问题：对于复杂需求，建议将其拆解为多个步骤，逐步提问，提升理解和响应效率。
补充关键信息：提供必要的背景信息，有助于 AI 更准确判断制作需求。
灵活调整提问方式：若首次提问未获得理想答案，可尝试更换表述或细化问题，以获取更优解答。
3.2 问题反馈
我们非常重视你的意见和体验。为此，我们特别设置了点赞和点踩功能，方便你对 AI 助手的回答做出直观反馈。
如果你对当前解答感到满意，欢迎点击“赞”，这将帮助我们识别优质内容，持续优化用户体验；
如果解答未能满足你的需求，你可以点击“踩”，我们将收到此反馈，并会持续改进，确保未来提供更加精准和高效的服务。
也可点击菜单栏「AI助手>需求反馈」进行反馈。
你的每一次反馈都对 AI 助手的成长至关重要，期待你与我们一起推动产品的不断进步！
3.3 对话管理
如果新类型的需求，建议新开一个对话，减少上下文对答案的影响，避免出现与问题无关的答案。
如果你发现 AI 助手提供了不符合需求或错误的结果，可以尝试新建一个对话，换一种方式重新提问。新建对话可以清除之前的上下文，让 AI 助手更好地理解你的新问题。
3.4 数据连接选择
支持用户进行数据连接。
选择数据连接，提问内容根据确定的数据内容进行输出；
未选数据连接，将在给出问题结果后推荐设计器中可用的数据集。
3.5 问题和局限性
请注意，虽然 AI 助手可以帮助解决大多数问题，但它也有一定的局限性：
可能出现错误：AI 的回答基于训练数据和模型理解，可能会有不准确或不完整的情况。建议在收到回答后，根据实际情况进行判断。
回答局限性：对于非常复杂或特定场景的问题，AI 助手可能无法提供满意的解答。此时，建议你简化问题，分步提问。
4. 功能介绍
4.1 表格助手
表格助手支持基于当前模板中的数据集和业务需求，自动生成常见类型的表格，帮助用户快速完成数据展示与表格布局。
当前支持的功能包括：
智能生成表格：可根据已有数据集和需求描述自动生成对应表格，当前支持生成分组汇总表和明细表。
单元格问答调整：支持对指定单元格进行提问，快速了解其计算逻辑、来源数据等内容。
单元格配置优化：支持对单元格进行属性级调整，例如设置条件属性、格式样式等。
可在 AI 助手全局入口的「模板制作」Tab 中直接进行表格相关提问，或切换至「表格」Tab 后提问。如下图所示：
4.2 图表助手
图表助手可基于当前模板中的数据集和需求，智能生成符合场景的图表，并自动完成数据绑定与样式配置，显著简化图表制作流程。
核心功能包括：
图表智能生成：根据已有数据集和需求描述，自动推荐合适的图表类型（如柱状图、折线图、饼图等），并完成数据字段绑定和样式设置，快速呈现可视化效果。
图表智能调整：支持通过对话方式对已生成图表进行调整，如修改图表类型、更新绑定字段、优化样式配置等，提升交互效率与灵活性。
可在 AI 助手全局入口的「模板制作」Tab 中直接进行图表相关提问，或切换至「图表」Tab 后提问。如下图所示：
4.3 帮助文档助手
FineReport 文档助手可以解答在设计器使用功能上或流程上的疑问，帮助您使用充分利用 FineReport 文档，快速上手报表开发。
制作普通报表时，可在 AI 助手全局入口的「模板制作」Tab 中直接进行图表相关提问，或切换至「帮助文档」Tab 后提问，如下图所示：
制作可视化看板时，请使用菜单栏入口进行提问。
4.4 JavaScript 助手
JavaScript 助手可以帮助用户快速生成、理解和调整 JavaScript 脚本，用于满足报表中的各类交互和逻辑需求。
可在 AI 助手全局入口的「模板制作」Tab 中直接进行 JavaScript 相关提问，或在 JavaScript 脚本编辑界面点击「JavaScript 助手」按钮后进行提问。如下图所示：
进入对话界面后，将自动推荐常见问法，帮助用户快速上手。
支持通过需求描述生成对应的 JS 代码，并对其中的关键逻辑进行解释，便于理解和直接使用。
可基于上下文进行多轮提问，进一步展开逻辑说明，或对已有 JS 脚本进行补充、修改与优化。
4.5 公式助手
公式助手可以辅助用户生成、理解和调整报表中的各类公式，适用于数据计算、逻辑判断、条件格式等场景。
可在 AI 助手全局入口的「模板制作」Tab 中直接进行公式相关提问，或在公式编辑器中点击「公式助手」按钮后进行提问。如下图所示：
进入对话界面后，系统将推荐常见问法，帮助用户快速开始使用。
支持根据用户需求自动生成对应公式，并对关键逻辑进行逐步解释，便于理解与直接引用。
支持基于上下文的多轮问答，可进一步展开公式说明，或对已有公式进行调整与优化。
4.6 SQL 助手
数据集 SQL 助手支持智能生成 SQL 语句并创建数据集，简化数据查询与建模流程。
可在 AI 助手全局入口的「模板制作」Tab 中直接进行 SQL 相关提问，或在数据库查询界面中点击「SQL助手」按钮后进行提问。如下图所示：
基于需求描述，自动调用数据连接，识别相关数据表及字段结构，生成对应 SQL 查询语句。用户确认后，可一键生成数据集，并自动完成命名。
支持通过多轮对话对 SQL 语句进行修改与优化，满足更复杂的业务逻辑需求。
数据集创建完成后，助手将根据数据结构自动推荐后续操作，如生成表格分析或图表分析，帮助用户快速进入可视化设计阶段。
4.7 模板制作助手
模板制作助手可以辅助用户理解当前模板结构或快速生成所需内容，提升报表设计效率。
在 AI 助手全局入口处选择「模板制作」Tab，即可进入模板制作助手页面。如下图所示：
可对当前已有模板进行结构与内容分析，帮助用户快速了解数据集、图表、表格及交互逻辑的构成关系。
支持直接输入业务需求，自动生成包含数据集、图表、表格等元素的完整模板。
支持针对表格、图表、JavaScript、公式及 SQL 内容进行提问与辅助配置，满足不同开发环节的需求。
4.8 Dashboard 助手
Dashboard 助手可以辅助用户理解当前看板结构或快速生成所需内容，提升可视化看板设计和开发的效率。
注：仅支持 FVS V4.1.0 及以上版本。
核心功能包括：
看板设计：可以根据需求描述，给出对应的模板设计思路和相应的开发步骤，辅助可视化看板制作。
看板制作：根据已有数据集和需求描述，自动推荐合适的图表类型（如柱状图、折线图、饼图等），并完成数据字段绑定和样式设置，快速呈现可视化效果。若没有数据集也可以自动生成符合需求的数据集进行数据字段绑定。
可在使用菜单栏入口进行相关提问，或点击 AI助手 悬浮按钮提问。如下图所示：
5.常见问题
5.1 大模型配置
推荐使用 DeepSeek-V3 模型。当前也支持对接兼容 OpenAI 的云模型使用。
注：不提供大模型配置服务，需用户自行完成大模型服务的配置与管理。
对接的大模型需对 Function Call 有良好支持，且需支持 Open AI 协议。由于以上约束和性能方面的考量，目前暂不适配本地私有化部署的大模型方案。
5.2 数据安全
公式助手、JavaScript 助手、帮助文档智能问答助手：不涉及客户的实际数据。
SQL 助手、模板制作助手和Dashboard 助手：预览操作不会将实际业务数据发送至大模型。但为了生成的准确性，会把当前模板内容和结构信息、数据库表字段信息和极少量示例数据（涉及数据集制作时）发送至大模型。
5.3 异常情况
5.3.1 报错Insufficient Balance
问题描述：
提问后回复报错 Insufficient Balance。
原因分析：
token 次数用尽，建议进行充值或更换平台继续使用免费 token。
5.3.2 设计器侧边栏宽度无法调整
设计器侧边栏宽度支持调整，若安装「FR模板制作AI助手(Beta)」后无法调整，建议重启设计器再进行尝试。
上一篇：功能模块进阶学习指南
