Skip to main content

概要

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

保存してモデルを選択する

プロバイダーを保存し、新しく追加したモデルをモデルピッカーで選択してから、新しいセッションを開始し、接続をテストします。
Web UIでキーを保存すると、DeepSeek Harnessはキーをローカルの認証情報ストアに保存し、マスク済みのディスクリプタのみをページに返します。設定の変更は次のリクエストから有効になり、通常はWeb UIの再起動を必要としません。

オプション2:settings.yamlを設定する

ファイルベースの設定では、$DSH_HOME/settings.yamlにAPIYIプロバイダーを宣言し、環境変数を通じてトークンを参照します。
macOSまたはLinux:
Windows PowerShell:
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_KEYapi: 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.ymlsettings.yaml、ソースコード、またはコミットログに記述しないでください。Web UI の認証情報ストアまたは環境変数参照を使用してください。
  • DeepSeek Harness は開発者プレビューです。アップグレードする前に、プラグイン設定とモデルルートの互換性が維持されていることを確認してください。

よくある質問

現在の設定では、apiyiプロバイダー、openai-responsesプロトコル、https://api.apiyi.com/v1ベース URL、およびデフォルトモデルとしてdeepseek-v4-pro-0813が使用されています。
現在の設定に合わせて、ベース URL にはhttps://api.apiyi.com/v1を、プロトコルにはopenai-responsesを使用してください。エンドポイントの互換性を確認せずにプロトコルを変更しないでください。
プロバイダー ID が空でない小文字の値であること、モデル ID が正しいこと、保存済みの設定がllm-pi-aiプロバイダーに属していることを確認してください。現在のデフォルトはdeepseek-v4-pro-0813です。カスタムモデルを選択するには、事前にmodelsリストに追加する必要があります。
Web UI で 設定 → モデル に戻り、プロバイダーの認証情報を保存してください。settings.yamlを使用している場合は、APIYI_API_KEYが設定されていること、およびapiKeyEnvがその環境変数を指していることを確認してください。
まず APIYI の token とベース URL を確認してください。DeepSeek ハーネスは、OpenAI 互換のカスタムプロバイダーでのモデル検出にGET /modelsを使用します。エンドポイントにそのルートがない場合は、モデル ID を手動で入力してください。
同梱の永続ターミナル構成は Windows エージェントをサポートしていません。Windows ユーザーは Web UI または CLI を使用できます。Python SDK については、プロジェクトドキュメントに記載されているプラットフォーム要件に従ってください。
このプロジェクトは Developer Preview 段階であるため、アップグレードに破壊的変更が含まれる場合があります。最新のプロジェクトドキュメントを参照して、プロバイダー設定、モデル ID、およびプラグイン構成を再確認してください。

関連リソース

APIYI クイックスタート

API キーを取得し、基本 URL と API の基本的な使用方法について学びます。

APIYI モデルの推奨事項

現在のモデル、機能、使用方法に関するガイダンスを確認します。

DeepSeek Harness リポジトリ

github.com/deepseek-ai/deepseek-harness

DeepSeek Harness プロバイダー設定

プロバイダー、認証情報、モデル設定については、プロジェクトのドキュメントを確認してください。

ヘルプを利用する

企業向けWeChatサポート

スキャンしてサポートを追加するか、サポートに直接お問い合わせくださいAPIYIの設定、DeepSeek Harnessの統合、利用方法の案内

メールサポート

サポート: [email protected]ビジネスに関するお問い合わせ: [email protected]
サポートにお問い合わせの際は、問題をより迅速に診断できるよう、プロバイダー、モデルID、ベースURL、APIプロトコル、エラーメッセージ、Node.jsのバージョン、利用モード、関連するスクリーンショットを含めてください。