打造專屬 AI 中台，WorkBuddy 接入 B.AI 模型全圖解教程

在當今快節奏的開發環境中，WorkBuddy 憑藉其靈活的工作流編排與強大的系統級整合能力，已成為眾多開發者桌面端不可或缺的「生產力中樞」。它不僅能夠聚合碎片化的開發工具，更能作為專屬的智慧中台，讓開發者在無需切換上下文的沉浸式環境下直接調用頂尖 AI 能力，從而大幅消除日常任務的執行摩擦，讓核心精力徹底回歸到高價值的思考與創造中。

為了幫助廣大開發者更高效地將 B.AI 的高性能模型矩陣與系統級基礎設施引入日常開發工作流，本文將詳細指引您如何在 WorkBuddy 桌面端添加 B.AI 自訂模型。配置前請準備好 WorkBuddy 帳號、B.AI API Key，以及當前帳號實際可用的模型 ID。接下來，只需跟隨本文的簡單配置，即可在本機解鎖極致流暢的 AI 協作體驗。

一、開始之前

第一步：安裝 WorkBuddy

前往 WorkBuddy 官方下載頁面，根據您的系統環境選擇對應的安裝包。已經安裝 WorkBuddy 的用戶可以跳過本步。若找不到「模型」或「添加模型 」選項，先選擇「檢查更新」 進行版本升級。

Windows

官方頁面當前提供 Windows x64（相容 ARM64） 安裝包，要求 Windows 10 或更高版本。下載安裝程式後，雙擊並按精靈完成安裝，再啟動 WorkBuddy。

注意：如果系統阻止安裝，請先確認安裝包來自官方頁面，再檢查彈窗中的應用名稱與發佈者資訊。不要通過關閉 Windows 安全防護繞過檢查。

macOS

官方頁面當前分別提供 Apple 晶片版和 Intel 版 .dmg，要求 macOS 12.0 或更高版本。

• M1、M2、M3、M4 等機型選擇 Apple 晶片版。
• Intel 處理器機型選擇 Intel 版。

打開 .dmg 後，將 WorkBuddy 拖入「應用程式」，再從應用程式資料夾啟動。如果不確定晶片類型，可在「關於本機」中查看「晶片」或「處理器」。

其他系統說明

目前 WorkBuddy 桌面端僅支援 Windows 與 macOS，暫不支援 Linux。同時，考慮到行動端與鴻蒙端的功能範圍不同，本教學的所有操作均以桌面端為準。

第二步：登入 WorkBuddy

首次啟動時，點擊「登陸」，按客戶端顯示的方式完成認證。國際版官方文檔列出 Google 和 GitHub OAuth。如果當前客戶端顯示微信掃碼或其他入口，以客戶端實際選項為準。

第三步：獲取 B.AI API Key

請先登入 B.AI，在左側導覽列中進入 API 管理或 API Key 管理頁面，點擊「建立 API Key」並為其設置一個便於識別的名稱（例如 WorkBuddy）。由於 B.AI 的官方機制限制，完整的 Key 只會在建立成功時顯示一次，因此請務必在建立後立即複製並妥善保存。

配置前的重要確認事項：

• 前置檢查：配置前請確認帳號有可用額度，且該 API Key 對目標模型具有調用權限。
• 模型 ID 獲取：模型 ID 應以 B.AI GET /v1/models 的返回結果或當前控制台列表為準，不能只參考其他教學中的範例名稱。
• 協議相容性：WorkBuddy 自訂模型使用 OpenAI Chat Completions 協議，因此目標模型還必須對該端點開放。只支援 Anthropic Messages 或 OpenAI Responses 的配置不能直接填入。

注意：不要在文章、截圖、聊天記錄或公開倉庫中暴露完整 Key。如果懷疑 Key 已洩露，請立即刪除舊 Key、建立新 Key，並更新 WorkBuddy 配置。

二、透過介面配置 B.AI API

第一步：打開自訂模型配置

打開 WorkBuddy，點擊左下角帳戶頭像，選擇「設置 」。

在左側選擇「模型」，點擊「添加模型」。

如果當前列表中已有其他自訂模型，請確保點擊「添加模型」新增配置，切勿直接覆蓋無關模型的參數。若您需要修改現有的 B.AI 模型，只需點擊該模型旁邊的鉛筆圖示即可。如果您希望在修改的同時保留舊版模型，則應當作全新模型重新添加一條配置。

第二步：填寫接入參數

在「提供商」下拉列表中選擇「自訂」，在彈出的頁面中填寫相關資訊。

填寫說明如下：

URL 與「 自訂協議」必須成對設置：

根據 WorkBuddy 官方文檔，當「自訂協議」關閉時，客戶端會按照標準的 OpenAI Chat Completions 規則，自動在填寫的 URL 末尾補全 /chat/completions 路徑；當該開關開啟時，客戶端將直接向您填寫的完整 URL 發起請求，不再進行任何路徑拼接。注意不要把兩種方式混用。重複拼接成 /v1/chat/completions/chat/completions 時，通常會返回 404。

第三步：設置模型能力

「進階設定」中的開關只用於聲明模型能力，勾選後不會讓原本不支援的模型自動獲得能力。請根據實際情況，參考以下原則進行配置：

無法確認輸入、輸出上限時，保留「使用供應商預設值」。未經文檔或實測確認，不要預設開啟全部能力。

第四步：保存配置

檢查 URL、API Key 和模型 ID 後，點擊「保存」。新模型應出現在「已保存模型」列表中。

如果沒有顯示，依次檢查保存彈窗是否仍然打開、欄位是否報錯、模型選擇器是否刷新以及客戶端版本。必要時完全退出 WorkBuddy 後重新啟動。模型出現在列表中，只能說明配置已保存，不能證明 B.AI 調用已經成功，仍需進行後續驗證。

三、選擇模型並驗證配置

第一步：選中 B.AI 自訂模型

返回「新建任務」，打開輸入框附近的模型選擇器，在自訂模型分組中選擇剛添加的模型。測試期間不要選擇“Auto”模式，“Auto”模式可能調度其他模型，無法證明本次請求使用了 B.AI。

第二步：驗證普通對話

發送一條不依賴工具的簡單問題：

請只回覆：B.AI 普通對話測試成功

收到正常回覆後，說明 WorkBuddy 已讀取配置，並且 Key、URL 與模型 ID 至少可以完成一次文本調用。如果失敗，按「當前模型 → API Key → URL 與協議開關 → 模型 ID → 額度與權限」的順序檢查。不要通過詢問模型「你是誰」判斷路由是否成功，模型自報身份不能作為接入證據。

第三步：驗證工具調用

請先新建一個只用於測試的資料夾，放入一兩個不含隱私資訊的文本檔案，接著在 WorkBuddy 中將該資料夾選為 workspace，並僅授予完成讀取任務所需的權限，最後發送以下指令：

請讀取當前工作空間中的文本檔案，列出檔案名稱並各用一句話總結內容。不要修改、移動或刪除任何檔案。

WorkBuddy 顯示檔案讀取工具調用，並正確返回檔案摘要，才說明工具調用鏈路可用。能聊天但不能讀檔案時，檢查工具調用、模型工具調用能力、B.AI 端點支援以及工作空間權限。

第四步：核對 B.AI 調用記錄

若 B.AI 控制台提供用量或調用記錄，請前往核對近期的請求時間、模型 ID、請求次數以及 Token 消耗量，確保數據與剛剛的測試相符。

為了確保整個接入流程完整可用，請逐一核查以下三個階段的成功狀態：

四、常見問題

1、找不到自訂模型入口怎麼辦？

可能是尚未登入、客戶端版本較舊，或打開的不是桌面端模型設置。先登入，再進入「設置」→「模型」。若依然找不到入口，選擇「檢查更新」更新客戶端並重啟。問題持續時，通過「幫助與回饋」提交版本號和截圖。

2、Windows 或 macOS 無法安裝或打開怎麼辦？

先確認系統版本滿足要求、安裝包來自官方頁面，並檢查下載的架構是否正確。按系統提供的安全設置流程處理攔截，不要關閉安全防護，也不要改用不明鏡像。

3、保存後為什麼沒有顯示模型？

先確認「已保存模型」中是否存在該條目，再關閉設置並重新打開模型選擇器。仍未顯示時完全退出並重啟 WorkBuddy，同時檢查客戶端更新。

4、出現 401、403、404、429 是什麼原因，如何解決？

每次只需修改一項，再用普通對話重測，便於定位原因。

5、出現 “model not found”提示如何解決？

重新調用 GET /v1/models 或查看當前控制台列表，複製準確的 id。不要填寫展示名稱、別名或其他教學中的版本號。還要確認該模型對 Chat Completions 端點開放。

6、一直載入、超時或連接失敗怎麼辦？

請先確認網路可以存取 https://api.b.ai，再用簡短問題進行測試。隨後檢查 URL、代理或企業網路策略、B.AI 服務狀態，以及輸入檔案是否過大。問題持續時記錄發生時間、WorkBuddy 版本、完整錯誤資訊與請求 ID，再聯繫官方支援。

7、能聊天但不能讀取檔案怎麼辦？

按「模型能力 → Tool Calling 開關 → 工作空間 → 檔案權限」的順序檢查。先用普通文本檔案測試，不要直接選擇系統目錄、受保護目錄或敏感檔案。

8、為什麼系統仍然在調用內建模型？ 

請檢查模型選擇器，確保未處於“Auto”狀態，且已明確選中已配置的 B.AI 自訂模型。發送一個簡短的問題，然後前往 B.AI 控制台核對調用時間與用量數據。如仍有疑問，建議新建一個對話任務重新測試。

9、關閉軟體後，下次怎麼啟動？

Windows