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