Изоляция сервисов и области видимости DeepSeek Harness

В этом разделе мы расскажем, как разные группы плагинов могут видеть разные экземпляры одной и той же службы.

За этим стоитизоляция сервисовиобласть действия агента (scope)механизм Cordis.


Изоляция сервисов: isolate

cordis.yml поддерживает изоляцию сервисов: одна и та же служба может иметь несколько экземпляров, и разные группы плагинов видят разные экземпляры.

Ключевое слово —isolateConfiguration, используется вместе с плагином group для разделения плагинов на группы.

Пример

# Путь к файлу: scratch-plugin/cordis.yml
# Определите две группы плагинов 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 разделяет регистрацию по агентам, тогда как затенение и ограничение соответственно реализуют замену по тому же имени и глобальную фильтрацию.

Проверьте себя:

  1. При isolate: { shell: true }, какова связь между экземплярами Bash для group-a и group-b?
  2. Будут ли регистрации в области видимости унаследованы субагентами?
  3. Какие проблемы решают затенение и ограничение?
Другие расширения