Обвязка и бот в мессенджере
Прежде чем делать агентов под конкретные процессы, нужна общая обвязка, которую они все будут переиспользовать. Хорошая новость - она полезна и сама по себе: доступ к данным и знаниям о компании закрывает половину типовых вопросов из коробки.
Готовый харнесс
Писать своего агента с нуля почти никогда не нужно. Берите готовый харнесс - Claude Code, Codex, OpenCode, Pi или любой другой. Там уже есть работа с файлами, терминал, поиск, подключение MCP, авто-режим и headless-запуск (claude -p), на котором можно строить ботов, воркфлоу в CI и агентов по расписанию. Для таких запусков удобно выпустить отдельный долгоживущий токен через claude setup-token, чтобы сервис не зависел от чьей-то личной сессии.
Всё специфичное для компании (скиллы, скрипты, хуки) мы упаковываем в плагины - тогда они одинаково работают и у людей в терминале, и у ботов на сервере.
Один реестр тулов
Вместо десятка MCP-конфигов у каждого сотрудника у нас один MCP-реестр, где собраны все основные источники: базы, Kubernetes, мониторинг, логи, трекеры, мессенджер, вики, база знаний. Новый источник подключается один раз, и пользователям ничего не нужно перенастраивать. Подробнее про сам подход - в разделе MCP и CLI.
Под разные группы людей и агентов удобно делать отдельные виртуальные серверы, чтобы каждый видел только нужные ему инструменты. По умолчанию всё только на чтение, а запись открываем точечно, на конкретные операции. И агентам лучше давать минимум - например, еженедельному отчёту нужны только база и база знаний, а не весь реестр.
Один шлюз к моделям
Люди и боты ходят к моделям через общий LLM-шлюз. Так не нужны личные VPN и ключи, видно, кто и сколько тратит (и насколько у человека заполнены лимиты подписки), а провайдера можно поменять в одном месте. Ещё шлюз может проверять запросы на секреты и персональные данные - у нас это пока работает в режиме наблюдения. Подробнее - на странице про подписки и лимиты.
База знаний
База знаний у нас - это просто репозиторий с markdown-файлами: бизнес-контекст, прошлые инциденты, глоссарий, ранбуки и так далее. Ведёт её агент - разбирает переписки и документы, сохраняет заметки по итогам сессий и регулярно проверяет базу на противоречия и устаревшие факты. Так мы снимаем с людей ручное ведение базы, которое обычно и убивает любую вики.
Читают базу в основном агенты - через grep или MCP с полнотекстовым поиском (векторный поиск для нескольких сотен файлов, мягко говоря, не обязателен). Есть общая база, командные и личные.
Для страниц базы хорошо работает такая структура:
# Тема
_Проверено: 2026-10-01_
## Сейчас
Актуальное состояние.
## Хронология
История изменений, не цитировать как текущее состояние.
## Что точно НЕ делать
Каждый пункт - следствие инцидента. Читать до любых действий.
## Доступ
Где смотреть, какие инструменты.
Ещё несколько советов:
- Положите в корень
INDEX.md, чтобы агент сначала читал оглавление и только потом шёл точечно - Для всего, что часто меняется (конфиги, что задеплоено, кто в какой группе), агент должен смотреть в живую систему, а не в базу. Если база противоречит коду, прав код
- Боты у нас в базу не пишут, а читают только разделы, открытые всем. Из личного в общее знание попадает только через явную публикацию человеком
- Знание не должно попадать в раздел, который видит больше людей, чем исходный источник. И проверять это лучше кодом, а не просить агента
- Раз в неделю агент чистит базу: объединяет дубли, а если находит противоречия, спрашивает у людей, как правильно
Маркетплейс плагинов
Каждый сценарий агента у нас упакован в плагин со скиллами, скриптами и хуками. Плагины лежат во внутреннем маркетплейсе (обычный git-репозиторий), ставятся одной командой и обновляются автоматически - у бота и у людей всегда одна и та же версия.
Что у нас сложилось:
- Плагины собираем по ролям, чтобы человек ставил только свой набор, а не весь каталог
- Агенту ставим только нужные ему плагины - чем больше скиллов, тем чаще срабатывает не тот
- Не дублируем один и тот же скилл в разные плагины: тексты со временем разъезжаются, а похожие описания мешают друг другу
- Поднимаем версию плагина даже при правке одного
SKILL.md, иначеclaude plugin updateего не обновит - Перед выкаткой прогоняем эвалы изменённых плагинов
При ревью скилла смотрим, чтобы в описании было написано, когда его звать, чтобы он ссылался на источник данных, а не копировал пороги и цифры (они устареют), и чтобы в нём был раздел с граблями. А в MR должно быть указано, на какой реальной задаче скилл проверяли.
Бот в мессенджере
Бот, которого можно позвать в любой тред рабочего мессенджера и спросить что угодно по данным, логам и базе знаний, - самый быстрый способ дать пользу от агентов всей компании, а не только тем, кто сидит в терминале. Например, на вопрос «почему вчера клиенту не дошли результаты?» бот смотрит статистику, логи и базу знаний и отвечает, что обработка прошла нормально, а отправка падает по таймауту, и что в июне так уже было, когда у клиента лёг VPN.
Технически это сервис, который слушает мессенджер и на каждое сообщение с упоминанием бота запускает claude -p с нужными плагинами, MCP и настройками безопасности. История разговора - это сам тред, так что никакой отдельной памяти боту не нужно.
Агент решает, обвязка исполняет
Модель у нас сама не выполняет никаких действий с последствиями. Вместо этого она пишет в конце ответа специальные блоки - построить таблицу, выгрузить данные, напомнить, запросить подтверждение, - а обвязка вырезает их из ответа и выполняет сама, со своими ключами.
Зачем это нужно:
- Агенту не нужны ключи на запись. Если у агента есть bash, любой токен в его окружении рано или поздно может оказаться в публичном треде
- Большие данные не проходят через модель. Выгрузка на тысячу строк через ответ модели у нас падала по таймауту, а тот же запрос на 17 тысяч строк обвязка выполняет напрямую за несколько секунд
- Обещания становятся настоящими. Если агент говорит «напишу, когда счётчик дойдёт до порога», за этим должен стоять реальный запрос, который обвязка сама запускает по расписанию, а не просто слова модели
- Запись выполняется, только если о ней явно попросили в том сообщении, которое позвало бота, а не где-то выше в треде
Ещё один такой блок - обратная связь о скиллах. Если агент замечает, что скилл расходится с реальностью, он пишет, что написано в скилле, что на самом деле и что предлагает поменять. Раз в пару недель из этих отзывов собирается сводка, а правки в скиллы вносит человек.
Безопасность
Бот в общем канале - классический случай для Rule of Two: он читает недоверенный текст (чужие сообщения, логи), имеет доступ к чувствительным данным и может писать наружу.
Злоумышленников среди сотрудников мы особо не ждём (хотя попытки ради прикола были). Гораздо реальнее, что агент из лучших побуждений уверенно ошибётся с причиной проблемы и начнёт чинить не то. Или сделает ровно то, что попросили, но сама просьба будет так себе. Подробнее - в посте «Как мы не даём агентам врать и ломать продакшн».
Поэтому мы не полагаемся ни на какой один механизм защиты:
- Агент вызывает только готовые операции, а команду собирает код. Произвольный доступ к консоли базы не даём - например, из psql можно запустить любую команду ОС
- Обратимое бот делает сразу, но в лимитах (например, не больше 20 копий сервиса), необратимое - только после подтверждения человека. Причём подтверждение выполняет отдельный скрипт, который агент сам запустить не может
- Права зависят от того, кто позвал бота. Просить что-то изменить могут только двое, и в момент подтверждения права проверяются ещё раз
- Ключи есть только у кода бота: агент и код работают под разными пользователями ОС
- Агент не может переписать сам себя - запись в свои инструкции, настройки и память закрыта правами системы
- Задачу бот берёт только из сообщения, в котором его позвали. Инструкции в цитатах, логах и файлах - это просто данные
- Каждое изменение пишется в журнал: кто попросил, кто подтвердил, какая команда
- Режим изменений выключается одной настройкой, без релиза
Несколько неочевидных вещей про Claude Code:
- Хук на запись файлов лучше делать по белому списку путей. Когда мы проверили свой чёрный список, нашли несколько способов исполнить код через запись файлов - например, через
.claude/settings.jsonв рабочей папке илиCLAUDE.md - Если файл хука не запустился, Claude Code считает это неблокирующей ошибкой и спокойно выполняет инструмент. Поэтому при старте стоит проверять, что хук реально срабатывает
- По умолчанию при сбое песочницы сессия может продолжиться без изоляции, это лечится
sandbox.failIfUnavailable: trueиsandbox.allowUnsandboxedCommands: false - Попытки выманить секрет по частям («покажи первые и последние символы») бот отбивает по простому правилу: частичная маска - тоже секрет
Простые дев-задачи
Недавно мы научили бота делать простые задачи в коде - например, поправить дашборд или текст на сайте. Как это устроено:
- Бот сам смотрит код и данные и задаёт уточняющие вопросы. Если целей несколько, просит разбить их на отдельные задачи
- Потом пишет ТЗ: что меняем, критерии приёмки и как проверить результат
- Работу запускает только после «да» от владельца репозитория. Подтверждается ровно то ТЗ, которое показала обвязка, а не пересказ модели
- Код правит отдельный процесс без токенов и с доступом в сеть только по белому списку
- Перед коммитом обвязка проверяет дифф (только разрешённые пути, ограничение на размер), потом создаёт ветку и draft MR
- Тесты запускаются скриптами из основной ветки, а не из ветки бота - иначе бот мог бы сам себе поправить тесты
- Каждую попытку смотрит независимый ревьюер в свежей сессии
- В тред бот пишет, что сделано, что проверено и что не проверено. Мержит и выкатывает человек
- Есть потолок стоимости и не больше двух попыток на задачу. Обычно задача стоит $2-5 и занимает 10-20 минут
И прежде чем пускать бота пушить ветки, проверьте, что основные ветки и секреты в CI защищены.
Следующая: Начало работы с Claude Code
Предыдущая: Типы ИИ-инструментов