DeepSeek Harness サービス分離とスコープ

この章では、同じサービスに対して、異なるプラグイングループが異なるインスタンスを見られるようにする方法を紹介します。

この背後にあるのは Cordis のサービス分離(service isolation)とagent スコープ(scope)という仕組みです。


サービス分離:isolate

cordis.yml はサービス分離をサポートしています。同じサービスは複数のインスタンスを持つことができ、異なるプラグイングループは異なるインスタンスを参照します。

キーワードはisolate設定です。group プラグインと組み合わせて、プラグインをグループに分けます。

インスタンス

# ファイルパス:scratch-plugin/cordis.yml
# 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 キーに属します。

概念意味
scopeagent ごとに区分される登録単位。2 層のみで、フラットな構造
scope keyscope の不透明な識別子。アクティブな agent は自身の scope のキーである
agent.ctxagent のスコープ付きコンテキスト。登録はスコープの可視性を持ち、ライフサイクルもそのスコープにバインドされる
shadowing最も具体的なものが優先される名前解決。スコープ付きツール / 断片 / 変数は、自身のスコープ内でのみグローバルの同名項目を置き換える
restrictiontools.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 はそれぞれ同名置換とグローバルフィルタリングを実現します。

自己テストしてみましょう:

  1. isolate: { shell: true } により、group-a と group-b の Bash インスタンスはどのような関係になりますか?
  2. スコープ付きの登録は subagent に継承されますか?
  3. shadowing と restriction はそれぞれどのような問題を解決しますか?
その他の拡張