2026年8月13日、DeepSeekはMITライセンスの下で開発者向けプレビュー版「DeepSeek Harness」を発表し、プラグインベースのアーキテクチャを採用したオープンソースのエージェントハーネスを公開しました。Cordisメタフレームワークを基盤とするこのプロジェクトは、ランタイム機能を独立して拡張・設定可能なプラグインとして扱います。DeepSeek Harnessは、モデルは自律型システムの一要素に過ぎず、ツール、権限、セッション、実行ポリシーもそれぞれ独立して進化できる必要があるという、実践的なエンジニアリングの課題に対処します。
DeepSeek Harnessとは何か？
DeepSeek Harnessは、言語モデルとホストOS環境の間に位置するように設計された拡張可能なインフラストラクチャレイヤーです。単体で動作するモノリシックなアプリケーションではなく、ツール呼び出し、プロセスのサンドボックス化、セッション状態を管理するモジュール式の実行ランタイムを提供します。
主要な機能
開発者向けプレビュー版では、エンジニアリングチームがいくつかのコアタスクを連携させることが可能です。
-
ワークスペースファイルアクセス：指定されたリポジトリの境界内でプロジェクトファイルの読み取り、作成、変更を行います。
-
シェルおよびコマンド実行：設定可能な権限ポリシーの下で、ターミナルコマンドの実行やバックグラウンドプロセスの管理を行います。
-
モデルプロバイダー設定：設定画面を通じて、DeepSeekモデルへの接続やカスタムのOpenAI互換APIエンドポイントを設定します。
-
タスク委任とサブエージェント：特化したツールセットを持つ独立したサブエージェントを起動し、並行調査の実行や複雑なワークフローの分割を行います。
-
セッション軌跡の再構築：デバッグ、監査、セッション確認のために、ランタイムイベントを追記型のイベントストリームとして記録します。
-
モジュラープラグイン拡張：コアハーネスのランタイムを変更することなく、新しいツール、カスタムイベントリスナー、ユーザーインターフェイスを登録します。
DeepSeek Harnessがプラグインベースのアーキテクチャを採用する理由
概要
-
DeepSeekは、2026年8月13日にDeepSeek V4 Proモデルの本格展開と合わせ、開発者向けプレビュー版「DeepSeek Harness」をMITライセンスで発表しました。
-
このリポジトリでは、モノリシックな実行ループではなく、エージェントの機能を別々のコンポーネントとして実装するプラグインベースのアーキテクチャを採用しています。
-
Cordisカーネルを利用してプラグインのライフサイクルを管理し、開発者がモデルの設定やランタイム機能の拡張をプラグインを通じて行えるようにしています。
自律型ソフトウェアエージェントの開発により、モノリシックなフレームワーク設計における根本的な制限が浮き彫りになってきました。初期のエージェント実装では、モデルへの問い合わせ、ツールの実行、セッション管理が硬直したハードコード済みのループに結合されていることが多くありました。単純なプロンプトとレスポンスのやり取りには十分である一方、ファイルシステムへの深いアクセス、ターミナルオーケストレーション、きめ細かな権限境界を必要とする複雑なエンジニアリングタスクには対応しきれませんでした。
自律型システムがローカルのコードベース全体で動作する場合、状態遷移の管理、実行軌跡のログ記録、セキュリティ制限の強制を行うことができるインフラストラクチャレイヤーが必要となります。DeepSeek Harnessの開発者向けプレビューは、基礎となるモデルと対象ホスト環境の間に拡張可能なハーネスレイヤーを構築することで、この課題に対処します。現在のプレビューでは、開発者はコーディングセッションの実行、ワークスペースファイルの読み取りと編集、コマンドの実行、モデルプロバイダーの設定、タスクの委任、プラグインを通じたランタイムの拡張を行うことができます。
DeepSeek Harnessは、モデルとランタイムの間にプラグインの境界を設けています。モデルを実行ランタイムから切り離すことで、開発者はコアエージェントロジックとの結合度を抑えながら、ツールの定義を更新し、異なるモデルプロバイダーを設定し、ランタイムポリシーを変更することができます。Cordisベースの設定とプラグインの組み合わせにより、このフレームワークはターミナルベースのコーディングユーティリティからヘッドレス自動化サービスまで、多様なフォームファクターへと組み立てることが可能です。
内部の仕組み：DeepSeek HarnessにおけるCordisの活用
技術的な基盤として、DeepSeek Harnessはリサーチ論文『A Programming Paradigm for Spatiotemporal Composability』で概説されているCordisメタフレームワークの上に構築されています。Cordisは、機能がプラグインとして登録されるイベント駆動型コンテキストを提供します。このアーキテクチャのもとでは、エージェントのループは単一のモノリシックなコンポーネントとしてではなく、同じプラグイン指向のランタイムを通じて実装され、個別のフック、サービス、実行リスナーを調整します。
ツールの実行はハーネスランタイムによって仲介され、セッション履歴、権限、実行機能は個別のランタイムコンポーネントおよびプラグインを通じて公開されます。エージェントがアクションを開始すると、その操作は特定のセキュリティポリシーによって制御され、ファイルシステムの変更やシェル実行の安全性が管理されます。
エージェントステップのライフサイクル
自動化された実行を構造化するために、ランタイムはインタラクションを明確な操作の境界へと整理します。
-
ターンとステップの割り当て：ランタイムはエージェントのインタラクションを「ターン」と「ステップ」に整理し、モデルのリクエストやツールの実行は実行ライフサイクル内で処理されます。
-
実行前ガードレール：ツールを呼び出す前に、ファイル書き込みやシェルコマンドを承認されたワークスペースディレクトリに制限できるアクティブなサンドボックスポリシーに対して操作が評価されます。
-
状態の分離：ランタイムは、実行および権限ポリシーに従ってツールの実行を調整し、状態を変更する操作を管理します。以下の図は、実行ループがコンテキストと状態を処理する仕組みを示しています。
[ユーザー入力 / ターン開始] ──> [コンテキストの構築] ──> [モデルリクエスト（ステップ）]
│
▼
[ターン完了] <── [状態の検証] <── [ツールの実行] <── [ガードレールの適用]
ハーネスは、エージェントのインタラクションと実行イベントを追記型のイベントストリームに記録します。このイベントストリームにより、エンジニアリングチームはエージェントセッションの検査、デバッグ、再構築のための信頼性の高い実行記録を得ることができます。
自社開発か外部調達か：DeepSeek Harness対カスタムエージェントランタイム
エージェント型ワークフローを導入する際、エンジニアリングチームは、カスタムのエージェントランタイムをゼロから構築するか、DeepSeek Harnessのようなモジュラーフレームワークを採用するかという根本的なアーキテクチャ上の選択に直面します。独自のインハウスランタイムを構築すれば設計の自由度は完全に担保されますが、サンドボックス化、プロセス監視、セッションロギング、ツールスケジューリングを構築するために多大な開発労力が必要となります。
DeepSeek Harnessは事前構築済みのプラグインランタイムを提供し、インハウスのハーネスはチームに実行とライフサイクル設計に対する完全なコントロールをもたらします。DeepSeek Harnessは現在開発者向けプレビュー段階にあるため、導入するチームは、モジュラーアーキテクチャのメリットを享受しつつ、今後のAPI変更に対応していく必要があります。
以下の表は、デプロイメントアプローチごとの主要なアーキテクチャのトレードオフを比較したものです。
| 項目 | DeepSeek Harness | カスタム内製ランタイム | 緊密に結合されたフレームワーク |
|---|---|---|---|
| プラグインアーキテクチャ | ネイティブのCordisプラグインモデル | カスタムモジュール設計が必要 | 緊密に結合された実行ループ |
| サンドボックス制御 | 組み込みのワークスペース権限ポリシー | 手動での構築と監査が必要 | 限定的、またはフレームワーク依存 |
| セッションテレメトリ | 追記型イベントストリーム | カスタムロギングパイプラインが必要 | 標準的なテキストベースのログ |
| APIの安定性 | 開発者向けプレビュー（変更の可能性あり） | 内部で完全に制御可能 | 安定しているが硬直的 |
| モデルの柔軟性 | 設定ベースのプロバイダーアダプター | 完全なカスタム制御 | 特定のSDKに縛られがち |
| 保守のオーバーヘッド | 継続的な統合メンテナンスが必要 | 完全な内部保守負担 | フレームワーク依存 |
同様の関心の分離パターンは、モバイルの配信やアトリビューションにおいても確認できます。ここでは、ウェブ、アプリストア、インストール済みアプリケーションの境界を越えて、獲得コンテキストを維持する必要があります。OpoInstallは、遅延ディープリンクとサーバーサイドのパラメータ復元を通じてこの課題に対処し、永続的なクライアントサイドのクッキーに依存することなく、インストール後にキャンペーンやリファラコンテキストを紐付けることを可能にします。状態の解決を信頼性の高いサーバーサイドレイヤーに移行することで、複雑なリダイレクトやアプリストアへの遷移を挟んでも、運用のコンテキストがスムーズに維持されるようになります。
統合チェックリスト：DeepSeek Harnessを活用した構築
DeepSeek Harnessエコシステム内でのプラグインの開発とデプロイを体系化するため、エンジニアリングチームは標準化された実装チェックリストに従うべきです。
エンジニアリングチェックリスト
-
プラグイン境界の定義：モデルアダプター、ツール、セッション状態、実行ポリシー、インターフェイスを、独立して置換可能なコンポーネントに分離します。
-
サンドボックスポリシーの確認：ワークスペースの書き込み権限を持つエージェントワークフローをデプロイする前に、どのファイルシステムおよびシェル操作が許可されているかを検証します。
-
ワークスペース権限の検証：エージェントが本番リポジトリで動作する前に、制御されたワークスペース内で読み取り、書き込み、シェル、承認の挙動をテストします。
-
セッションログの検査：軌跡レコードを使用して、失敗したツールの呼び出し、権限の変更、複数ステップの実行パスをデバッグします。
-
プラグイン互換性のテスト：プロジェクトの進化に伴う互換性を損なうアップデートの可能性を考慮し、現在の開発者向けプレビューAPIに対してカスタムプラグインを検証します。
よくある質問（FAQ）
エージェントハーネスと基本的なAPIクライアントの違いは何ですか？
Cordisカーネルは、DeepSeek Harness内でどのようにプラグインを調整しますか？
DeepSeek Harnessのプレビュー版では、どのようなランタイムモードを利用できますか？
エンジニアリングチームにとっての主要なポイント
DeepSeek Harnessのリリースは、現代のAIソフトウェアエンジニアリングにおいてモジュール性が持つ重要性を裏付けています。モノリシックなエージェントアーキテクチャは、ランタイム環境、ツールの定義、セッションの永続性がコアモデルから切り離された、構成可能なフレームワークへと急速に移行しつつあります。
Cordisメタフレームワークを基盤とすることで、DeepSeek Harnessはエージェントのライフサイクル全体にわたる明確な関心の分離を確立します。エージェントランタイムを評価するエンジニアリングチームにとって、プラグインベースのアーキテクチャ、サンドボックスポリシー、構造化されたイベントロギングは、本番環境へのデプロイ前に拡張可能なワークフローをテストするためのより確実な基盤を提供します。
参考文献
Share this article
