TechFlow Logo
ログイン/ 登録
ETHガス
Gwei
恐怖
gas
専用AIプラットフォーム構築:WorkBuddyによるB.AIモデル連携 徹底図解チュートリアル

専用AIプラットフォーム構築:WorkBuddyによるB.AIモデル連携 徹底図解チュートリアル

2026.09.23
共有先
WorkBuddy と B.AI モデルの接続を瞬時に完了し、トップクラスの AI 機能をシームレスに活用して、あなた専用のインテリジェント開発ワークフローを迅速に構築します。

現在のスピード感のある開発環境において、WorkBuddyはその柔軟なワークフローオーケストレーションと強力なシステムレベルの統合機能により、多くの開発者のデスクktop環境に欠かせない「生産性のハブ」として定着しています。断片的な開発ツールを一元管理できるだけでなく、専用スマートミドルウェアとして機能し、開発者がコンテキストを切り替えなくても没入型環境で最先端のAI機能を直接利用できるため、日常業務の実行に伴う摩擦を大幅に軽減し、中核的なリソースを高価値な思考と創造に専念させることができます。

多くの開発者がB.AIの高パフォーマンスなモデル群とシステムレベルインフラを日常的な開発ワークフローに効率的に組み込めるよう、本稿ではWorkBuddyデスクトップ版にB.AIカスタムモデルを追加する方法を詳細に解説します。設定に先立ち、WorkBuddyアカウント、B.AI API Key、および該当アカウントで実際に使用可能なモデルIDをご用意ください。あとは本記事の手順に従って簡単に設定を行うだけで、ローカル環境で極めてスムーズなAI協働体験を実現できます。

一、設定を開始する前に

第1ステップ: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 を「アプリケーション」フォルダへドラッグ&ドロップし、アプリケーションフォルダから起動します。チップの種類が不明な場合は、「Mac について」画面の「チップ」または「プロセッサ」欄でご確認ください。

その他のシステムに関する説明

現在、WorkBuddy デスクトップ版は Windows と macOS のみ対応しており、Linux は未対応です。また、モバイル版や HarmonyOS 版での機能範囲が異なることを考慮し、本チュートリアルのすべての操作はデスクトップ版を基準としています。

第2ステップ:WorkBuddy へのログイン

初回起動時には「ログイン」をクリックし、クライアントに表示される方法に従って認証を完了させてください。国際版の公式ドキュメントでは Google および GitHub OAuth が記載されていますが、現在ご利用のクライアントで WeChat QR コードスキャンやその他のログイン手段が表示されている場合は、実際のクライアント選択肢を優先してください。

第3ステップ: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 の設定を更新してください。

二、UI から B.AI API を設定する

第1ステップ:カスタムモデル設定画面を開く

WorkBuddy を開き、左下のアカウントアイコンをクリックして「設定」を選択してください。

左側から「モデル」を選択し、「モデルを追加」をクリックしてください。

現在の一覧に他のカスタムモデルが登録されている場合、「モデルを追加」をクリックして新規設定を作成することを忘れないでください。他モデルのパラメータを上書きしないでください。既存の B.AI モデルを変更したい場合は、そのモデル横にある鉛筆アイコンをクリックするだけです。変更しながら旧モデルも保持したい場合は、新たなモデルとして別の設定を新しく追加してください。

第2ステップ:接続パラメータの入力

「プロバイダー」のドロップダウンリストから「カスタム」を選択し、表示されたダイアログに関係情報を入力してください。

入力の説明は以下の通りです:

image

URL と「カスタムプロトコル」は必ずペアで設定してください:

image

WorkBuddy の公式ドキュメントによると、「カスタムプロトコル」をオフにしている場合、クライアントは標準の OpenAI Chat Completions ルールに従い、入力した URL の末尾に自動的に /chat/completions パスを補完します。一方、このスイッチをオンにすると、クライアントは記入した完全な URL へ直接リクエストを送信し、パスの結合は一切行いません。両方の方法を混ぜて使わないように注意してください。重複してパスを結合し /v1/chat/completions/chat/completions になってしまうと、通常 404 エラーが返されます。

第3ステップ:モデル能力の設定

「高度な設定」内のスイッチはモデル能力を示すためだけのものであり、チェックを入れることで元々サポートしていないモデルに自動的に能力が付与されるわけではありません。実際の状況に基づき、以下の原則を参考に設定してください:

image

入力・出力の上限値が確認できない場合は、「プロバイダーのデフォルト値を使用」を維持してください。ドキュメントや実測で確認しない限り、全ての機能を初期状態で有効にしないでください。

第4ステップ:設定の保存

URL、API Key、モデル ID を確認した後、「保存」をクリックしてください。新規モデルは「保存済みモデル」一覧に表示されるはずです。

表示されない場合は、順に保存ダイアログが開いたままになっていないか、フィールドにエラーがないか、モデルセレクターが更新されているか、クライアントのバージョンなどを確認してください。必要に応じて WorkBuddy を完全に終了してから再起動してください。モデルが一覧に表示されたことは設定が保存されたことを示すだけであり、B.AI からの呼び出しが成功した証明にはなりません。引き続き後続の検証を行ってください。

三、モデルの選択と設定検証

第1ステップ:B.AI カスタムモデルを選択する

「新規タスク」に戻り、入力ボックス付近のモデルセレクターを開き、カスタムモデルグループから先ほど追加したモデルを選択してください。テスト中は「Auto」モードを選ばないでください。「Auto」モードは他のモデルをスケジューリングする可能性があるため、今回のリクエストで B.AI が使用されたことを証明できません。

第2ステップ:通常会話の検証

ツールの依存しない簡単な質問を送信してください:

「B.AI 通常会話テスト成功」とのみ回答してください

正常な応答を受領できたら、WorkBuddy が設定を読み取っており、Key、URL、モデル ID の少なくともいずれかの組み合わせでテキスト呼び出しが完了したことを示します。

失敗した場合は、「現在選択中のモデル → API Key → URL とプロトコルスイッチ → モデル ID → クレジット残高と権限」の順序で確認してください。モデルに「あなたは誰ですか」と聞いてルーティングの成功を判断しないでください。モデルからの自己紹介は接続証拠としてはなりません。

第3ステップ:ツール呼び出しの検証

まずテスト専用のフォルダを新規作成し、個人情報を含んでいないテキストファイルを 1〜2 つ格納してください。次に WorkBuddy 内で当該フォルダをワークスペースとして選択し、読み取りタスク完了に必要な権限のみを付与し、最後に次の指示を送信してください:

現在のワークスペース内にあるテキストファイルを読み込み、ファイル名を列挙し、各ファイルを一文で要約してください。いずれのファイルも修正、移動、削除しないでください。

WorkBuddy がファイル読み取りツールの呼び出しを表示し、ファイルの要約を正しく返して初めて、ツール呼び出しリンクが使用可能であると判断できます。チャットは可能だがファイルを読み取れない場合は、ツール呼び出しの設定、モデルのツール呼び出し対応能力、B.AI エンドポイントのサポート状況、およびワークスペースの権限を確認してください。

第4ステップ:B.AI の呼び出し履歴を照合する

B.AI コンソールで使用量または呼び出し履歴が提供する場合は、そちらにアクセスし、直近のリクエスト時刻、モデル ID、リクエスト回数、トークン消費量を照合して、データが先ほどのテスト結果と一致していることを確認してください。

接続プロセス全体が完全に使用可能であることを確保するため、以下の 3 つの段階における正常状態を一つずつ確認してください:

image

四、よくある質問

1、カスタムモデルの入口が見つからない場合はどうすればよいですか?

ログインしていない、クライアントのバージョンが古い、あるいはデスクトップ用のモデル設定画面を開いていない可能性があります。まずはログインし、「設定」→「モデル」へ進んでください。それでも見つからない場合は、「アップデートを確認」を選択してクライアントを更新し、再起動してください。問題が続く場合は、「ヘルプとフィードバック」からバージョン番号とスクリーンショットを投稿してください。

2、Windows または macOS でインストールまたは起動ができない場合はどうすればよいですか?

まずシステムバージョンが要件を満たしていること、インストーラーが公式ページ由来であること、ダウンロードしたアーキテクチャが正しいことを確認してください。システムが提供するセキュリティ設定の手順に沿ってブロック処理を行い、セキュリティ保護機能を無効にしたり、信頼できないミラーサイトを使用したりしないでください。

3、保存してもモデルが表示されないのはなぜですか?

まず「保存済みモデル」に一覧項目が存在するか確認し、設定を閉じてからモデルセレクターを再度開いてください。それでも表示されない場合は WorkBuddy を完全に終了して再起動し、同時にクライアントの更新を確認してください。

4、401、403、404、429 エラーが発生するのはなぜで、どのように解決すればよいですか?

image

一度に変更するのは一つの変更に留め、その後通常会話で再テストすることで原因の特定を容易にしてください。

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 ではスタートメニューまたはデスクトップショートカットから起動し、macOS ではアプリケーションまたは launchpad から起動できます。再起動後もカスタムモデルが表示されない場合は、まず現在のアカウントがログイン状態にあることを確認し、その後「設定」→「モデル」へ進み保存済みモデル一覧を確認してください。

10、PC を変えた場合、再設定が必要ですか?

再設定することをお勧めします。WorkBuddy UI でカスタムモデルは PC 内の .workbuddy/models.json に書き込まれる旨が示されており、同じアカウントにログインしたからといって API Key やモデル設定が同期されると想定してはいけません。新しい PC ではモデルを再追加し、2 つの検証をすべて完了させてください。また、キーの共有はチャットや公開クラウドストレージ、暗号化されていない文書経由で行わないでください。

参考文献:

  • WorkBuddy 公式ダウンロードページ
  • WorkBuddy 公式モデル設定ドキュメント
  • WorkBuddy Windows インストールガイド
  • WorkBuddy macOS インストールガイド
  • B.AI API リファレンス
  • B.AI API キー取得ガイド