1）本文講解如何在已經部署使用過 FineChatBI 的 FineBI 專案中部署啟動 Data Agent。
2）優先建議使⽤ 未部署使用過FineChaBI 的新 FineBI 工程，帆軟不協助處理 ChatBI 升級至 Data Agent 出現的相容問題，若部署後 Data Agent 中攜帶部分 ChatBI 的舊資料，請⾃⾏檢查其是否可⽤，或重新進⾏配置。
3）請按順序完成以下每一步配置操作。
部署Data Agent前，需要先部署 維運平台FineOps 及 FineBI，版本要求如下：
V2.41.0 及以上
FineBI 7.5 系列
FineBI 7.0系列（V7.0.8及以上）
FineBI 和 Data Agent 均依賴維運平台部署，因此使用者需要提前部署好維運平台。
如尚未部署維運平台
請參考文檔部署最新版維運平台：部署維運平台
如已部署維運平台
請參考下文升級維運平台至V2.41.0 及以上版本。
請參考文檔：外網升級維運平台
請參考文檔使用「全量版離線安裝包」部署最新版維運平台：部署維運平台
請使用「全量版離線安裝包」升級維運平台至V2.41.0 及以上版本。
請參考文檔：內網升級維運平台
使用者需要先使用維運平台部署好 FineBI，再對 FineBI 新增 Data Agent 組件，因此需確認以下幾點：
請確定 FineBI 部署方式為「維運平台部署」，不支援「非維運平台部署」
請確定 FineBI 版本在 7.0.8 及以上，建議直接升級到最新版本 FineBI
請參考文檔升級 FineBI：外網升級維運專案、內網升級維運專案
下文提供的鏡像均為最新 Data Agent 鏡像，不同 FineBI 版本適配不同版本的 Data Agent 鏡像，如為歷史版本FineBI，需要交握帆軟技術支援獲取對應版本AI鏡像。
管理者登入 FineBI，點選「管理系統>插件管理>我的插件」，點選「刪除」按鈕，點選彈窗上的「確定」按鈕即可。
注：AI組件的部署入口，預設不直接對外開放。如需部署DataAgent，可以在資源準備階段，提前交握帆軟技術支援或銷售人員，獲取入口開放方法。
部署前需確認 DataAgent 預計日活使用者與高峯同時使用人數，用於選擇適合本企業的伺服器配置。
詳情可參考文檔：確認DataAgent專案伺服器配置。
1）下載 Data Agent 插件：Data Agent 插件
2）管理者登入 FineBI，點選「管理系統>插件管理>應用商城」
3）點選「從本地安裝」，選擇獲取的 Data Agent 插件安裝包，完成安裝即可。
注：插件包較大，因此安裝時間較長，請耐心等待。
Data Agent 鏡像無法直接從雲端倉庫拉取，需要手動推播鏡像入庫。
注1：對於信創版 FineBI，支援在 ARM 架構的信創伺服器中新增 AI 服務。
注2：本文提供的鏡像均為最新 AI 鏡像，不同 FineBI 版本適配不同版本的 AI 鏡像。如需曆史版本鏡像，請聯系帆軟技術支援獲取。
FineAI組件鏡像：FineAI組件鏡像
FineChatBl 語意解析小模型組件鏡像：FineChatBI 語意解析小模型組件鏡像
管理者登入維運平台，點選「維運平台管理>維運組件」。
點選「匯出部署資訊」，匯出成功後會提示匯出的檔案地址。
前往維運平台所在伺服器，在匯出檔案所在的 logs 目錄，同級目錄下，有一個 resources 資料夾，即為鏡像上傳位置。
例如本範例，匯出檔案所在資料夾為/home/ops/fanruan_5d15bea4/ops/logs，那麼鏡像上傳位置為/home/ops/fanruan_5d15bea4/ops/resources
請將上一步下載的兩個鏡像.tar.gz檔案，上傳到 resources 資料夾中
管理者登入維運平台，點選「維護中心>鏡像管理」，點選「載入鏡像」。
即可選擇 resources 下的兩個 AI 鏡像檔案進行載入，載入完成後 resources 下的鏡像檔案會被刪除。
推播成功後，管理者登入維運平台，點選「維護中心>鏡像管理」，查看推播到倉庫的新鏡像。
找到剛剛推播的「fine-ai-bi7」和「fine-chat-bi-parser-bi7」鏡像，記下版本號。
管理者登入維運平台，點選「維運平台管理>更新升級>部署列表>手動修改」。
手動修改 AI 相關的兩個組件的鏡像版本號，確定與鏡像管理中的鏡像版本號完全一致，此時維運平台才會讀取到有待更新的鏡像版本。
參考文檔【卸載後升級Data Agent】，將 FineChatBI 組件升級為 Data Agent 組件。
請確定升級 ElasticSearch 組件至 v20.4.5-8.17.3 及以上版本，並確定 ElasticSearch 組件處於 running 狀態。
詳情請參見：內網升級維運專案。
請透過開發者模式，自訂 ElasticSearch 組件的環境變數，將 INSTALL_FINE_PLUGIN 的值修改為 yes。詳情請參見：開發者模式。
Data Agent 相關授權，請聯系帆軟銷售獲取。
授權安裝方法：根據網路環境，推薦 公有雲認證 （外網）/ 註冊新專案（內網）
成功完成以上操作後，FineBI 右上角將出現「Data Agent」入口按鈕，此時僅完成基礎配置，請繼續本文以下操作 。
完成以上所有操作後，將成功部署並可進入 Data Agent 頁面，在正式使用 Data Agent 平台前，管理者需進行平台和模型連結測試操作。
注：若連結測試出現報錯，可前往 大模型問題排查指南 查看。
前往「Data Agent 管理後台>應用連結」，完成如下兩個操作：
1）在後台地址中新增當前已部署 Data Agent 的 FineBI 地址，地址格式需保持統一，IP 與域名不可混用。
2）點選「連結測試」，以保證 FineAI 插件與 FineBI 平台互通且版本一致。
前往「Data Agent 管理後台>模型」，對已新增的目標模型進行連結測試，保證大模型為可用狀態。