Skip to main content
DeepSeek HarnessをPhaseoに接続すると、HarnessのWeb画面からPhaseoのモデルとルーティングを使えます。カスタムアダプターは不要です。HarnessはOpenAI互換のChat CompletionsリクエストをPhaseoに直接送信できます。 結果： Harnessのモデル選択にPhaseoが表示され、新しいセッションでPhaseoが提供するモデルを使えるようになります。

​
前提条件

  • Phaseo CLI、Phaseoアカウント、インストール済みのDeepSeek Harness
このガイドの実リクエストではプロバイダー認証情報を使うため、モデル利用料が発生する場合があります。

​
Phaseo CLIでセットアップする

1つのコマンドでプロバイダー、Base URL、プロトコル、モデルカタログ、デフォルトモデルを設定します。
$DSH_HOME/cordis.patch.ymlのPhaseo以外の項目は維持され、Phaseoのブロックにマーカーを付けて管理対象の設定だけを更新・削除できるようにします。Chat Completionsに対応したPhaseoの有効なテキストモデルをすべて同期します。必要なら別のデフォルトモデルを指定します。
セットアップでは有効期限のないGatewayキーPhaseo CLI: DeepSeek Harness API Keyも作成し、Harnessの保護された$DSH_HOME/.credentials.yamlストアに直接書き込みます。選択したモデルのみ設定する場合は--catalog defaultを使います。 phaseo integrations remove deepseek-harnessで連携を削除すると、Phaseo管理の設定だけが削除され、CLI作成キーが失効します。

​
Harness画面でPhaseoを手動追加する

  1. DeepSeek HarnessでSettings > Modelsを開きます。
  2. Add a custom providerを選択します。
  3. 次の値を入力します。
  1. Model catalogでFetch available modelsを選択します。
  2. anthropic/claude-sonnet-4.6など、ツールに対応したChat Completionsモデルを選び、プロバイダーを保存します。
  3. 作成画面に戻り、Phaseoモデルを選んで新しいセッションを開始します。
Harnessは保存済みセッションと認証情報参照にプロバイダーIDを記録するため、phaseoは変更しないでください。表示名、URL、認証情報、モデル一覧は後から編集できます。

​
YAMLでPhaseoを設定する

同じプロバイダーを$DSH_HOME/settings.yamlに直接設定できます。APIキーはこのファイルに入れないでください。apiKeyEnvはHarnessが解決する認証情報を指定します。
Harnessを起動する環境にPHASEO_API_KEYを設定するか、Modelsページで同じ認証情報を保存します。YOUR_PHASEO_MODEL_IDはPhaseoのモデル検出で返される正確なIDに置き換えます。コーディングエージェントのワークフローではanthropic/claude-sonnet-4.6から始めてください。
settings.yamlのmodelsリストは保存済みカタログであり、ライブ検索ではありません。HarnessでPhaseoモデルを追加表示する場合は更新してください。

​
接続を確認する

Harnessをテストする前に、認証情報とモデル検出経路を個別に確認します。
次に、新しいHarnessセッションでPhaseoモデルを選択して、以下を送信します。
応答が成功すれば、HarnessからPhaseoを経由して選択したモデルプロバイダーまでの経路全体を確認できます。

​
トラブルシューティング

  • モデル検出で401が返る - Phaseo APIキーが有効で、Base URLに/v1が含まれていることを確認します。
  • モデルが選択肢にない - カタログを再取得するか、$DSH_HOME/settings.yamlのmodelsにPhaseoの正確なモデルIDを追加します。
  • HarnessがMISSING_CREDENTIALを報告する - Modelsページにキーを保存するか、HarnessプロセスからPHASEO_API_KEYを参照できるようにします。
  • リクエストが誤ったエンドポイントを使う - OpenAI Completions / openai-completionsを選びます。このHarness連携ではPhaseoの互換ルート/v1/chat/completionsを使います。
  • 推論有効時にモデルが関数ツールを拒否する - Chat Completionsでツールに対応したモデルを選びます。ツールを使った推論にResponses APIが必要なモデルは、このHarnessプロバイダープロトコルに対応しません。
  • 既存セッションで古いモデルが使われる - 新しいセッションを開始します。Harnessはリクエスト送信後のセッションに選択したプロバイダーとモデルを記録します。

​
関連ガイド

最終更新日 2026年10月2日