提示:如尚未部署运维平台、FineBI项目、Data Agent服务，优先推荐一站式部署方案：帆软&阿里云计算巢部署指南
本文面向对象：在未部署使用过 FineChatBI 的 FineBI 项目中部署启用 Data Agent。若已经部署使用过 FineChatBI，请移步 部署Data Agent（已部署使用过FineChatBI版本）进行操作。
本文中提供的所有镜像均为最新版本，不提供历史版本镜像。
1. 使用前提
部署Data Agent前，需要先部署 运维平台FineOps 及 FineBI，版本要求如下：
| 运维平台 | FineBI平台 |
|---|---|
|
|
1.1 准备运维平台
FineBI 和 Data Agent 均依赖运维平台部署，因此用户需要提前部署好运维平台。
| 运维平台环境 | 说明 |
|---|---|
| 外网环境（镜像仓库能够连接帆软云端仓库的环境） |
请参考文档部署最新版运维平台：部署运维平台
请参考下文升级运维平台至V2.41.0 及以上版本。 请参考文档：外网升级运维平台 |
| 内网环境（镜像仓库无法连接帆软云端仓库的环境） |
请参考文档使用「全量版离线安装包」部署最新版运维平台：部署运维平台
请使用「全量版离线安装包」升级运维平台至V2.41.0 及以上版本。 请参考文档：内网升级运维平台 |
1.2 准备FineBI
用户需要先使用运维平台部署好 FineBI，再对 FineBI 添加 Data Agent 组件。
1）准备FineBI部署环境
2）部署最新版FineBI项目
注：需部署 FineBI 7.5 系列或 FineBI V7.0.8 及以上版本。如需使用Dora的指标问数功能，则 FineBI必须为7.5系列。
1.3 准备DataAgent所需服务器资源
注：AI组件的部署入口，默认不直接对外开放。如需部署DataAgent，可以在资源准备阶段，提前联系帆软技术支持或销售人员，获取入口开放方法。
部署前需确认 DataAgent 预计日活用户与高峰同时使用人数，用于选择适合本企业的服务器配置。
详情可参考文档：确认DataAgent项目服务器配置。
1.4 部署流程
部署流程图如下所示：
2. 安装Data Agent插件
提示:1）下载 Data Agent 插件
2）管理员登录 FineBI，点击「管理系统>插件管理>应用商城」
3）点击「从本地安装」，选择获取的 Data Agent 插件安装包，完成安装即可。
注：插件包较大，因此安装时间较长，请耐心等待。
3. 准备Data Agent镜像
3.1 获取镜像包
注：
1）支持在信创环境中部署Data Agent，根据 Data Agent 服务器 CPU 架构选用对应的镜像包。
每个镜像包均包含 fine-ai、fine-chat-bi-parser、redis 和 postgresql 四个组件。
2）本文提供的镜像均为最新 AI 镜像。如需历史版本镜像，请联系帆软技术支持获取。
| 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. 部署Data Agent组件
4.1 进入添加组件界面
管理员登录运维平台，选择对应 FineBI 项目，点击「维护>组件管理」按钮。
点击「添加组件」，选择添加组件类型「业务服务>AI」。
注：AI组件的部署入口，默认不直接对外开放。如不显示「ai」组件部署入口，请联系帆软技术支持或销售人员，获取入口开放方法。
4.2 配置AI文件服务
无论选择低、中、高哪一版服务器配置，均需为其配置AI文件服务，支持对接已有的S3文件服务器（推荐）或 复用 FineBI 服务器中已有的 MinIO 服务。
支持对接的 S3 服务器可参考文档：DataAgent对接华为云OBS实现文件服务、DataAgent对接阿里云OSS实现AI文件对接、DataAgent对接MinIO实现文件服务
4.3 新增节点（选做）
如为AI组件准备了全新服务器，需要先将该服务器添加到项目节点中。
点击「新增节点」按钮，输入服务器信息，点击「新增节点」，等待添加完成即可。
具体节点设置如下表所示：
| 节点设置 | 说明 |
|---|---|
| 节点类型 | 请选择「组件」 该组件服务器上不建议部署其他工程或内容 |
| 主机 | 请输入节点主机IP（内网IP） 注：同一项目中，主机不支持重复添加多次 |
| 端口 | 请输入节点端口号，默认为22 |
| 用户名 | 请输入有sudo权限的服务器用户名 |
| 验证方法 | 支持两种：密码、公钥 注1：密码密钥仅用于部署项目，部署结束后无需使用，项目与运维平台的对接依赖平台配置。 因此后续如修改了服务器密码，不会对运维监控产生影响。 注2：如选择公钥方式验证 请上传后缀为.key / .pem / .crt的私钥文件（例如id_rsa.key） 请勿上传其他后缀格式的私钥文件，请勿上传公钥文件（例如id_rsa.pub） |
| 挂载路径 | 请输入节点安装目录的服务器路径，即本文【2. 准备Data Agent服务器】环节设置的挂载目录 默认为~/data，~代表所使用的服务器用户的主目录 注：可在终端使用该用户账号访问服务器，输入echo $HOME命令查看该用户的主目录路径 |
| 外网IP | 选填项 如果服务器不支持内网访问，仅支持外网映射，可以填写可联通的外网IP |
4.4 选择节点
选择需要用于部署 AI 组件的项目节点。
节点最低配置为CPU16核、可用内存32G、可用磁盘500G。低于该配置的节点灰化不可选。
4.5 确认各组件配置
建议组件使用默认端口，若部署环境网络限制严格，请根据文档【确认DataAgent项目服务器配置】，准备的可用空闲端口，对每一个组件的端口进行调整。
注：
1）建议修改 FineAI Redis 组件与 postgresql 组件的密码，组件的默认密码随机生成，部署成功后无法修改。
2）postgresql 组件用户名：fine_ai_checkpoint_user
4.6 开始部署
点击「开始部署」按钮，自动在所选节点中部署 AI 相关组件。若部署失败则显示失败原因。
4.7 配置WORKER参数（选做）
若 DataAgent 服务器选择中配或高配，需配置双 WORKER 参数。
单个 fine-ai 容器内默认运行 1 个worker，最多配置 2 个worker。
请按照以下步骤操作：
1）管理员登录运维平台，选择对应 FineBI 项目，点击「维护>组件管理」按钮。
2）点击「进入开发者模式」，选择「fine-ai 组件>自定义环境变量」。
3）在弹窗中，添加环境变量：FINE_AI_UVICORN_WORKERS=2。
4.8 扩容fine-ai节点（选做）
若 DataAgent 服务器选择高配，在成功部署 DataAgent 主应用服务器后，需进行 fine-ai 节点数扩容，在扩展节点服务器上添加 fine-ai 组件。
详情可参考文档：FineAI扩容组件数量。
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入口
完成以上 Data Agent 配置，且 Data Agent 相关授权安装成功后，在 FineBI 右上角将出现「Data Agent」按钮。
点击「Data Agent」按钮进入Data Agent页面，继续进行下文的连接配置。
8. 连接测试
完成以上所有操作后，将成功部署并可进入 Data Agent 页面，在正式使用 Data Agent 平台前，管理员需进行平台和模型连接测试操作。
注：若连接测试出现报错，可前往 大模型问题排查指南 查看。
8.1 平台连接测试
前往「Data Agent 管理后台>应用连接」，完成如下两个操作：
1）在后台地址中添加当前已部署 Data Agent 的 FineBI 地址，地址格式需保持统一，IP 与域名不可混用。
2）点击「连接测试」，以保证 AI组件 与 FineBI 平台互通。
8.2 模型连接测试
前往「Data Agent 管理后台>模型」，参考 添加模型 添加新模型，或测试已添加的模型，保证大模型连接成功。