部署Data Agent（已部署使用过FineChatBI版本）

FineBI 与 Data Agent 需要按顺序部署，因此用户需要先使用运维平台部署好 FineBI 。

管理员登录 FineBI，点击「管理系统>插件管理>应用商城」，卸载 FineChatBI 插件。

Data Agent 镜像无法直接从云端仓库拉取，需要手动推送镜像入库。

3.1 获取镜像包

注1：对于信创版 FineBI，支持在 ARM 架构的信创服务器中添加 AI 服务。

注2：本文提供的镜像均为最新 AI 镜像，不同 FineBI 版本适配不同版本的 AI 镜像。如需历史版本镜像，请联系帆软技术支持获取。

3.2 上传镜像包

管理员登录运维平台，点击「运维平台管理>运维组件」。

点击「导出部署信息」，导出成功后会提示导出的文件地址。

前往运维平台所在服务器，在导出文件所在的 logs 目录，同级目录下，有一个 resources 文件夹，即为镜像上传位置。

例如本示例，导出文件所在文件夹为/home/ops/fanruan_5d15bea4/ops/logs，那么镜像上传位置为/home/ops/fanruan_5d15bea4/ops/resources

请将上一步下载的两个镜像.tar.gz文件，上传到 resources 文件夹中

3.3推送入库

管理员登录运维平台，点击「维护中心>镜像管理」，点击「加载镜像」。

即可选择 resources 下的两个个 AI 镜像文件进行加载，加载完成后 resources 下的镜像文件会被删除。

3.4 确认并修改部署版本

推送成功后，管理员登录运维平台，点击「维护中心>镜像管理」，查看推送到仓库的新镜像。

找到刚刚推送的「fine-ai-bi7」和「fine-chat-bi-parser-bi7」镜像，记下版本号。

管理员登录运维平台，点击「运维平台管理>更新升级>部署列表>手动修改」。

手动修改 AI 相关的两个组件的镜像版本号，确保与镜像管理中的镜像版本号完全一致，此时运维平台才会读取到有待更新的镜像版本。

用户可通过「组件管理」将原 FineChatBI 组件升级至 Data Agent 组件版本，平滑使用。

1）下载 Data Agent 插件

• Data Agent 插件

2）管理员登录 FineBI，点击「管理系统>插件管理>应用商城」

3）点击「从本地安装」，选择获取的 Data Agent 插件安装包，完成安装即可。

注：插件包较大，因此安装时间较长，请耐心等待。

Data Agent 相关授权，请联系帆软销售获取。

授权安装方法：根据网络环境，推荐 公有云认证 （外网）/ 注册新项目（内网）

Data Agent 配置成功，且 Data Agent 相关授权安装成功后，在 FineBI 右上角出现「Data Agent」按钮，即代表 Data Agent 配置完成。

8.1 确认ElasticSearch组件版本

请确保升级 ElasticSearch 组件至 v20.4.5-8.17.3 及以上版本，并确保 ElasticSearch 组件处于 running 状态。

详情请参见：内网升级运维项目。

8.2 自定义ElasticSearch 组件环境变量

请通过开发者模式，自定义 ElasticSearch 组件的环境变量，将 INSTALL_FINE_PLUGIN 的值修改为 yes。
详情请参见：开发者模式。 

完成以上所有操作后，将成功部署并可进入 Data Agent 页面，在正式使用 Data Agent 平台前，管理员需进行平台和模型连接测试操作。

注：若连接测试出现报错，可前往 大模型问题排查指南 查看。

9.1 平台连接测试

前往「Data Agent 管理后台>应用连接」，完成如下两个操作：

1）在后台地址中添加当前已部署 Data Agent 的 FineBI 地址，地址格式需保持统一，IP 与域名不可混用。

2）点击「连接测试」，以保证 FineAI 插件与 FineBI 平台互通且版本一致。

9.2 模型连接测试

前往「Data Agent 管理后台>模型」，对已添加的目标模型进行连接测试，保证大模型为可用状态。

参考文档 升级Data Agent 进行升级。