Документация/Настройка
Модули агента
Модуль даёт агенту инструменты и инструкции для одной области, например для баз данных, кластеров или продакшена. Какие модули есть, что включено по умолчанию, сколько стоит каждый и как его включить.
Модуль — набор инструментов, инструкций и навыков агента для одной области, например для баз данных, Kubernetes или продакшена. Описания инструментов уходят модели в каждом запросе, поэтому любой включённый модуль немного поднимает цену запроса. Модуль, которого у агента нет, ничего не стоит: агент знает только название модуля и подскажет, где его включить.
Как открыть
Откройте «Настройки → Модули» (группа «Что умеет агент»). Вверху — сводка: сколько модулей у агента, сколько токенов они добавляют к каждому запросу и какую долю лимита тарифа эти токены займут за 1000 запросов. Там же написано, по ценам какой модели всё посчитано.
Токены — единицы, в которых модель считает текст; в них считают и размер контекста, и расход. Лимит тарифа — сколько работы агента входит в подписку за период; сколько его потрачено, видно в «Настройки → Аккаунт и тариф». Подробнее — на страницах Контекст и расход и Тарифы и лимиты.
Под сводкой — две группы: «У агента» (модули, включённые для этого проекта) и «Можно включить».
Как включить модуль
- Нажмите переключатель в строке модуля.
- Под строкой появится подтверждение с ценой, например: «Модуль Observe добавит агенту инструментов: …». Если модулю нужен другой модуль, DevMachine скажет об этом и предложит «Включить оба».
- Подтвердите. Модуль включится для этого проекта и появится у агента в новых чатах. В уже открытый чат его можно добавить кнопкой «Применить к открытой сессии», о ней — в разделе Набор модулей закрепляется за чатом.
Чтобы включить модуль сразу во всех проектах, нажмите внизу экрана «Подробно: токены и расход за 7 дней» и под нужным модулем выберите «Включить для всех моих проектов».
Выключить модуль можно тем же переключателем. Если от него зависят другие модули, DevMachine предупредит: «Без него перестанут работать: …».
Совет
DevMachine сам подсказывает, когда модуль пригодится. Если вставите в чат ссылку на Grafana, алерт или под, откроете проект 1С или упомянете инструмент выключенного модуля, появится уведомление «Включить … для этого проекта?» с кнопками «Включить…» и «Не предлагать».
Какие есть модули
| Модуль | Что даёт агенту | По умолчанию | Подробно |
|---|---|---|---|
| Flow | Способ работы: уточнить задачу, спроектировать, спланировать, написать тест раньше кода, проверить результат | Включён в папке с кодом | Flow |
| 1С | Навыки 1С:Предприятия: модули BSL, проекты EDT, выгрузки конфигуратора | Выключен. В проекте 1С DevMachine предложит включить | Разработка на 1С |
| Databases | Доступ к подключениям баз данных проекта | Выключен | Базы данных |
| Kubernetes | Доступ к кластерам из вашего kubeconfig | Выключен | Кластеры Kubernetes |
| Queues | Доступ к брокерам Kafka и RabbitMQ | Выключен | Очереди |
| Ignition | API-клиент: запросы, окружения и прогоны коллекций .ignition/ проекта | Включён | Ignition |
| Браузер | Свой браузер агента: открывает страницы, нажимает кнопки, читает ошибки консоли | Включён | Браузер агента |
| Observe | Логи, трейсы, метрики и ошибки продакшена | Выключен | Продакшен |
| Incidents | Инциденты продакшена как задачи: прочитать, привязать исправление, проверить восстановление. Нужен Observe | Выключен | Инциденты |
| Rollout | Выкатка своего изменения через Canary, откат своей выкатки, feature flags. Нужен Observe | Выключен | Выкатка |
| Profiler | Снять профиль, найти горячие места, сравнить два профиля | Выключен | Профилирование |
| Macros | Одобренные команды проекта: посмотреть список, запустить, предложить новый макрос | Выключен | Макросы |
| Zephyr Copilot | Тест-кейсы в Zephyr Scale вашей Jira. Каждый пакет создаётся только после вашего нажатия на карточке | Выключен | — |
| Plugins | Помогает агенту писать плагины DevMachine. Включить плагин можете только вы | Включён | Плагины |
| Плагины с инструментами | Инструменты установленного плагина — отдельный модуль на каждый плагин | Как вы выбрали при установке | Плагины |
Flow включён по умолчанию только в папке с кодом: в git-репозитории, в конфигурации 1С или там, где в корне или на уровень ниже есть файл сборки или исходники. В пустой папке и в папке с документами Flow выключен, и на экране модулей так и написано: «В этой папке нет кода, поэтому Flow по умолчанию выключен. Включите, если пишете здесь код.»
Агент помнит проект между чатами: сам записывает заметки и вспоминает их в новых чатах. Эта память работает всегда, в списке модулей её нет. Как она устроена — в разделе Память между чатами.
Модуль и панель — не одно и то же
У многих модулей есть панель для вас: вид Kubernetes, Observe, базы данных и другие. Панель работает и без модуля и токенов не тратит. Модуль нужен, только если с этим должен работать и агент.
Сколько стоит модуль
- В строке модуля — примерная доля лимита тарифа на 1000 запросов. Пока тариф неизвестен, вместо доли стоит число токенов. Если модуль ещё не измерен, написано «оценка появится скоро».
- «Подробно: токены и расход за 7 дней» внизу экрана — под каждым модулем число инструментов, токены и доля лимита без кеша. У включённых модулей ещё видно, сколько за неделю было запросов с модулем и сколько раз агент вызывал его инструменты. Если агент модулем не пользуется, DevMachine подскажет: «Модуль не используется, можно отключить.»
Стоимость модулей измеряет сервер DevMachine, а расход за 7 дней считает приложение у вас на компьютере. Цены тарифов — на странице Тарифы.
Набор модулей закрепляется за чатом
Набор модулей запоминается при первом запросе чата и дальше не меняется: пока набор тот же, работает кеш и запросы стоят дешевле. Поэтому включённый модуль появляется у агента в новых чатах. Субагенты получают тот же набор, что и их чат.
Если модуль нужен прямо в открытом чате, нажмите «Применить к открытой сессии» в сводке вверху. DevMachine покажет цену: «Её следующий запрос перечитает всю историю без кеша: ≈ … токенов, в ×… дороже обычного запроса.» Чтобы продолжить, нажмите «Применить». В длинном чате дешевле начать новый.
Состояния модуля
| Состояние | Что значит |
|---|---|
| «У агента» | Модуль включён для этого проекта |
| «Выключен» | Модуль можно включить |
| «Требует настройки» | Модуль включён, но ему не хватает настроек — например, источников Observe. Инструменты появятся у агента, когда вы настроите модуль |
| «Нужен …» | Модулю нужен другой модуль, а тот выключен |
| «Запрещён организацией» | Модуль запретила ваша организация. Включить его нельзя ни в настройках, ни правкой файлов |
Как организация управляет модулями — на странице Организации и политика агента.
Ограничения
- Агент может только предложить включить модуль.
- Выбор модулей хранится на этом компьютере, вне папки проекта. У всех копий одного репозитория — основной папки и её worktree — выбор общий. Подробнее — на странице Окружения.
- Проект на сервере (SSH). Выбор модулей хранится на сервере проекта.
Что дальше
- Плагины — свои инструменты для агента.
- MCP-серверы — внешние инструменты.
- Контекст и расход — из чего складывается цена запроса.
- Доступ агента к базам, кластерам и очередям — что агенту можно делать с подключениями.
Обновлено · Нашли неточность? Напишите на support@devmachine.ai или в Telegram.