DeepSeek Harnessのツールスコープ、制限、シャドーイング
Updated August 16, 2026 · first published August 16, 2026
ツールカタログは膨らみます。誰かがブラウザツールを足し、誰かがデータベースツールを足し、誰かがターミナル操作を五つ足す。一年後には、必要かどうかに関係なくシステム内のすべてのエージェントに四十個のツールが提示されています。これは普通、安全性の問題として語られます。同時にコスト項目でもあります。DeepSeek Harness は、その両方に一度に効くエージェント単位のスコープモデルを備えています。
カタログが継続コストである理由
ツール定義はリクエストの一部です。ハーネスは、送信されたとおりの設定、システムプロンプト、ツールセットを載せたリクエストヘッダーイベントを記録します。これが論点を具体化します。カタログはセッション中のすべてのモデルリクエストで再送されるため、一度きりの費用ではなくステップごとの固定税です。
もう一つ、より大きな効果があります。広いカタログはモデルの選択空間を広げます。もっともらしいが誤ったツール選択が増えれば、何も生まない無駄なステップが増え、ステップこそが課金単位です。面を刈り込むことで、トークンの下限と誤り率が同時に下がります。
語彙
| 用語 | 意味 |
|---|---|
| スコープ | ツール、プロンプト、変数、制限、リスナーのエージェント単位の登録単位 |
| スコープキー | スコープを識別する不透明な同一性。オブジェクト同一性で比較され、通常は生きているエージェント自身 |
| エージェントコンテキスト | エージェント自身のスコープ付きコンテキスト。登録は寿命に縛られ、スコープ内で可視 |
| 制限（restriction） | 一つのスコープに対するグローバルツールセットの絞り込み。積集合で適用される |
| シャドーイング | スコープ内の項目が同名のグローバル項目を、そのスコープ内に限って置き換えること |
| セットアップウィンドウ | 作成者がエージェントのスコープ世界を組み立てる生成の枠。公開や最初のプロンプト組み立ての前 |
合成の解決順序
まず制限がグローバルセットを絞り込み、その後にスコープローカルの登録が合流します。この順序こそが最小権限を実務的にします。グローバルカタログとの積集合から始めるのでグローバルを超えることは決してなく、そこにこのエージェントが必要とするエージェント固有のツールだけを足します。
シャドーイングは、フォークなしで差し替えを実現します。あるエージェントだけが、見慣れたツール名の裏で別の実装（読み取り専用版、計測付き版、より安いバックエンド）を受け取り、他のエージェントは引き続きグローバル版を見ます。
寿命への束縛が重要なのは dispose と同じ理由です。スコープ登録はエージェントのコンテキストとともに終わるので、短命な子が親の世界へ寄与を漏らすことはありません。
合成はすべて、エージェントが公開され最初のプロンプトを組み立てる前の、セットアップウィンドウで起こります。最初のプロンプトの後に下される権限の判断は、もはや権限の判断ではなく後片付けです。
スコープ付きディスパッチと系譜
あるエージェントに関するイベントは、そのエージェントのキャリアとともにディスパッチされるため、リスナーは誰の活動を見ているか判別できます。レジストリレベルのイベントは絞り込まれません。これとは別に、系譜（親セッション、委譲の深さ、サブエージェントの深さ）は、それ自体が可視性に影響しないデータだと明示されています。
この分離は借用する価値があります。子は子であるという理由でアクセスを継承しません。アクセスはそのセットアップウィンドウで意図的に組み立てられます。既定で継承される権限こそ、安価な要約用サブエージェントが親と同じ高価なツールセットを抱える経路です。
ここから実行する四つのこと
- ツール定義の数を数え、セッションあたりのステップ数を掛ける。それがトークンで見たセッション固定のツール税です。
- エージェントの役割ごとに実用最小のツールセットを定義し、慣習ではなく制限として強制する。
- 価値の低い文脈では高価なツールを完全に外すのではなく、安価版や読み取り専用版でシャドーイングする。
- 親のツールセットを既定でサブエージェントに継承させない。必ず組み立てる。
Related
Want this applied to your own LLM spend? FinOps LLM runs a free audit of your AI costs and shows where the savings are. Book free audit →