1. 概述

1.1应用场景

奥威BI+AI智能体,通过自然语言获取到决策者想要得到的数据。

常用场景：（1）对话式获取数据（2）投喂数据后做洞察生成分析报告。

1.2 AI应用视频

①手把手教你一步一步通过AI助手生成利润表分析报告

②AI助手之利润表分析报告

③AI助手之按模板生成描述性文字

④AI助手之EXCEL数据源

⑤AI助手示例

1.3 私有化BI使用AI助手注意事项（生成报告前必须操作）

1.3.1检查BI的./ourwaybi/bi-full/路径下是否有./local-bower文件夹，且文件夹内有驱动文件，初次使用AI助手时，若无该文件可以点击下方地址进行下载，下载后解压放在BI对应路径中，Linux和windows驱动有差别，下载时请注意。

windows驱动下载            Linux驱动下载

1.3.2在系统管理-系统配置-日志订阅-报表设置中，配置本机BI访问地址的信息.

2. 操作入口

目前系统中有两个AI助手的入口

①当我们想基于一个数据源中的所有报表数据集向AI助手获取数据时，即可从首页顶部工具栏进入AI助手，则默认勾选所有报表数据集。（由于AI助手一次只能针对一个数据源中进行提问，在BI中连接了多个数据源的情况下，首次更推荐使用第二种方式进入AI助手，想要基于哪个数据源提问，则点击该数据源下的报表浏览页进入AI助手。）

②当我们想针对某张报表快速制作主题分析报告时，可以打开该报表浏览页-展开页头-【AI助手】-【自由问答】进入AI助手。

3. 基本说明

3.1主界面说明

3.2历史会话（左侧）

①在界面左侧的最上方搜索栏，可进行历史对话记录的搜索查询和新建对话；

②当鼠标悬浮在某个对话记录上时，后方会出现编辑和删除按钮，点击编辑按钮对对话名称和描述进行修改，（对话名称默认情况下是该会话的第一个问题），点击删除按钮可将该对话记录删除。

③鼠标悬浮在对话记录上，可查看当前对话的基础信息，如创建人，使用模型，和创建时间等。

3.3报表/数据集选择、场景选择、配置（上方）

3.3.1报表/数据集选择

该部分主要决定向AI回答提出问题时，需投喂给AI数据，然后AI通过判断找到最能和问题匹配的数据进行回答。

①勾选【所有报表】项时，即表示选择所有报表的数据集投喂给AI进行问答；

②点击报表框后方的加号，可进行指定报表的选择，即在该会话进行下一次问答时只从所选报表和数据集中进行数据查找；

③AI解答问题之前，要投喂的所选报表及报表中的数据集会在文本框内显示出来；

AI解答问题之后，文本框内会变成AI所提供结果的来源报表和数据集。

3.3.2场景选择

①多轮对话：根据当前选择的报表及数据集投喂数据给系统，进行多轮形式对话问答。

②匹配数据集

（1）勾选【匹配数据集】后会默认勾选上左侧【所有报表】，即在文本框输入问题后，查询所有报表的数据集投喂AI，AI通过判断寻找可以回答这个问题的数据集，最后把问题的答案输出；

（2）可以取消勾选左侧【所有报表】，在添加报表中选择指定的报表，即在文本框输入问题后，查询所选报表的数据集投喂AI，AI通过判断寻找可以回答这个问题的数据集，最后把问题的答案输出，这种的效率相对前面勾选所有报表会更高；

③生成数据集：通过自然语言和调用数据集构建器构建一个数据集，再查询出结果（开发中）

④生成sql：不用选择报表和数据集，输入问题后，系统会投喂当前数据源中的所有表结构及关联关系给AI，AI再根据问题后台生成sql，将最终返回的结果输出

当前使用中会存在的问题：结果不精准，与AI大模型相关。

3.3.3配置与财务

点击配置栏后方的设置按钮，可以进入“配置与财务”模块，具体配置内容可参考第4点

3.4对话区域

①在对话区域的文本框中，输入想问的问题，点击蓝色小飞机按钮，等待片刻中间区域就会出现AI助手给出的答案；

②在最上方的报表和数据集框内，会出现答案取自哪个报表和数据集，点击【报表名称】即可跳转到对应报表，点击【数据集名称】也可以预览数据集中的数据，或者直接点击【复制】按钮将数据集结果复制出来。通常用于数据的核对。

③该处可以查看问题的提出用户和时间，对问题进行复制或删除；

④点击AI助手的头像，可以复制最终结果的中间过程，也就是这个答案是如何获取到的，一般用来数据核对和思路梳理；

4. 配置与财务

点击主界面右上角小齿轮，跳转进入【配置与财务】

4.1财务

由于AI助手功能涉及到AI模型的调用，每一次提问AI厂商会收取相应的接口费用，在该页面可进行充值和历史消费账单查看，每个新用户的账户中都会有1元的余额可以进行体验。

4.2提示语

①系统已根据3种常见的问答配置方式（匹配数据集、生成sql、喂数据），并针对不同的场景，预设了5种提示语。

②无法新增提示语，只允许修改系统预设的提示语，一般情况下不需要另行配置。

③不同大模型和版本的提示语可单独设置，可根据实际使用情况，调整提示语。

4.2.1修改提示语

①提示语的修改操作步骤如图所示

注意：修改后，需重新进入AI助手，并新建对话才能生效。

重新提问后，点击AI回复框的头像，复制解析过程到粘贴板，并粘贴到文本编辑器中，可查看AI已经依据新的提示语进行分析。

②提示语修改注意事项：

（1）以补充说明依据为辅助

如补充问题场景、需要注意的细节点、反复出错的问题点

（2）不要改动提示语的整体框架及关键词，会影响AI助手的正常解析

关键词形如{dataSetStruct}等带有中括号的专有名词，以及输出格式等内容

（3）如AI助手根据修改后的提示语无法正常运作或输出结果，需要还原为默认提示语，将内容文本框清空，点击保存即可恢复默认值。

4.2.2分析报告模板编写要点

分析报告模板的编写，需要注意以下4个要点：

①你是什么角色②有什么能力③要完成什么任务④要注意什么事项
比如：你是一个专业的财务分析师，具备数据统计分析的所有知识，精通企业经营分析，如销售分析、库存分析、采购分析、生产分析、财务分析等；请根据我提供的数据集，生成一份利润表分析报告。注意，单位是元，数字仅保留2位小数，并要加上千分位。

分析模板可以从网络等其他途径获取，在原基础上作细节加工，投喂给AI进行学习并不断的试错，发现可完善的地方，补充到注意事项内。

4.2.3 分析报告模板示例

以下是两份分析报告的提示语模板，仅供参考。

①利润表分析报告

点击下载

②应收风险分析报告

点击下载

4.3模型版本

当前AI助手接入了智谱和百度千帆两个大模型，在此处可以进行大模型和版本的选择，推荐使用智谱大模型GLM-4-Air版本，是性价比最高的版本，综合性能接近GLM-4，具有128k上下文，速度快，价格实惠。

这里的单价单位为“元/千tokens”，每千tokens大约等于一千字节

模型说明：

5. 验证中间过程

AI助手问答产出的结果，受到提问方式等因素的影响，不一定是完全准确的。如果我们对数据的准确性有疑问，可根据生成结果中附带的数据集和处理过程，查看问题的所在，并针对出现问题的地方，在后续的提问中做专门的提示和优化，从而输出可靠的结果。

注意：数据验证的步骤，根据提问选择的配置，会有些许的区别。

5.1没有匹配到符合需求的最优数据集

以配置为“匹配数据集”为例

提问问题为：“2023年的销售收入和销售毛利是多少”，输出结果如图所示

可以在报表和数据集选择框内，看到AI助手自动匹配的可能符合需求的报表和对应的数据集。

点击报表后，自动打开新页面，跳转至对应报表

修改公共筛选为2023年后，点击刷新。由于“除12个月销售趋势”折线图外，其余图表均为TOP10控件，不符合实际查询的需要；“除12个月销售趋势”折线图序列均包含销售金额和销售毛利，可以手动修改数据集构建器，输出对应结果进行核对

核对结果，发现输出的结果和实际结果相差很大，需进一步确认匹配数据集的构成。

点击匹配的数据集，查看生成结果。

生成的结果中，发现数据只统计到了2023年1月，且输出的结果包含了2022年12个月的数据，并非实际所需的结果，也就是AI没能匹配到可满足需求的最优数据集。

点击报表预览，可查看临时生成的报表，查看构建结果。

上述问题，可以确定是因为时间筛选出错导致结果不正确。

点击回复窗口的AI助手头像，复制解析过程到剪切板，并粘贴到文本编辑器，可查看解析过程。

匹配数据集，根据系统预设的提示词（可以理解为提供给AI帮助其分析输出数据的流程和模板），输出相应的结果。

可以发现在输出的数据内就已经存在问题了，没有正确合计到2023年所有月份的数据。

改进方法：

尝试再次提问；或改变提问方式，并针对出现问题的地方做单独的提示语调整。

多尝试不同的提问方式，如改为疑问句、提供的内容更书面化，方便AI学习和理解。

如下图，对出错的地方——时间筛选，提出维度的筛选限制。

这次提问输出的结果就是正确的，点击匹配的数据集也验证成功。

5.2生成的sql不正确，导致无法输出结果

以生成sql为例

提出以下问题：2023年的销售收入是多少？

AI助手没有成功输出结果，可以点击该回复的AI助手头像，复制解析过程到剪切板。

复制解析过程到文本编辑器中。

自然语言生成sql，根据系统预设的提示语，会先匹配所有可能符合需求的数据表，并获取构建的视图模型内表和表之间的关联关系，最后输出分析结果。

在最后的所有结果中，发现是生成的sql语句内存在语法错误，表拼写错误导致无法成功输出结果

改进方法：

可尝试更换提问方式或作补充说明。

这次在问题的末尾补充了“总和”。

AI输出结果，如需验证生成的结果是否正确，可点击该结果回复框的AI助手头像，复制解析结果至剪切板。

粘贴文本至文本编辑器内，在末尾可查看生成的结果sql，确认来源表、所取字段和筛选条件正常。

将结果sql复制到数据库管理工具中执行，结果符合预期。

5.3提问内涉及到内存计算的内容，输出结果为空或不正确。

通过匹配数据集的方式，提问2023年各组织的销售收入及占比情况，发现无法输出结果，查看是搜索范围内的报表数据集，没有包含行占比字段。

我们可以对组织销售分析相关的报表进行设计，对符合展示需求的数据集内添加“销售收入行占比”字段（如本需求输出的字段为销售收入、销售收入行占比和组织名称），这样AI匹配到数据集的成功率会更大。

6. 场景举例

6.1场景一：如何通过匹配数据集获取数据

6.1.1匹配数据集

进入AI助手默认勾选匹配数据集模式，并且默认勾选所有报表，在当前设置下开启AI对话时，会从目前BI里的所有报表的数据集中，匹配与用户询问最贴切的数据集，并从该数据集里查询得到用户所需要的数据信息。

如果不需要从所有报表这么大的范围中匹配数据集，可以取消勾选所有报表，然后点击【+】按钮添加报表。

选择报表添加

6.1.2操作示例

目前BI系统中有大量报表，假设用户需要快速得知2014年的采购入库数量，如何通过AI助手快速得到结果。

下列是采购入库2014年的相关数据：

首先进入到AI助手中，就按照默认设置，输入需要查询的信息，如：2014年采购入库数量是多少

可以看见AI助手匹配到了系统中的采购入库数据核对报表，报表中的hedui1filter数据集

悬浮在报表，数据集上可以看见信息，点击蓝色框报表可以直接跳转到目的报表

点击跳转过去报表也可以看见结果是吻合的。（需要注意的是，每次匹配的结果有可能不一样，AI模型存在匹配报表数据集不精确导致）

也可以询问AI助手采购入库数量的整体变化趋势，可以直接得出简单的分析结果，并且也符合报表展示的数据情况。

6.2场景二：如何通过生成数据集获取数据

6.2.1进入AI助手，勾选上【生成数据集】，报表和数据集为灰色无法选择状态，该模式为通过自然语言和调用数据集构建器功能，构建一个全新的数据集并返回结果。

6.2.2等待AI助手加载完毕，即可看见返回的结果如下，并且上方有AI生成的数据集和报表可以用来核验数据

6.2.3点击报表名称跳转到报表页面，可以看见AI自动生成的图表和表格数据，点击表格的数据集，和复制sql到数据库中进行数据的核验。

6.3场景二：如何通过生成sql获取数据

6.3.1勾选上生成sql，在文本框中输入问题后回车，等待返回结果

6.3.2数据校验

点击AI头像，即可复制中间过程

将中间过程粘贴至记事本，在最前面可以看见AI列出了系统中所有的报表，表结构及表关联关系，我们直接下拉到最后，结果中有一条可以用来验证数据的sql语句

将语句复制到数据库中执行，即可验证刚刚得到的结果是正确的

6.4场景三：如何生成报告

6.4.1打开要分析的报表，进入AI助手

6.4.2选择需要投喂给AI的数据，比如选择哪个组织、哪个期间

6.4.3套用以下模板

点击下载利润表分析模板

AI会提供类似模板中的建议；注意目前大模型寻找的数据可能会和提供的数据有所偏差

6.4.4查看AI返回的分析报告结果

7. 新增优化

7.1增加markdown格式的输出

使用markdown格式输出，可让输出的报告内容带格式，具体的语法可参考：

点击此处可跳转学习markdown相关语法

我们可以用带markdown语法的模板，让最终输出的报告展示出我们想要的样式，比如标题。可参考总经理驾驶舱的提示词示例

AI输出效果如下

如添加了Markdown语法但未以markdown格式输出，检查此处是否为蓝色高亮状态，蓝色为开启markdown格式，灰色为未开启。

也可以通过多轮会话，让输出报告的样式更加丰富，比如让报告中的负数显示成红色：有格式的报告，复制到word中，也仍然可保持样式，便于快速排版。

7.2增加报告引用报表截图

7.2.1引用图表截图

如果想在报表中的特定位置引用某个图表的截图，只需要在提示词中的报告模板相应位置插入itemimg函数即可

具体语法为：{itemimg.图表标题名称}

比如想插入标题名称为【部门TOP10】的这个图表，则只需要在适当位置插入：{itemimg.部门TOP10}

如下图输入：

则AI输出：

7.2.1引用报表截图

在报告的最后总结处，通常我们会添加一个完整的报表内容截图

具体语法为：{rptimg}

如下图，我们在提示语的结尾处增加一个报表截图

则AI输出

7.3预设指令

预设指令分为系统预设指令和用户预设指令两种。

7.3.1系统预设指令

为了帮助用户更便捷的使用AI助手快速生成分析报告，在下载标准方案时，同时会内置几十多张报表的预设指令，我们进入AI助手界面，点击左侧预设指令-系统。

可以看见里面有针对十多个驾驶舱的列表，点击其中一个，右侧会显示出来预设的指令内容，我们只需要点击蓝色发送按钮，即可以通过该指令内容获取到一份分析简报

7.3.2 用户预设指令

除了通过下载标准方案获取到的系统预设指令，我们还可以按照自己的需求，将已完善的指令模板进行保存。

比方说我们想针对销售驾驶舱预设一条指令，那我们进入销售驾驶舱浏览页-打开页眉-点击AI助手-自由问答

跳转到AI助手界面，已选择了指定的报表和数据集

我们将已完善的指令复制到文本框中，点击发送按钮

得到问答记录后，我们点击问答框内的提问者头像旁的保存预设指令按钮，提示【新增用户指令成功】，即代表保存成功

进入预设指令-用户，看见刚刚保存的指令，点击编辑按钮，修改对话名称，便于查找指定指令

最后的效果如下，当我们想再次快速获取最新的销售报告时，找到该指令，发送即可获取。

7.4 AI订阅

配合预设指令使用，可以定时自动将用户预设的AI指令输出的报告内容推送到邮箱、钉钉、企业微信等第三方平台（需提前设置好发送者邮箱、用户邮箱、钉钉及企微集成）

发送者邮箱设置：点击跳转

钉钉集成：点击跳转

企业微信集成：点击跳转

设置方式如下

进入系统配置-计划调度-AI订阅

点击【添加】新增一个AI订阅任务，填写上任务名称后确定。

选中任务，根据要推送报告的时间给任务增加触发器，设置方式如下图

在下方用户预设指令中勾选需要推送的报告指令，点击蓝色箭头移植右侧，勾选需要接收推送的用户，点击蓝色箭头移至右侧。

配置完成的状态如下图

我们点击任务名后方的执行按钮，可以测试推送是否正常

邮箱中收到相应报告，预览效果如下

钉钉推送效果如下，确认正常后，那么到了触发器时间，即可定时收到报告推送。