提示:如尚未部署运维平台、FineBI项目、Data Agent服务，优先推荐一站式部署方案：帆软&阿里云计算巢部署指南
本文面向对象：在未部署使用过 FineChatBI 的 FineBI 项目中部署启用 Data Agent。若已经部署使用过 FineChatBI，请移步 部署Data Agent（已部署使用过FineChatBI版本）进行操作。
本文中提供的所有镜像均为最新版本，不提供历史版本镜像。
1. 使用前提
FineBI 与 Data Agent 需要按顺序部署，因此用户需要先使用运维平台部署好 FineBI 。
| 要求 | 说明 | |
|---|---|---|
| 1 | 部署运维平台 | FineBI和 Data Agent 均依赖运维平台部署，因此用户需要提前部署好运维平台
请参考文档部署最新版运维平台：部署运维平台 内网环境请务必使用全量版离线安装包部署，否则无法获取 FineBI 相关组件镜像
请确保运维平台在 V2.36.0 及以上，建议升级到最新版本 请参考文档升级运维平台：外网升级运维平台 / 内网升级运维平台 尽管部分历史版本的运维平台也可以部署 Data Agent ，但无法部署 PostgreSQL 组件，后续无法丝滑升级，因此请务必升级运维平台至 V2.36.0 及以上版本 |
| 2 | 部署 FineBI | 用户需要先使用运维平台部署好 FineBI，再对 FineBI 添加 Data Agent 1）准备FineBI部署环境 2）部署最新版FineBI项目 |
| 3 | 开放AI组件部署入口 | AI组件的部署入口，默认不直接对外开放。 管理员登录运维平台，点击对应 FineBI 项目，点击「维护>组件管理>添加组件」。 在「基础组件」中，如不显示「ai」组件部署入口，请联系帆软技术支持或销售人员，获取入口开放方法。
|
2. 准备Data Agent服务器
由于 Data Agent 所需资源较多，以及后期扩展配置资源，建议为 Data Agent 单独准备一台服务器且部署 PostgreSQL 组件，服务器相关要求如下：
注：
1）PostgreSQL 组件用于存储历史会话等数据；
2）如不配置 PostgreSQL 组件，历史会话存储到本地磁盘，后续无法扩展，仅可测试时使用，不建议用于生产环境。
2.1 生产环境推荐配置
单独准备一台服务器只用于部署 AI 组件，并且部署 PostgreSQL 组件，服务器的相关需求如下表所示：
注：部署 PostgreSQL 组件，可用于存储历史会话，并且支持后续扩展。
| 组件说明 | 共部署如下 4 个组件：
|
|---|---|
| 芯片架构 | 支持以下两种：
|
| 操作系统 | 支持如下 4 种：
|
系统资源 高配版 | 建议准备如下资源的服务器：
其中，服务器的资源分配可参考： 1）fine-ai 组件：CPU 8核、内存 32G 2）fine-chat-bi-parser 组件：CPU 8核、内存 32G 3）fine-ai-redis 组件：CPU 8核、内存 32G 4）postgresql 组件：CPU 8核、内存 32G |
系统资源 中配版 | 建议准备如下资源的服务器：
其中，服务器的资源分配可参考： 1）fine-ai 组件：CPU 4核、内存 16G 2）fine-chat-bi-parser 组件：CPU 4核、内存 16G 3）fine-ai-redis 组件：CPU 2核、内存 8G 4）postgresql 组件：CPU 2核、内存 8G |
2.2 生产环境最低配置
AI 组件与 FineBI 项目共用服务器，且部署 PostgreSQL 数据源组件，那么 FineBI 项目服务器最低需预留如下资源，以供正常安装 AI 组件：
| 组件说明 | 除 bi 相关组件外，安装如下 ai 相关组件：
|
|---|---|
| 芯片架构 | 支持以下两种：
|
| 操作系统 | 支持以下四种：
|
| 预留系统资源 | 最低预留如下资源的服务器： CPU：16核 内存：16G 磁盘：500G 其中，预留的服务器资源分配可参考： 1）fine-ai 组件：CPU 4核、内存 4G 2）fine-chat-bi-parser 组件：CPU 4核、内存 4G 3）fine-ai-redis 组件：CPU 4核、内存 4G 4）postgresql 组件：CPU 4核、内存 4G |
2.3 服务器全部配置信息
服务器其他内容与注意事项请参考下表：
| 分类 | 推荐配置 | 最低配置 | |
|---|---|---|---|
| 适配场景 | FineBI项目服务器配置 方案二、方案四 | FineBI项目服务器配置 方案一、方案三 | |
| 服务器基础要求 | 时间一致 | Data Agent 组件服务器与项目其他服务器时间一致，相差不能超过5秒 服务器时间不一致，可能会导致定时任务执行错误、日志记录混乱、数据不一致等多种问题 | |
| 时区一致 | Data Agent 组件服务器与项目其他服务器时区完全一致 服务器时区不一致，可能会导致定时任务执行错误、日志记录混乱、数据不一致等多种问题 | ||
| 内网互通 | Data Agent 组件服务器与项目其他服务器内网互通，或可以开放端口访问 下文将具体讲述对应端口开放要求 | ||
| 不建议虚拟机 | 由于虚拟机自身的特性，会存在资源竞争等情况，可能导致出现预期外的系统故障，因此不建议在虚拟机中部署帆软应用 | ||
| 不支持K8S | 不支持在 Kubernetes 环境中部署 Data Agent 组件，请勿准备相关环境（FineBI 服务可部署在 K8S中，但需要为 Data Agent 组件准备非 K8S 环境） 更多特殊服务器情况请联系帆软技术支持确认。技术支持联系方式：「服务>在线支持」 | ||
| 操作系统 | 操作系统类型 | Linux | |
| 操作系统架构 |
注：FineBI 的 Data Agent 服务支持部署在 ARM 架构的信创服务器中。 | ||
| 操作系统内核 | 3.10 版本及以上 | ||
| 操作系统软件 | 推荐：Ubuntu 22 版本 支持：
注：CentOS 操作系统目前已停止服务，因此帆软优先推荐使用 Ubuntu 操作系统 使用 Ubuntu 操作系统时，请注意检查用户权限（默认 root 用户不是超管），下文已详细备注 | ||
| CPU | CPU核数 | 32核 | 8核 |
| CPU型号 | Intel Xeon Gold 6338 等高性能服务器处理器 Data Agent 服务依赖高性能 CPU 进行密集计算，老旧或低性能处理器会导致响应延迟，因此建议选用高性能服务器处理器 | - | |
| CPU主频 | 2.5GHz及以上 | ||
| 内存 | 剩余空闲 物理内存 | 128G | 16G |
| 磁盘 | 剩余空闲 磁盘大小 | 服务器中存在一个分区剩余可用空间大于1000G 注：必须要有任一分区满足条件，不可将分区容量加和 | 服务器中存在一个分区剩余可用空间大于 300G 注：必须要有任一分区满足条件，不可将分区容量加和 |
| 磁盘性能 | 最低性能要求为固态硬盘（SSD） | ||
| 外挂目录 | 准备外挂目录 | 准备FineBI项目挂载目录 注：禁止直接使用/、/usr、/root、/usr/local四个目录作为挂载目录，可在对应位置新建文件夹使用 | |
| 文件系统自动挂载 | 外挂目录对应的文件系统需要配置重启自动挂载 如果没有配置重启自动挂载，那么容器可能无法访问这些挂载目录，导致数据丢失或应用程序无法正常启动 | ||
| 非共享路径 | 外挂目录不能是一个共享路径 共享文件系统可能导致性能下降、文件权限问题和数据一致性挑战，这些问题会影响容器应用程序的可靠性和速度 | ||
| 权限与命令 | tar命令 | 确保服务器已安装tar命令 tar命令是一个用于打包和压缩文件的常用命令行工具 运维平台需要使用该命令进行文件解压 | |
| sed命令 | 确保服务器已安装sed命令 sed命令是一个用于处理文本的工具 运维平台需要使用该命令进行文本处理 | ||
| ssh | 确保用户可以通过ssh连接服务器 确保用户的ssh连接密码无英文单引号字符，否则部署时权限检查无法通过 | ||
| sudo权限 | 用于部署项目的服务器用户，必须具备相关sudo权限 1）优先推荐使用root超管用户进行项目部署和运行 2）如需使用非超管root用户进行项目的部署和运行 请参考文档：Linux用户权限说明 注：Ubuntu操作系统，默认的root用户并非超管用户，请务必再次确认所准备的用户是否满足上方超链的linux用户权限 | ||
| 端口网络 | 内网时延 | <1ms | |
| 组件占用端口 | 请确保默认的容器映射端口是否已被使用，如已被使用，请安排好其他空闲端口 端口占用检查和防火墙放行方法请参考：端口占用检查与防火墙配置
| ||
| 组件端口互通 | 服务器需要对外开放一些端口，以确保组件间正常工作 端口占用检查和防火墙放行方法请参考：端口占用检查与防火墙配置 1）FineAI（fine-ai）
2）语义解析小模型（fine-chat-bi-parser）
3）FineAI Redis（fine-ai-redis）
4）PostgreSQL（postgresql）
| ||
3. 准备Data Agent镜像
Data Agent 镜像无法直接从云端仓库拉取，需要手动推送镜像入库。
3.1 获取镜像包
注1：对于信创版 FineBI，支持在 ARM 架构的信创服务器中添加AI服务。
注2：本文提供的镜像均为最新 AI 镜像，不同 FineBI 版本适配不同版本的AI镜像。如需历史版本镜像，请联系帆软技术支持获取。
| x86 架构 |
|
|---|---|
| ARM 架构 |
|
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 相关的两个组件的镜像版本号，确保与镜像管理中的镜像版本号完全一致，此时运维平台才会读取到有待更新的镜像版本。
4. 确认存在redis镜像
FineAI Redis 组件，即镜像仓库中的 redis 组件。
管理员登录运维平台，点击「维护中心>镜像管理」，即可查看当前镜像仓库中是否存在redis镜像。
请确保存在v20.3.0-6.2.17及以上版本的redis镜像。如不存在符合版本要求的redis镜像，请确认镜像仓库支持连接帆软云端仓库
5. 部署Data Agent组件
5.1 进入添加组件界面
管理员登录运维平台，选择对应 FineBI 项目，点击「维护>组件管理」按钮。
点击「添加组件」，选择添加组件类型「业务服务>AI」
注：AI组件的部署入口，默认不直接对外开放。如不显示「ai」组件部署入口，请联系帆软技术支持或销售人员，获取入口开放方法。
5.2 新增节点（选做）
如为AI组件准备了全新服务器，需要先将该服务器添加到项目节点中。
点击「新增节点」按钮，输入服务器信息，点击「新增节点」，等待添加完成即可。
具体节点设置如下表所示：
| 节点设置 | 说明 |
|---|---|
| 节点类型 | 请选择「组件」 该组件服务器上不建议部署其他工程或内容 |
| 主机 | 请输入节点主机IP（内网IP） 注：同一项目中，主机不支持重复添加多次 |
| 端口 | 请输入节点端口号，默认为22 |
| 用户名 | 请输入有sudo权限的服务器用户名 |
| 验证方法 | 支持两种：密码、公钥 注1：密码密钥仅用于部署项目，部署结束后无需使用，项目与运维平台的对接依赖平台配置。 因此后续如修改了服务器密码，不会对运维监控产生影响。 注2：如选择公钥方式验证 请上传后缀为.key / .pem / .crt的私钥文件（例如id_rsa.key） 请勿上传其他后缀格式的私钥文件，请勿上传公钥文件（例如id_rsa.pub） |
| 挂载路径 | 请输入节点安装目录的服务器路径，即本文【2. 准备Data Agent服务器】环节设置的挂载目录 默认为~/data，~代表所使用的服务器用户的主目录 注：可在终端使用该用户账号访问服务器，输入echo $HOME命令查看该用户的主目录路径 |
| 外网IP | 选填项 如果服务器不支持内网访问，仅支持外网映射，可以填写可联通的外网IP |
5.3 选择节点
选择需要用于部署 AI 组件的项目节点。
节点最低配置为CPU16核、可用内存16G、可用磁盘500G。低于该配置的节点灰化不可选。
5.4 确认服务配置
请根据本文【2. 准备Data Agent 服务器】章节，准备的可用空闲端口，对每一个组件的端口进行调整。
注：
1）请务必修改 FineAI Redis 组件与 postgresql 组件的密码，组件的默认密码随机生成，部署成功后无法修改。
2）postgresql 组件用户名：fine_ai_checkpoint_user
5.5 开始部署
点击「开始部署」按钮，自动在所选节点中部署 AI 相关组件。若部署失败则显示失败原因。
6. 配置Data Agent插件
1）下载 Data Agent 插件
2）管理员登录 FineBI，点击「管理系统>插件管理>应用商城」
3）点击「从本地安装」，选择获取的 Data Agent 插件安装包，完成安装即可。
注：插件包较大，因此安装时间较长，请耐心等待。
7. 获取Data Agent授权
8. 确认Data Agent入口
完成以上 Data Agent 配置，且 Data Agent 相关授权安装成功后，在 FineBI 右上角将出现「Data Agent」按钮。
9. 升级ElasticSearch组件
9.1 确认ElasticSearch组件版本
请确保升级 ElasticSearch 组件至 v20.4.5-8.17.3 及以上版本，并确保 ElasticSearch 组件处于 running 状态。
详情请参见：内网升级运维项目。
9.2 自定义ElasticSearch 组件环境变量
请通过开发者模式，自定义 ElasticSearch 组件的环境变量，将 INSTALL_FINE_PLUGIN 的值修改为 yes。
详情请参见：开发者模式。
10. 连接测试
完成以上所有操作后，将成功部署并可进入 Data Agent 页面，在正式使用 Data Agent 平台前，管理员需进行平台和模型连接测试操作。
注：若连接测试出现报错，可前往 大模型问题排查指南 查看。
10.1 平台连接测试
前往「Data Agent 管理后台>应用连接」，完成如下两个操作：
1）在后台地址中添加当前已部署 Data Agent 的 FineBI 地址，地址格式需保持统一，IP 与域名不可混用。
2）点击「连接测试」，以保证 FineAI 插件与 FineBI 平台互通且版本一致。
10.2 模型连接测试
前往「Data Agent 管理后台>模型」，对已添加的目标模型进行连接测试，保证大模型为可用状态。
11. 升级Data Agent
参考文档 升级Data Agent 进行升级。
上一篇：部署Data Agent（已部署使用过FineChatBI版本）