提示:1）本文讲解如何在已经部署使用过 FineChatBI 的 FineBI 项目中部署启用 Data Agent。
2）优先建议使⽤ 未部署过 FineChatBI 的新 FineBI 工程，帆软不协助处理 ChatBI 升级至 Data Agent 出现的兼容问题，若部署后 Data Agent 中携带部分 ChatBI 的旧数据，请⾃⾏检查其是否可⽤，或重新进⾏配置。
3）请按顺序完成以下每一步配置操作。
1. 使用前提
部署Data Agent前，需要先部署 运维平台FineOps 及 FineBI，版本要求如下：
| 运维平台 | FineBI平台 |
|---|---|
|
|
1.1 准备运维平台
FineBI 和 Data Agent 均依赖运维平台部署，因此用户需要提前部署好运维平台。
| 运维平台环境 | 说明 |
|---|---|
| 外网环境（镜像仓库能够连接帆软云端仓库的环境） |
请参考文档部署最新版运维平台：部署运维平台
请参考下文升级运维平台至V2.41.0 及以上版本。 请参考文档：外网升级运维平台 |
| 内网环境（镜像仓库无法连接帆软云端仓库的环境） |
请参考文档使用「全量版离线安装包」部署最新版运维平台：部署运维平台
请使用「全量版离线安装包」升级运维平台至V2.41.0 及以上版本。 请参考文档：内网升级运维平台 |
1.2 检查FineBI平台
用户需要先使用运维平台部署好 FineBI，再对 FineBI 添加 Data Agent 组件，因此需确认以下几点：
请确保 FineBI 部署方式为「运维平台部署」，不支持「非运维平台部署」
请确保 FineBI 版本在 7.0.8 及以上，建议直接升级到最新版本 FineBI
请参考文档升级 FineBI：外网升级运维项目、内网升级运维项目
下文提供的镜像均为最新 Data Agent 镜像，不同 FineBI 版本适配不同版本的 Data Agent 镜像，如为历史版本FineBI，需要联系帆软技术支持获取对应版本AI镜像。
1.3 卸载 FineChatBI 插件
管理员登录 FineBI，点击「管理系统>插件管理>我的插件」，点击「删除」按钮，点击弹窗上的「确定」按钮即可。
1.4 准备DataAgent所需服务器资源
注：AI组件的部署入口，默认不直接对外开放。如需部署DataAgent，可以在资源准备阶段，提前联系帆软技术支持或销售人员，获取入口开放方法。
部署前需确认 DataAgent 预计日活用户与高峰同时使用人数，用于选择适合本企业的服务器配置。
详情可参考文档：确认DataAgent项目服务器配置。
2. 安装Data Agent插件
提示:1）下载 Data Agent 插件
2）管理员登录 FineBI，点击「管理系统>插件管理>应用商城」
3）点击「从本地安装」，选择获取的 Data Agent 插件安装包，完成安装即可。
注：插件包较大，因此安装时间较长，请耐心等待。
3. 准备Data Agent镜像
3.1 获取镜像包
注：
1）对于信创版 FineBI，支持在 ARM 架构的信创服务器中添加 AI 服务。
2）本文提供的镜像均为最新 AI 镜像，不同 FineBI 版本适配不同版本的 AI 镜像。如需历史版本镜像，请联系帆软技术支持获取。
3）根据 DataAgent 服务器 CPU 架构选用对应的全量镜像包，每个包均包含 fine-ai、fine-chat-bi-parser、fine-ai-redis 和 postgresql 四个组件。
| AMD64（X86_64）架构 | |
|---|---|
| ARM64 架构 |
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」、「postgresql」、「redis」镜像，记下版本号。
管理员登录运维平台，点击「运维平台管理>更新升级>部署列表>自动修改」。
运维平台将自动识别 FineOps 镜像仓库中各镜像的最新版本，并修改 AI 相关组件的镜像版本号，DataAgent 将按更新后的版本部署。请确认 DataAgent 的部署版本与上述步骤中上传的镜像版本一致。
4. 升级原FineChatBI组件至Data Agent组件版本
参考文档【卸载后升级Data Agent】，将 FineChatBI 组件升级为 Data Agent 组件。
5. 升级ElasticSearch组件
5.1 确认ElasticSearch组件版本
请确保升级 ElasticSearch 组件至 v20.4.5-8.17.3 及以上版本，并确保 ElasticSearch 组件处于 running 状态。
详情请参见：内网升级运维项目。
5.2 自定义ElasticSearch 组件环境变量
请通过开发者模式，自定义 ElasticSearch 组件的环境变量，将 INSTALL_FINE_PLUGIN 的值修改为 yes。
详情请参见：开发者模式。
6. 获取Data Agent授权
7. 确认Data Agent入口
成功完成以上操作后，FineBI 右上角将出现「Data Agent」入口按钮，此时仅完成基础配置，请继续本文以下操作。
8. 连接测试
完成以上所有操作后，将成功部署并可进入 Data Agent 页面，在正式使用 Data Agent 平台前，管理员需进行平台和模型连接测试操作。
注：若连接测试出现报错，可前往 大模型问题排查指南 查看。
8.1 平台连接测试
前往「Data Agent 管理后台>应用连接」，完成如下两个操作：
1）在后台地址中添加当前已部署 Data Agent 的 FineBI 地址，地址格式需保持统一，IP 与域名不可混用。
2）点击「连接测试」，以保证 FineAI 插件与 FineBI 平台互通且版本一致。
8.2 模型连接测试
前往「Data Agent 管理后台>模型」，对已添加的目标模型进行连接测试，保证大模型为可用状态。