DeepSeek Harness

このガイドでは、オープンソースの DeepSeek Harness から Felo API Platform のモデルを利用する方法を説明します。推奨方法では Harness 標準の deepseek-official adapter を使います。Web UI で Felo を独立したカスタム OpenAI-compatible provider として追加することもできます。

DeepSeek Harness は現在 developer preview であり、今後互換性を壊す変更が入る可能性があります。画面や設定項目がこのガイドと異なる場合は、上流プロジェクトの最新リリースノートも確認してください。

始める前に

Node.js と Felo API Platform key が必要です。key はソース管理に登録しないでください。

export FELO_API_KEY="YOUR_API_KEY"

この例では deepseek-v4-flash を使います。別のモデル ID を選ぶ前に、モデルと料金を確認してください。

推奨設定：標準 DeepSeek Adapter

DeepSeek Harness の標準 adapter は、credential を DEEPSEEK_API_KEY、endpoint を DEEPSEEK_BASE_URL から読み取ります。

export DEEPSEEK_API_KEY="$FELO_API_KEY"
export DEEPSEEK_BASE_URL="https://openapi.felo.ai/api/v1"
npx @deepseek-ai/dsh web

http://127.0.0.1:3080 を開き、次の操作を行います。

1. プロジェクト workspace を追加または選択します。
2. 設定 → モデルを開きます。
3. deepseek-official provider と deepseek-v4-flash モデルを選びます。
4. 新しい session を作成し、小さな repository タスクを送信します。

Base URL に /chat/completions を追加しないでください。標準 adapter が {DEEPSEEK_BASE_URL}/chat/completions を自動的にリクエストします。

環境変数を保存する

DeepSeek Harness は起動ディレクトリの .env ファイルを読み取れます。毎回 export したくない場合は、バージョン管理対象外の .env に次の値を保存します。

DEEPSEEK_API_KEY=YOUR_API_KEY
DEEPSEEK_BASE_URL=https://openapi.felo.ai/api/v1

このファイルは commit しないでください。ユーザーレベルで設定する場合は、$DSH_HOME 配下の Harness credential ファイルと settings ファイルも利用できます。

代替設定：カスタム OpenAI-compatible Provider

標準 DeepSeek 接続を上書きせず、Felo を別の provider として表示したい場合はこちらを使います。

1. npx @deepseek-ai/dsh web で Web UI を起動します。
2. 設定 → モデルを開きます。
3. カスタム提供元を追加を選びます。
4. 次の値を入力して保存します。

モデルの取得に失敗した場合は、モデル ID を手動で追加してください。提供元の利用可能なモデルを取得は OpenAI-compatible の GET /models route に依存しますが、手動設定では成功する必要はありません。

設定を確認する

新しい session を作成し、次の prompt を送信します。

この repository を要約し、主要な package を挙げてください。

deepseek-v4-flash を選択した session が認証エラーや unknown-model エラーなしで完了すれば、設定は完了です。

推奨 adapter の非対話 smoke test は、対象 workspace で次を実行します。

npx @deepseek-ai/dsh --profile headless "この workspace のトップレベルのファイルを一覧にしてください。"

Web Search について

この設定が Felo にルーティングするのはモデルリクエストです。DeepSeek Harness 標準の web_search provider には別の endpoint 要件があり、既定の credential 変数が同じ DEEPSEEK_API_KEY であっても設定は独立しています。明示的に互換性のある search endpoint を利用する場合を除き、DEEPSEEK_SEARCH_BASE_URL を Felo に向けないでください。Felo の検索が必要な場合は、Chat API または対応する Felo Skills を別途利用します。

トラブルシューティング

次のステップ

• DeepSeek Harness repository
• LLM API リファレンス
• Chat API リファレンス
• AI Agent 向け Felo Skills