Профили и модели субагентов

Каждый редактируемый профиль субагента содержит собственную политику модели. Можно назначить точную пару провайдер/модель или выбрать Наследовать от родителя, чтобы использовать фактические провайдер и модель родительского чата. При этом субагент не наследует режим, инструкции или инструменты родителя.

Настройка профиля

Откройте Настройки → Sub Agents и измените встроенный или пользовательский профиль. Можно настроить описание для маршрутизации, инструкции, инструменты, модель, необязательный уровень reasoning, поиск навыков и состояние включения. Встроенные профили постоянны; полные пользовательские профили также можно добавлять и удалять. Определения плагинов доступны только для чтения, но их можно включать и отключать.

Выпадающий список начинается с Наследовать от родителя, а затем объединяет доступный каталог Kodik, модели Ollama и модели настроенных Custom Provider. Kodik явно сохраняет выбранную политику:

Провайдер	Сохраняемая ссылка
Родительский чат	"inherit"
Облако Kodik	{ "provider": "kodik", "modelId": "<точный-id>" }
Ollama	{ "provider": "ollama", "modelId": "<точный-id>" }
Custom Provider	{ "provider": "custom-provider", "providerId": "<id-провайдера>", "modelId": "<точный-id>" }

Уровень reasoning — необязательное независимое переопределение профиля. При выборе Наследовать от родителя Settings предлагает уровни, поддерживаемые текущей родительской моделью; сохранённый уровень также должен поддерживаться фактической родительской моделью в чате, где запускается субагент.

Проверка доступности

Settings постоянно сравнивает настроенные профили с текущим каталогом моделей Kodik, endpoint Ollama, Custom Provider, возможностями reasoning и поддержкой инструментов. У недоступного назначения появляется индикатор ошибки, и до исправления профиль не попадает в доступный каталог каждого родительского режима.

Если явно назначенная модель исчезла после начала хода, запуск профиля завершается видимой ошибкой в чате и направляет в Настройки → Sub Agents. Kodik не подменяет точное назначение молча. Профиль с политикой Наследовать от родителя намеренно разрешается в текущую пару провайдер/модель родительского чата и недоступен, если эта модель не может запустить профиль. Сам Orchestrator не запускается, если ни у одного включённого профиля нет доступной совместимой модели.

Модель Ollama остаётся локальной и не расходует кредиты Kodik. Стоимость и конфиденциальность Custom Provider зависят от его настройки.

JSON-конфигурация

Редактор Settings записывает версионированный JSON. Пользовательские изменения находятся в ~/.kodik/sub-agents.json; необязательный .kodik/sub-agents.json в рабочей области полностью заменяет этот пользовательский слой.

{
  "version": 1,
  "maxConcurrentWorkers": 4,
  "overrides": {
    "researcher": {
      "model": "inherit"
    },
    "implementer": {
      "description": "Использовать для небольших, полностью определённых изменений продукта.",
      "model": {
        "provider": "ollama",
        "modelId": "qwen3-coder:30b"
      },
      "reasoningEffort": "high",
      "tools": ["read_file", "rg", "edit_file", "shell", "browser"]
    }
  },
  "profiles": [
    {
      "id": "custom:release-auditor",
      "name": "Release Auditor",
      "description": "Проверяет сборку и миграцию перед релизом.",
      "instructions": "Проверьте назначенную область релиза и верните воспроизводимые доказательства.",
      "model": {
        "provider": "kodik",
        "modelId": "openrouter-openai-gpt-5.6-luna"
      },
      "tools": ["read_file", "rg", "shell"],
      "enabled": true
    }
  ]
}

maxConcurrentWorkers — необязательное целое число от 1 до 16; значение по умолчанию — 4. overrides — точечные переопределения: пропущенные поля продолжают поступать из текущего исходного или плагинного профиля. Элементы profiles — полные пользовательские профили с id в пространстве имён custom:<slug>. Settings проверяет неизвестные поля, повторяющиеся id, недоступные модели, неподдерживаемый reasoning effort, родительские инструменты и ограничения размера файла и полей.

Редактор Settings использует атомарную запись и обнаруживает внешние изменения, чтобы один редактор не перезаписал другой незаметно. Секреты и ключи провайдеров в этом файле не хранятся.

Жизненный цикл делегирования и долговечные отчёты описаны в разделе Субагенты.