DeepSeek Harness Isolation des services et portées

Dans cette section, nous présenterons comment différents groupes de plugins peuvent voir différentes instances du même service.

Derrière cela se trouve le mécanisme de Cordis :isolation des servicesetportée d'agent (scope).


Isolation des services : isoler

cordis.yml prend en charge l'isolation des services : le même service peut avoir plusieurs instances, et différents groupes de plugins voient différentes instances.

Le mot-clé estisolateConfiguration, utilisé avec le plugin group pour diviser les plugins en groupes.

Exemple

# Chemin du fichier : scratch-plugin/cordis.yml
# Définir deux groupes de plugins group-a et group-b, chacun isolant un service shell
- id
: group-a
  name
: '@deepseek-ai/cordis-plugin-group'
  group
: true
  isolate
:
    shell
: true              # Permettre aux services shell de ce groupe d'être instanciés indépendamment
  config
:
    - name
: '@deepseek-ai/dsh-bash-local'
      config
:
        timeoutMs
: 5000      # Délai d'attente Bash de group-a : 5 secondes
    - 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     # délai d'expiration Bash de group-b : 60 secondes
    - name
: './src/plugin-b.ts'

plugin-a et plugin-b voient chacun l'instance Bash au sein de leur propre groupe, sans s'affecter mutuellement.

Les commandes Bash de Group-a expirent après 5 secondes, celles de group-b après 60 secondes ; les deux côtés ignorent l'existence l'un de l'autre.

隔离组与作用域示意图


Pourquoi l'isolation est nécessaire

Différentes tâches peuvent avoir des exigences complètement différentes pour une même capacité.

Par exemple, les tâches à interaction rapide veulent que Bash expire rapidement, tandis que les tâches longues veulent qu'on leur accorde suffisamment de temps.

L'isolation permet qu'un même service soit configuré et prenne effet par groupe, plutôt qu'une approche globale uniforme.


Portée : scope

La portée est une unité d'enregistrement répartie par agent.

Une contribution (outil, segment de prompt, variable, restriction, écouteur) est soit globale, soit appartient à exactement une clé de portée.

ConceptsSignification
scopeUnités d'enregistrement réparties par agent ; seulement deux couches, adoptant une structure plate.
clé de portéeIdentifiant opaque d'une portée ; un agent actif est la clé de sa propre portée.
agent.ctxLe contexte de portée de l'agent ; l'enregistrement a une visibilité de portée, et son cycle de vie est également lié à cette portée.
masquageRésolution de noms « le plus spécifique gagne » : les outils/segments/variables de portée remplacent les éléments globaux du même nom uniquement dans leur propre portée.
restrictiontools.restrict filtre l'ensemble global d'outils pour une seule portée ; plusieurs restrictions sont combinées par intersection.
lignageLes faits de relation parent-enfant transportés sous forme de données (parentSession, delegationDepth, etc.) n'affectent jamais la visibilité.

Les enregistrements de portée ne sont pas hérités vers le bas par les sous-agents.

Le comportement du sous-arbre est exprimé par les données de lignage, et non par la structure de portée.


Shadowing : le plus spécifique gagne.

Le shadowing est un mécanisme permettant de personnaliser les variantes de persona et d’outil par agent.

Un outil à portée remplace l’outil global du même nom uniquement dans cette portée ; les autres agents voient toujours la version globale.


Restriction : filtrage des outils globaux

La restriction utilise tools.restrict pour filtrer l’ensemble d’outils globaux pour une seule portée.

Les outils globaux filtrés n’entrent pas dans le prompt et ne sont pas autorisés à s’exécuter, ce qui les rend indiscernables d’outils inexistants.

En d’autres termes, la restriction fait que les agents d’une portée sont complètement « incapables de voir » certains outils globaux, plutôt que de les rejeter au moment de l’appel.


Auto-test du résumé

isolate instancie le même service par groupe, scope divise l’enregistrement par agent, tandis que le shadowing et la restriction implémentent respectivement le remplacement de même nom et le filtrage global.

Testez-vous :

  1. Avec isolate: { shell: true }, quelle est la relation entre les instances Bash de group-a et group-b ?
  2. Les enregistrements à portée seront-ils hérités par les sous-agents ?
  3. Quels problèmes le shadowing et la restriction résolvent-ils chacun ?
autres extensions