Изоляция сервисов и области видимости DeepSeek Harness
В этом разделе мы расскажем, как разные группы плагинов могут видеть разные экземпляры одной и той же службы.
За этим стоитизоляция сервисовиобласть действия агента (scope)механизм Cordis.
Изоляция сервисов: isolate
cordis.yml поддерживает изоляцию сервисов: одна и та же служба может иметь несколько экземпляров, и разные группы плагинов видят разные экземпляры.
Ключевое слово —isolateConfiguration, используется вместе с плагином group для разделения плагинов на группы.
Пример
# Определите две группы плагинов 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 # Таймаут Bash для group-a — 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 # тайм-аут Bash группы group-b: 60 секунд
- name: './src/plugin-b.ts'
plugin-a и plugin-b видят экземпляр Bash в своей собственной группе, не влияя друг на друга.
Bash-команды группы Group-a завершаются по тайм-ауту через 5 секунд, группы group-b — через 60 секунд; обе стороны не знают о существовании друг друга.
Зачем нужна изоляция
Разные задачи могут предъявлять совершенно разные требования к одной и той же возможности.
Например, задачи быстрого взаимодействия хотят, чтобы Bash быстро завершался по тайм-ауту, а длительным задачам нужно дать достаточно времени.
Изоляция позволяет настраивать один и тот же сервис и применять настройки по группам, а не глобально одним универсальным способом.
Область: scope
Область — это единица регистрации, разделённая по агенту.
Вклад (инструмент, сегмент подсказки, переменная, ограничение, слушатель) либо глобальный, либо принадлежит ровно одному ключу области.
| Концепции | Значение |
|---|---|
| scope | Единицы регистрации, разделённые по агенту; только два уровня, используется плоская структура. |
| ключ области видимости | Непрозрачный идентификатор области видимости; активный агент является ключом своей собственной области видимости. |
| agent.ctx | Контекст агента с областью видимости; регистрация видима в области видимости, и её жизненный цикл также привязан к этой области видимости. |
| затенение | Разрешение имён по принципу «побеждает наиболее конкретное»: инструменты/сегменты/переменные с областью видимости заменяют глобальные элементы с тем же именем только в пределах своей области видимости. |
| ограничение | tools.restrict фильтрует глобальный набор инструментов для одной области видимости; несколько ограничений объединяются пересечением. |
| происхождение | Факты о связях родитель-потомок, передаваемые как данные (parentSession, delegationDepth и т. д.), никогда не влияют на видимость. |
Регистрации с областью видимости не наследуются вниз к субагентам.
Поведение поддерева выражается через данные о происхождении, а не через структуру области видимости.
Затенение: побеждает наиболее конкретное.
Затенение — это механизм настройки вариантов персоны и инструментов для каждого агента.
Инструмент с областью видимости заменяет глобальный инструмент с тем же именем только в пределах этой области; другие агенты по-прежнему видят глобальную версию.
Ограничение: фильтрация глобальных инструментов
Ограничение использует tools.restrict для фильтрации набора глобальных инструментов в пределах одной области.
Отфильтрованные глобальные инструменты не попадают в промпт и не допускаются к выполнению, что делает их неотличимыми от несуществующих инструментов.
Иными словами, ограничение делает агентов в области видимости полностью "неспособными видеть" определённые глобальные инструменты, а не отклоняет их в момент вызова.
Итоговая самопроверка
isolate создаёт один и тот же сервис по группам, scope разделяет регистрацию по агентам, тогда как затенение и ограничение соответственно реализуют замену по тому же имени и глобальную фильтрацию.
Проверьте себя:
- При isolate: { shell: true }, какова связь между экземплярами Bash для group-a и group-b?
- Будут ли регистрации в области видимости унаследованы субагентами?
- Какие проблемы решают затенение и ограничение?