DeepSeek Harness サービス分離とスコープ
この章では、同じサービスに対して、異なるプラグイングループが異なるインスタンスを見られるようにする方法を紹介します。
この背後にあるのは Cordis のサービス分離(service isolation)とagent スコープ(scope)という仕組みです。
サービス分離:isolate
cordis.yml はサービス分離をサポートしています。同じサービスは複数のインスタンスを持つことができ、異なるプラグイングループは異なるインスタンスを参照します。
キーワードはisolate設定です。group プラグインと組み合わせて、プラグインをグループに分けます。
インスタンス
# 2つのプラグイングループ group-a と group-b を定義し、それぞれ shell サービスを分離する
- id: group-a
name: '@deepseek-ai/cordis-plugin-group'
group: true
isolate:
shell: true # グループ内の shell サービスを独立してインスタンス化する
config:
- name: '@deepseek-ai/dsh-bash-local'
config:
timeoutMs: 5000 # group-a の Bash タイムアウトは 5 秒
- name: './src/plugin-a.ts'
- id: group-b
name: '@deepseek-ai/cordis-plugin-group'
group: true
isolate:
shell: true
config:
- name: '@deepseek-ai/dsh-bash-local'
config:
timeoutMs: 60000 # group-b の Bash タイムアウトは 60 秒
- name: './src/plugin-b.ts'
plugin-a と plugin-b はそれぞれ自分のグループ内の Bash インスタンスを参照し、互いに影響しません。
group-a の Bash コマンドは 5 秒でタイムアウトし、group-b は 60 秒でタイムアウトします。両者はお互いの存在を知りません。
なぜ分離が必要か
タスクによって、同じ能力に対する要件がまったく異なる場合があります。
たとえば、高速な対話タスクでは Bash がすぐにタイムアウトすることが望まれ、長時間タスクでは十分な時間が与えられることが望まれます。
分離により、同じサービスをグループごとに設定し、グループごとに有効にすることができます。グローバルに画一的ではありません。
スコープ:scope
scope は agent(エージェント)ごとに区分される登録単位です。
コントリビューション(ツール、プロンプト断片、変数、制限、リスナー)は、グローバルであるか、ちょうど 1 つの scope キーに属します。
| 概念 | 意味 |
|---|---|
| scope | agent ごとに区分される登録単位。2 層のみで、フラットな構造 |
| scope key | scope の不透明な識別子。アクティブな agent は自身の scope のキーである |
| agent.ctx | agent のスコープ付きコンテキスト。登録はスコープの可視性を持ち、ライフサイクルもそのスコープにバインドされる |
| shadowing | 最も具体的なものが優先される名前解決。スコープ付きツール / 断片 / 変数は、自身のスコープ内でのみグローバルの同名項目を置き換える |
| restriction | tools.restrict は単一の scope に対してグローバルツールセットをフィルタリングする。複数の restriction は積集合として組み合わせられる |
| lineage | データとして保持される親子関係の事実(parentSession、delegationDepth など)は、可視性に一切影響しない |
スコープ付きの登録は subagent に継承されません。
サブツリーの動作は scope 構造ではなく、lineage データによって表現されます。
shadowing:最も具体的なものが優先される
shadowing は、agent ごとに persona とツールのバリアントをカスタマイズする仕組みです。
スコープ付きツールは、そのスコープ内でのみ同名のグローバルツールを置き換えます。他の agent は引き続きグローバルバージョンを参照します。
restriction:グローバルツールのフィルタリング
restriction は tools.restrict を使用して、単一の scope に対してグローバルツールセットをフィルタリングします。
フィルタリングされたグローバルツールはプロンプトに入らず、実行も拒否されるため、存在しないツールと区別できません。
言い換えると、restriction は、ある scope 内の agent に特定のグローバルツールを完全に「見えない」状態にします。呼び出し時に拒否するのではありません。
まとめと自己テスト
isolate は同じサービスをグループごとにインスタンス化し、scope は agent ごとに登録を区分し、shadowing と restriction はそれぞれ同名置換とグローバルフィルタリングを実現します。
自己テストしてみましょう:
- isolate: { shell: true } により、group-a と group-b の Bash インスタンスはどのような関係になりますか?
- スコープ付きの登録は subagent に継承されますか?
- shadowing と restriction はそれぞれどのような問題を解決しますか?