概要
DeepSeek Harness(dsh)は、DeepSeek AI が開発したオープンソースの AI エージェントハーネスです。「すべてがプラグイン」というアーキテクチャに従い、モデル、ツール、ファイルシステム、ターミナル、セッション、ワークフローを組み合わせて、拡張可能なエージェントランタイムを構築できます。
APIYI を使用すると、DeepSeek Harness をローカルで実行し、APIYI の OpenAI 互換エンドポイントでモデルを設定したり、開発タスクを実行したり、永続セッションを維持したりできます。
🧩 プラグインベースのアーキテクチャ
プラグインを通じてモデル、ツール、セッション、ワークフローを組み合わせ、必要に応じてエージェントを拡張できます。
🌐 Web UI
1つのコマンドでローカル Web UI を起動し、ブラウザでモデル、ワークスペース、セッションを設定できます。
⌨️ ヘッドレス CLI
コマンドラインから単発タスクを送信し、自動化スクリプト、バッチジョブ、開発ワークフローに利用できます。
💾 永続セッション
セッション、ツール呼び出し、ワークスペースの状態を永続化して、タスクを継続したり、実行をトラブルシューティングしたりできます。
プロジェクト情報: DeepSeek Harness は MIT ライセンスで公開されているオープンソースです。プロジェクトリポジトリは
github.com/deepseek-ai/deepseek-harness です。現在は Developer Preview 段階であるため、今後のリリースには互換性を損なう変更が含まれる可能性があります。インストールと起動
npm で Web UI を起動する
Node.js をインストールしてから、次を実行します。http://127.0.0.1:3080 を開きます。初回起動時は、Web UI のモデル設定から APIYI を設定します。
ソースから実行する
リポジトリのソースを実行する場合、またはプロジェクトに貢献する場合は、次を実行します。ヘッドレス CLI を使用する
ソースからビルドした後、次のコマンドで単発タスクを送信します。APIYIへの接続
DeepSeek Harnessは、ネイティブのDeepSeekルートと、llm-pi-aiに基づくマルチプロバイダールートをサポートしています。現在の設定では、apiyiプロバイダー、openai-responsesプロトコル、https://api.apiyi.com/v1エンドポイントを使用しています。デフォルトモデルはdeepseek-v4-pro-0813です。
設定ファイルは$DSH_HOME/settings.yamlです。DSH_HOMEが設定されていない場合、Windowsのデフォルトの場所は通常C:\Users\Administrator\.dsh\settings.yamlです。
オプション1:Web UIから設定する(推奨)
1
APIYIトークンを用意する
APIYIコンソールでトークンを作成します。実際のトークンをプロジェクトファイル、シェル履歴、公開ログに絶対にコミットしないでください。
2
モデル設定を開く
Web UIを起動し、設定 → モデルを開いて、カスタムプロバイダーを追加を選択します。
3
プロバイダーの詳細を入力する
開始点として、以下の値を使用します。
現在の設定では、
deepseek-v4-pro-0813をデフォルトモデルとして使用しています。また、設定ファイルにはその他のAPIYIモデルも保持されています。モデルを切り替える場合は、現在のAPIYIモデル一覧を使用してください。4
保存してモデルを選択する
プロバイダーを保存し、新しく追加したモデルをモデルピッカーで選択してから、新しいセッションを開始し、接続をテストします。
オプション2:settings.yamlを設定する
ファイルベースの設定では、$DSH_HOME/settings.yamlにAPIYIプロバイダーを宣言し、環境変数を通じてトークンを参照します。
apiKeyEnvは認証情報リファレンスにすぎません。実際のトークンをsettings.yamlに記述しないでください。別のモデルを追加するには、そのモデルIDをmodelsリストに追加します。
一般的な使用パターン
ローカル Web エージェント
ブラウザベースの Web UI を使用して、コード分析、ファイル整理、テストのデバッグ、プロジェクトのメンテナンスを行います。セッション用のワークスペースを選択し、目的と制約を自然言語で説明します。自動化タスク
ヘッドレスプロファイルは 1 つのタスクを実行して最終レスポンスを出力するため、ローカルスクリプトや自動化ワークフローに適しています。Python SDK
DeepSeek ハーネスはdeepseek-harness-sdk を提供しており、Python からランタイムを起動してエージェントを呼び出せます。バンドルされた Python ランタイムはデフォルトで deepseek-official を使用する点に注意してください。現在の Web/ヘッドレス構成で使用されている apiyi ルートを自動的に継承することはありません。
apiyi ルートを使用するには、カスタム Cordis 構成で @deepseek-ai/dsh-llm-pi-ai をマウントし、apiKeyEnv: APIYI_API_KEY、api: openai-responses、および APIYI モデル一覧を settings.yaml または構成設定から提供する必要があります。
Python SDK ガイドでは、バンドルされた永続ターミナル構成について、Linux x64、Linux arm64、および arm64 上の macOS 14 以降を対象としています。この構成は Windows エージェントをサポートしていません。Windows ユーザーは Web UI または CLI を優先してください。
モデル選択
APIYI のモデルは継続的に更新されます。本番モデルを選択する前に、最新のモデル一覧、機能、使用に関する推奨事項を確認してください。最新のモデル推奨事項を表示
現在のモデル推奨事項、機能比較、使用ガイダンスを確認してください。APIYI のモデル一覧で現在利用可能なモデル ID を使用してください。
ベストプラクティス
- 独立したタスクごとに個別のセッション ID を使用してください。同じ会話と永続的なシェル状態を継続する必要がある場合にのみ、既存の ID を再利用してください。
- Python SDK の例では書き込み可能なワークスペースと
danger-full-accessコンポジションを使用します。使い捨てのチェックアウトまたはコンテナ内で実行してください。 - API キーを
cordis.yml、settings.yaml、ソースコード、またはコミットログに記述しないでください。Web UI の認証情報ストアまたは環境変数参照を使用してください。 - DeepSeek Harness は開発者プレビューです。アップグレードする前に、プラグイン設定とモデルルートの互換性が維持されていることを確認してください。
よくある質問
現在の設定では、どのプロバイダーとモデルが使用されていますか?
現在の設定では、どのプロバイダーとモデルが使用されていますか?
現在の設定では、
apiyiプロバイダー、openai-responsesプロトコル、https://api.apiyi.com/v1ベース URL、およびデフォルトモデルとしてdeepseek-v4-pro-0813が使用されています。APIYI では、どのベース URL とプロトコルを使用すべきですか?
APIYI では、どのベース URL とプロトコルを使用すべきですか?
現在の設定に合わせて、ベース URL には
https://api.apiyi.com/v1を、プロトコルにはopenai-responsesを使用してください。エンドポイントの互換性を確認せずにプロトコルを変更しないでください。モデルピッカーに使用したいモデルが表示されないのはなぜですか?
モデルピッカーに使用したいモデルが表示されないのはなぜですか?
プロバイダー ID が空でない小文字の値であること、モデル ID が正しいこと、保存済みの設定が
llm-pi-aiプロバイダーに属していることを確認してください。現在のデフォルトはdeepseek-v4-pro-0813です。カスタムモデルを選択するには、事前にmodelsリストに追加する必要があります。MISSING_CREDENTIAL を修正するにはどうすればよいですか?
MISSING_CREDENTIAL を修正するにはどうすればよいですか?
Web UI で 設定 → モデル に戻り、プロバイダーの認証情報を保存してください。
settings.yamlを使用している場合は、APIYI_API_KEYが設定されていること、およびapiKeyEnvがその環境変数を指していることを確認してください。モデル検出で 401 が返された場合はどうすればよいですか?
モデル検出で 401 が返された場合はどうすればよいですか?
まず APIYI の token とベース URL を確認してください。DeepSeek ハーネスは、OpenAI 互換のカスタムプロバイダーでのモデル検出に
GET /modelsを使用します。エンドポイントにそのルートがない場合は、モデル ID を手動で入力してください。Windows で Python SDK を実行できますか?
Windows で Python SDK を実行できますか?
同梱の永続ターミナル構成は Windows エージェントをサポートしていません。Windows ユーザーは Web UI または CLI を使用できます。Python SDK については、プロジェクトドキュメントに記載されているプラットフォーム要件に従ってください。
アップグレードによって設定が壊れた場合はどうすればよいですか?
アップグレードによって設定が壊れた場合はどうすればよいですか?
このプロジェクトは Developer Preview 段階であるため、アップグレードに破壊的変更が含まれる場合があります。最新のプロジェクトドキュメントを参照して、プロバイダー設定、モデル ID、およびプラグイン構成を再確認してください。
関連リソース
APIYI クイックスタート
API キーを取得し、基本 URL と API の基本的な使用方法について学びます。
APIYI モデルの推奨事項
現在のモデル、機能、使用方法に関するガイダンスを確認します。
DeepSeek Harness リポジトリ
github.com/deepseek-ai/deepseek-harnessDeepSeek Harness プロバイダー設定
プロバイダー、認証情報、モデル設定については、プロジェクトのドキュメントを確認してください。
ヘルプを利用する
企業向けWeChatサポート
スキャンしてサポートを追加するか、サポートに直接お問い合わせくださいAPIYIの設定、DeepSeek Harnessの統合、利用方法の案内
メールサポート
サポート: [email protected]ビジネスに関するお問い合わせ: [email protected]