提示:1）本文讲解如何在已经部署使用过 FineChatBI 的 FineBI 项目中部署启用 Data Agent。
2）优先建议使⽤ 未部署过 FineChatBI 的新 FineBI 工程，帆软不协助处理 ChatBI 升级至 Data Agent 出现的兼容问题，若部署后 Data Agent 中携带部分 ChatBI 的旧数据，请⾃⾏检查其是否可⽤，或重新进⾏配置。
3）仅支持包含 PostgreSQL 组件的部署方式。
4）请按顺序完成以下每一步配置操作。
1. 使用前提
FineBI 与 Data Agent 需要按顺序部署，因此用户需要先使用运维平台部署好 FineBI 。
| 要求 | 说明 | |
|---|---|---|
| 1 | 部署运维平台 | FineBI 和 Data Agent 均依赖运维平台部署，因此用户需要提前部署好运维平台
请参考文档部署最新版运维平台：部署运维平台 内网环境请务必使用全量版离线安装包部署，否则无法获取 FineBI 相关组件镜像
请确保运维平台在 V2.36.0 及以上，建议升级到最新版本 运维平台 V2.36.0 及以上版本在部署 DataAgent 时会默认部署 PostgreSQL |
| 2 | 部署 FineBI | 用户需要先使用运维平台部署好 FineBI，再对 FineBI 添加 Data Agent 请确保 FineBI 部署方式为「运维平台部署」，不支持「非运维平台部署」 请确保 FineBI 版本在 7.0.7 及以上，建议直接升级到最新版本FineBI 请参考文档升级 FineBI：外网升级运维项目、内网升级运维项目 因为下文提供的镜像均为最新 Data Agent 镜像，不同 FineBI 版本适配不同版本的 Data Agent 镜像，如为历史版本FineBI，需要联系帆软技术支持获取对应版本AI镜像。 |
2. 卸载 FineChatBI 插件
管理员登录 FineBI，点击「管理系统>插件管理>我的插件」，点击「删除」按钮，点击弹窗上的「确定」按钮即可。
3. 配置Data Agent插件
1）下载 Data Agent 插件
2）管理员登录 FineBI，点击「管理系统>插件管理>应用商城」
3）点击「从本地安装」，选择获取的 Data Agent 插件安装包，完成安装即可。
注：插件包较大，因此安装时间较长，请耐心等待。
4. 准备Data Agent镜像
Data Agent 镜像无法直接从云端仓库拉取，需要手动推送镜像入库。
4.1 获取镜像包
注1：对于信创版 FineBI，支持在 ARM 架构的信创服务器中添加 AI 服务。
注2：本文提供的镜像均为最新 AI 镜像，不同 FineBI 版本适配不同版本的 AI 镜像。如需历史版本镜像，请联系帆软技术支持获取。
| x86 架构 |
|
|---|---|
| ARM 架构 |
|
4.2 上传镜像包
管理员登录运维平台，点击「运维平台管理>运维组件」。
点击「导出部署信息」，导出成功后会提示导出的文件地址。
前往运维平台所在服务器，在导出文件所在的 logs 目录，同级目录下，有一个 resources 文件夹，即为镜像上传位置。
例如本示例，导出文件所在文件夹为/home/ops/fanruan_5d15bea4/ops/logs，那么镜像上传位置为/home/ops/fanruan_5d15bea4/ops/resources
请将上一步下载的两个镜像.tar.gz文件，上传到 resources 文件夹中
4.3推送入库
管理员登录运维平台，点击「维护中心>镜像管理」，点击「加载镜像」。
即可选择 resources 下的两个 AI 镜像文件进行加载，加载完成后 resources 下的镜像文件会被删除。
4.4 确认并修改部署版本
推送成功后，管理员登录运维平台，点击「维护中心>镜像管理」，查看推送到仓库的新镜像。
找到刚刚推送的「fine-ai-bi7」和「fine-chat-bi-parser-bi7」镜像，记下版本号。
管理员登录运维平台，点击「运维平台管理>更新升级>部署列表>手动修改」。
手动修改 AI 相关的两个组件的镜像版本号，确保与镜像管理中的镜像版本号完全一致，此时运维平台才会读取到有待更新的镜像版本。
5. 升级原FineChatBI组件至Data Agent组件版本
参考文档【卸载后升级Data Agent】，将 FineChatBI 组件升级为 Data Agent 组件。
6. 获取Data Agent授权
7. 确认Data Agent入口
成功完成以上操作后，FineBI 右上角将出现「Data Agent」入口按钮，此时仅完成基础配置，请继续本文以下操作。
8. 升级ElasticSearch组件
8.1 确认ElasticSearch组件版本
请确保升级 ElasticSearch 组件至 v20.4.5-8.17.3 及以上版本，并确保 ElasticSearch 组件处于 running 状态。
详情请参见：内网升级运维项目。
8.2 自定义ElasticSearch 组件环境变量
请通过开发者模式，自定义 ElasticSearch 组件的环境变量，将 INSTALL_FINE_PLUGIN 的值修改为 yes。
详情请参见：开发者模式。
9. 连接测试
完成以上所有操作后，将成功部署并可进入 Data Agent 页面，在正式使用 Data Agent 平台前，管理员需进行平台和模型连接测试操作。
注：若连接测试出现报错，可前往 大模型问题排查指南 查看。
9.1 平台连接测试
前往「Data Agent 管理后台>应用连接」，完成如下两个操作：
1）在后台地址中添加当前已部署 Data Agent 的 FineBI 地址，地址格式需保持统一，IP 与域名不可混用。
2）点击「连接测试」，以保证 FineAI 插件与 FineBI 平台互通且版本一致。
9.2 模型连接测试
前往「Data Agent 管理后台>模型」，对已添加的目标模型进行连接测试，保证大模型为可用状态。