本文主要介绍报表助手的部署方法及操作使用说明,帮助用户快速掌握功能应用。
有两种部署场景:
1、场景一:项目当前正在使用的业务系统是V11版本:直接在当前V11环境上部署AIChat,基于当前系统上的报表进行问数。
2、场景二:项目当前正在使用的业务系统是V8/V9/V10版本,且不升级到V11版本:
准备两套Smartbi环境,一个是用户当前正在运行的业务系统,Smartbi的版本可以是V8/V9/V10,下文简称为低版本环境,另一个是新部署的带AIChat功能的最新V11版本系统,下文简称为V11环境。
将需要AI问数的报表从低版本环境导入到V11环境,在低版本环境中打开报表,点击报表工具栏的 AI问答 ,此时能自动找到V11环境对应的报表,并打开V11环境的AIChat界面,用户可输入问句进行问数。
下面按不同的部署场景说明报表助手的部署方法及操作使用说明。
直接在当前V11环境上部署AIChat,基于当前系统上的报表直接进行问数。AIChat的部署操作详情可查看:AIChat安装部署与升级 。
1、在 运维设置 > 系统迁移与备份 > 导入资源 中,导入 报表助手Agent.xml 资源,如下图所示:
2、导入资源成功后,在 Agent 中,双击打开导入 报表助手 Agent,点击工具栏的 发布 按钮,确认Agent发布成功,如下图所示:
1、获取报表助手功能扩展包并部署,部署扩展包的操作步骤详情可查看:部署扩展包 。
Smartbi版本 | 需要部署的扩展包 |
---|---|
V11 |
2、在Smartbi服务上部署好对应扩展包后,进入系统在 系统运维 > 系统选项 > 公共设置 > 服务器地址 > 自然语言分析的URL地址 中配置地址:如:http://IP:端口/smartbi/vision/aichat/proxy/#/?hideNav=true&agentId=customagent_I8a8a4ae4019768fb68fb93ea0197694a28510006
报表助手功能,本质是对报表绑定的数据模型进行问数,所以需要创建数据模型,若报表是直接来源数据模型的,则可跳过此步骤。
本文仅以怎么快速复用当前已有报表数据为例创建数据模型,完整的数据模型构建思路和方法,详情可查看:准备数据 。
1、开启 数据模型支持添加系统资源作为私有查询 功能:
2、点击 系统资源 ,选择已有的数据集或报表,作为数据模型的私有查询数据来源,快速复用系统上已有的报表数据。
3、添加的系统资源会自动转换成数据模型的 Java查询 ,通过Java查询去获取系统资源的数据,Java查询功能的使用介绍,详情可查看:添加接口查询 。
4、生成的Java查询默认不会自动映射参数,且生成的参数默认是输入框类型(即不带参数备选值),
为了保证能问不同的参数值数据、且确保问数结果的准确性,需要把私有查询中的参数映射到数据模型中,并配置参数备选值。参数功能详情可查看:参数设置 。
5、如果需问时间计算数据,则需要创建时间层次,详情可查看:创建时间维 。
6、保存数据模型,并抽取数据。
更多的数据模型功能介绍,详情可查看:数据模型 。
1、在需要问数的报表中,点击鼠标右键,点击 属性 ,在 报表模型 中填入所需问数的 数据模型ID,支持填入多个数据模型ID,用英文逗号分隔。
报表模型设置,本质是为了确定使用报表助手问数时,是基于什么数据模型进行问数。
2、报表模型 设置中:
1、训练需要问数的数据模型:
点击 运维设置 > 自然语言配置 > 图谱管理 > 构建模型图谱 :
勾选需要问数的数据模型,点击下一步:
勾选需要训练的字段,点击 训练 :
需勾选有业务意义的中文维度字段,不建议勾选日期、维成员过多等字段训练。
提示操作成功,则表示数据模型训练完成。
打开对应的报表,点击工具栏 AI问答 按钮,在报表右侧自动打开AIChat的窗口,可输入问句进行问数:
1、部署V11版本的Smartbi,部署操作详情可查看:安装部署与升级 。
2、原低版本的业务系统环境。
使用报表助手功能需在同一个页面中,同时打开低版本和 V11版本。若存在跨域问题,需进行解决(下面以 Windows 版 Nginx 为例介绍配置方法)。若无跨域问题时,可跳过此步骤。
1、在Nginx安装目录中,找到 conf\nginx.conf 文件,双击编辑。
2、按实际系统地址配置,其中V11环境需使用和低版本不同的应用名,配置如下图所示:
3、保存后,启动Nginx。
1、V11环境,在 运维设置 > 系统迁移与备份 > 导入资源 中,导入 报表助手Agent.xml 资源,如下图所示:
2、导入资源成功后,在 Agent 中,双击打开导入 报表助手 Agent,点击工具栏的 发布 按钮,确认Agent发布成功,如下图所示:
1、获取报表助手功能扩展包,并按对应的环境版本部署相应的扩展包,部署操作步骤详情可查看:部署扩展包 。
Smartbi版本 | 需要部署的扩展包 |
---|---|
V8、V9、V10 | |
V11 |
2、在Smartbi服务上部署好对应扩展包后,进入系统在 系统运维 > 系统选项 > 公共设置 > 服务器地址 > 自然语言分析的URL地址 中配置地址:
若存在跨域问题的,需要配置V11代理后的访问地址,比如V11代理后的访问地址是:http://IP:端口/smartbiv11,则自然语言分析的URL地址为:http://IP:端口/smartbiv11/vision/aichat/proxy/#/?hideNav=true&agentId=customagent_I8a8a4ae4019768fb68fb93ea0197694a28510006
需将低版本环境的报表资源同步到V11环境上:
如果是初次使用,可将低版本环境的知识库恢复到V11环境上,实现一次性迁移所有所需报表的效果。
后续使用时,若低版本环境上的问数报表有新增或变更,则可以通过 资源导入导出 功能,将低版本环境上的报表导到V11环境上。资源导入导出功能详情可查看:系统资源迁移 。
报表助手功能,本质是对报表绑定的数据模型进行问数,所以只需保证数据模型能正常查数即可,部分报表本身的升级异常问题不影响报表助手功能的正常使用。 |
报表助手功能,本质是对报表绑定的数据模型进行问数,所以需在V11环境上创建数据模型,若报表是直接来源数据模型的,则可跳过此步骤。
在V11环境上如何创建数据模型,和场景一功能一样,这里就不再展开说明,详情可查看:创建数据模型 。
在V11环境需要问数的报表中,点击鼠标右键,点击 属性 ,在 报表模型 中填入所需问数的 数据模型ID,支持填入多个数据模型ID,用英文逗号分隔。
在V11环境的报表上如何绑定数据模型,和场景一功能一样,这里就不再展开说明,详情可查看:报表绑定数据模型 。
在V11环境上,训练需要问数的数据模型,如何训练数据模型和场景一功能一样,这里就不再展开说明,详情可查看:训练数据模型 。
在低版本环境上打开需问数的报表,点击工具栏 AI问答 按钮,此时系统会自动找到V11环境上同ID的报表,并基于此报表自动打开AIChat的窗口:
在低版本环境上点击AI问答,首次打开AIChat界面时,需要先登录:
登录成功后,可输入问句进行问数: