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
# 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.
| Concepts | Signification |
|---|---|
| scope | Unités d'enregistrement réparties par agent ; seulement deux couches, adoptant une structure plate. |
| clé de portée | Identifiant opaque d'une portée ; un agent actif est la clé de sa propre portée. |
| agent.ctx | Le 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. |
| masquage | Ré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. |
| restriction | tools.restrict filtre l'ensemble global d'outils pour une seule portée ; plusieurs restrictions sont combinées par intersection. |
| lignage | Les 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 :
- Avec isolate: { shell: true }, quelle est la relation entre les instances Bash de group-a et group-b ?
- Les enregistrements à portée seront-ils hérités par les sous-agents ?
- Quels problèmes le shadowing et la restriction résolvent-ils chacun ?