エージェント・自動化

DeepSeek Harness入門：起動、4つのモード、プラグインの境界

DeepSeek Harnessを隔離したフォルダーで起動し、Standard、PTC、Minimal、Creationを使い分け、権限付与前にTrajectoryを確認します。

BT

BetterToken

編集チーム
1 分で読めます

DeepSeek Harnessは、モデル、tools、skills、session、sandbox、storage、agent loop、scheduling、UIを交換可能なプラグインとして組み合わせるopen sourceのagent環境です。DeepSeekはDeveloper Previewと明記しています。最初の目標は本番リポジトリへの導入ではなく、隔離したフォルダーで追跡可能なrunを1回完了することです。

custom API endpointでモデルを接続する場合は、プラグインを追加する前にprotocol、Base URL、authenticationを確認してください。BetterToken.aiはcustom Base URLを受け付けるtool向けにOpenAI-compatibleとAnthropic-compatibleのinterfaceを提供しますが、すべてのHarnessプラグインとの互換性を意味しません。BetterToken API documentationでprovider schemaとAPI Key設定を確認し、test folderで小さなread-only taskを実行します。

DeepSeekが公開したもの

公式repositoryはMIT licenseで、Cordisを基盤にしています。Cordisはプラグインのload、unload、dependency管理を担当し、agentの機能そのものは各プラグインが提供します。そのため、model、tool layer、sessionを一度に変えず、要素ごとに検証できます。

使い捨てフォルダーでの起動

Node.jsをinstallした後、Web UIを起動します。

npx @deepseek-ai/dsh web
  1. secretや未commitの変更を含まない空のfolderまたはclean cloneを用意します。
  2. Standard modeを選びます。
  3. entry pointの特定や構成説明など、小さなread-only taskを依頼します。
  4. 回答を実ファイルと照合し、編集を許可する前にTrajectoryを確認します。

隔離は一般的なengineering controlであり、Harnessが任意のshell commandを自動的に安全にするという意味ではありません。

4つのモード

  • Standard: file editing、shell、検索、skills、plan、goal、subagent、workflowを備えた完全なcoding agent。最初の実作業はここから始めます。
  • PTC: StandardにCode Mode SDKを追加し、modelが複数のtool callをTypeScript programとして構成します。生成codeと各tool boundaryを確認します。
  • Minimal: persistent bashとstr_replace_editorだけを残した構成です。最小環境やbenchmark baselineに向きます。
  • Creation: Standardにruntime inspection、memory上のCordis plugin実験、preset作成を追加します。custom presetを設計するときに使います。

PTCは品質向上を保証するモードではありません。tool orchestrationを読み取り、再現しやすくする点が利点です。Minimalは日常用の軽量Standardではなく、診断用baselineです。

Trajectoryで確認すること

DeepSeekによると、system prompt、tool callとresult、subagent scheduling、context injectionはappend-only session logに記録されます。Trajectoryで、agentが実際に見たfileとcommand output、予期しないtool call、停止原因がpermission・tool・instruction・contextのどれかを確認します。

プラグインごとに、補う機能、到達できるdataとexternal service、regressionの検知方法、rollback手順を記録してください。community pluginはsourceとdependencyを読んでからinstallします。実データを扱う前に公式quickstartを再確認してください。Developer Previewでは互換性を壊す変更が予定されています。

LLM ワークフローを最適化しませんか？

単一 API でモデルを接続し、キーと AI コストを管理できます。