Как собрать первого боевого агента: роли, инструменты и память

Запрос «создание ии агентов для бизнеса» в Wordstat даёт объём 120. Под ним часто ждут готовый бот «из коробки» или слайд с тремя стрелками. Я разбираю другой продукт: как с нуля собрать узкий рабочий контур — одна роль, 3–5 инструментов, память на сессию и базу фактов, политика на одну страницу — и за 7–14 дней довести его до первой версии, которую стыдно не показать в журнале. Не «что такое агент», не чеклист выката по всей компании и не программа обучения: именно инженерия сборки.

Словарь уже лежит отдельно: чем ИИ-агент отличается от чат-бота в демо. Выкат и приёмка — в чеклисте внедрения. Навык и ритм — в материале про обучение работе с агентами. Здесь — чертёж: роли, стек, инструменты, память, промпты, тесты, права, версионирование и план первых двух недель. Вход в конце — клуб Solar Inside, где лежат живые AGENTS.md из Solar OS.

Кому нужна своя сборка, а не готовый виджет

Своя сборка имеет смысл, когда процесс уже повторяется, а готовый конструктор ломается о ваши поля, права и исключения. Типичные сигналы:

• входящие с сайта или мессенджера требуют нормализации и следующего шага в CRM, а не «ответить вежливо»;
• один и тот же бриф собирают руками по десять раз в день;
• обещания цены и сроков нельзя отдавать модели без источника в базе;
• нужен журнал: почему агент остановился, а не спор «мне показалось, что он грубый».

Не нужна кастомная сборка, если вы ещё не назвали один канал и один сегмент. Тогда сначала карта процесса на страницу — иначе получите «универсального ассистента», который красиво болтает и ничего не меняет в системе. Не нужна и тогда, когда боль только в исходящих Telegram-чатах и у вас уже есть узкий продукт вроде Телепилота: там сборка другая, про парк аккаунтов и антибан, а не про «агента вообще».

Критерий простой. Если через две недели вы не можете открыть журнал и сказать «вот 40 кейсов, вот 7 стопов по коду „нет цены“» — вы собирали демо, а не агента. Демо полезно для продажи идеи. Для операционки — нет.

Выбор стека: API, конструктор или гибрид

До написания «умного промпта» выберите, где живёт контур. Три рабочих варианта.

Прямой API к модели + ваш код. Плюс: полный контроль над памятью, инструментами, журналом и правами. Минус: нужна разработка или сильный технический владелец. Подходит, когда поля CRM жёсткие, стопы критичны и вы не хотите зависеть от чужого конструктора.

Конструктор без кода. Плюс: быстрее увидеть диалог. Минус: часто нет нормального журнала стопов, слабый контроль записи в CRM, «магия» вместо версии политики. Подходит для прототипа на 3–5 дней, если сразу договорились: прототип не едет в бой без политики и прав.

Гибрид. Модель и оркестрация — в вашем коде или в зрелой среде исполнения; диалоговый слой и шаблоны — в удобном редакторе. На практике это самый частый взрослый путь: красивый чат не равен продакшену, а продакшен без удобного редактирования политики тоже ломается.

Правило выбора на старте. Если у команды нет разработчика и нет доступа к клубу с готовыми каркасами — не обещайте себе «полный кастом за выходные». Возьмите узкий прототип в конструкторе только на чтение, параллельно опишите политику и список инструментов. Если разработчик есть или вы входите в Solar Inside с AGENTS.md — начинайте с каркаса под вашу CRM, а не с бесконечного тюнинга тона.

Минимальный стек первой версии обычно такой: модель для разбора свободного текста; хранилище фактов (прайс, FAQ, политика); слой инструментов (чтение CRM, создание задачи, черновик ответа); журнал решений; секреты с наименьшими правами. Всё остальное — после v0.1.

Роли агента: одна зона ответственности, не «сделай всё»

Агент без роли — это модель с доступом. Роль задаёт, что считается успехом и где граница.

Рабочие роли для первой сборки (берите одну):

1. Квалификатор входящих. Читает заявку, проверяет поля, тегирует, создаёт задачу человеку или черновик следующего шага. Не обещает цену.
2. Нормализатор карточек. Дедуп, источник, обязательные поля, пометка «неполно». Не двигает этап сделки при пустых критичных полях.
3. Черновик ответов по шаблону. Пишет ответ только из разрешённых фактов. Внешняя отправка — человеку, пока шаблон не железный.
4. Эскалатор и журналист стопов. Не «решает» спорное: пишет код стопа и передаёт человеку.
5. Исходящий исследователь чатов (отдельный контур). Ищет и прогревает касания в мессенджере — это уже зона продуктов вроде Телепилота, не смешивайте с квалификатором входящих в одном промпте.

Плохая роль: «универсальный сотрудник отдела продаж, маркетинга и поддержки». Хорошая: «квалификатор заявок с сайта в сегменте X, канал Y, следующий шаг Z». Чем уже роль, тем проще память, тесты и версия.

Назначьте рядом человеческие роли на две недели сборки: владелец процесса (смотрит журнал), владелец данных (обновляет прайс и FAQ), приёмщик спорных обещаний. Без имён агент станет сиротой на третий день после «вау-демо».

Инструменты и MCP: что агент умеет делать руками

Модель думает текстом. Бизнес меняется действиями. Поэтому сборка агента — это в первую очередь список инструментов с контрактом.

Минимальный набор для входящего контура:

• read_lead / чтение карточки и истории касаний;
• check_fields / проверка обязательных полей брифа;
• tag_or_dedupe / тег и дедуп;
• draft_reply / черновик ответа по шаблону;
• create_task / задача человеку с контекстом;
• write_journal / запись решения и кода стопа;
• escalate / передача живому инбоксу.

Чего не давать в v0.1: смену цены, доступов, ролей сотрудников, внешнюю рассылку без подтверждения, «додумать факт о продукте из головы модели».

Про MCP и подобные слои инструментов. Имеет смысл думать об инструментах как о явном протоколе: имя, вход, выход, ошибки, права. Неважно, называете вы это MCP, функциями модели или вебхуками в CRM — контракт должен быть читаемым человеком. Если инструмент «иногда пишет в CRM как получится» — у вас нет инструмента, у вас есть надежда.

Практика на полдня: для каждого инструмента напишите одну строку «можно / нельзя / при ошибке». Пример: draft_reply можно только из блока фактов версии 1.2; нельзя цитировать устаревший прайс; при пустом факте — стоп no_fact и эскалация. Это уже половина политики.

Не подключайте десять интеграций в первую неделю. Три рабочих инструмента с журналом сильнее десяти «подключено в слайде».

Память и контекст: что помнить, что забывать, что хранить снаружи

Путаница памяти ломает сборку чаще, чем «плохая модель». Разделите три слоя.

Контекст сессии. Текущий диалог, последние сообщения, ID карточки. Живёт коротко. Не кладите сюда весь прайс компании.

Рабочая память задачи. Что уже проверили, какой стоп сработал, какой следующий шаг согласован. Должна переживать один кейс целиком и попадать в журнал.

Внешняя база фактов. Прайс, FAQ, политика, шаблоны — с версией и датой. Модель читает кусок по запросу, а не «всё сразу в системный промпт на три экрана».

Антипаттерны:

• скормить модели всю переписку с реквизитами «как есть»;
• держать политику только внутри длинного системного промпта без файла версии;
• смешивать память клиента А и клиента Б в одном потоке;
• считать, что «модель сама запомнит» запрет на скидку.

Правило для первой версии. Сессия — короткая. Факты — снаружи с версией. Журнал — обязателен. Если факта нет в базе версии N — агент не додумывает, а стопится. Так вы защищаете и клиента, и себя от красивой лжи.

Для операционки полезны конкретные лимиты: например, в контекст сессии — не больше последних 20 сообщений канала; в блок фактов на один вызов — один прайс-лист и один FAQ-раздел, релевантный сегменту. Числа подстройте под себя, но зафиксируйте их письменно: иначе через месяц «чуть расширили» и сломали качество.

Промпты и политики: текст роли, а не роман

Промпт без политики — театр. Политика без версии — хаос. Собирайте так.

Системный каркас (коротко): кто ты по роли; что читаешь; какие инструменты есть; что писать в журнал; когда молчать.

Политика на одну страницу (отдельный файл): цель узла; разрешённые факты; запреты; эскалация; формат стопа. Нумерация v1.0, v1.1…

Шаблоны ответов: отдельные, с пометкой «черновик» / «можно во внешний канал».

Не пихайте в один системный промпт прайс, тон бренда, юридические оговорки и инструкцию по CRM. Это невозможно сопровождать. Вынесите факты. В промпте оставьте поведение.

Формулировки запретов пишите глаголами действия: «не обещать срок поставки без поля в карточке», а не «будь осторожен с обещаниями». Модель лучше слушается конкретных стопов.

Тон и голос бренда — отдельный короткий блок. Не смешивайте голос клуба, голос услуги и голос чужого коммерческого предложения в одном агенте. Если агент отвечает клиентам — у него один голос, утверждённый владельцем процесса.

Тесты и оценка: до боя и после каждого изменения

Без тестов вы крутите температуру модели и спорите о вкусе. Со сборкой нужны два контура проверки.

Набор кейсов до записи во внешний канал. 20–40 реальных или анонимизированных входящих. Для каждого заранее: ожидаемый тег / стоп / следующий шаг. Прогон после каждой правки политики.

Отказные кейсы. Пустой бриф, нет цены, повтор, жалоба, запрос вне зоны, протухший доступ. Если агент «креативно» отвечает — тест красный, даже если тон милый.

Метрики без чужих процентов. Смотрите свои числа: доля корректных следующих шагов; доля стопов с понятным кодом; доля черновиков, которые человек переписывал больше чем на треть; были ли обещания вне базы фактов. Чужой кейс «+37% конверсии» в зачёт вашей сборки не идёт.

Практика: заведите таблицу проверок с колонками «вход», «ожидание», «факт агента», «пасс/правка». После смены промпта или инструмента прогоняйте весь набор, не «два любимых диалога». Иначе вы оптимизируете под демо.

На второй неделе добавьте разбор живого журнала 20 минут в день: топ кодов стопа, сюрпризы, правки политики. Это и есть оценка в бою — дешевле, чем «большая аналитика» без владельца.

Права и ограждения: можно, нельзя, эскалация

Права важнее красивой формулировки. Матрица на старте сборки:

Можно самому: читать входящее и историю; проверять поля; тегировать; создавать черновик; ставить задачу человеку; писать журнал; эскалировать.

Нельзя вслепую: цена, срок, скидка без источника; деньги и доступы; внешняя отправка до железного шаблона; движение сделки при пустых критичных полях; выдумывание фактов.

Эскалация обязательна: жалоба; юридический спор; пустое критичное поле; протухший токен; запрос вне роли.

Технические ограждения рядом с текстом политики: отдельные секреты, наименьшие права токена, маскирование платежных данных, откат последней записи за минуты, запрет копировать реквизиты в ответ без человека. Формула «так удобнее модели» безопасность не отменяет.

Если подрядчик просит админский доступ «на всякий случай» — это красный флаг сборки, не ускорение. Дайте чтение и одну обратимую запись. Расширение прав — отдельное событие после чистого журнала.

Версионирование: политика, инструменты, промпт, база фактов

Без версий нельзя откатить плохой день. Минимальная схема:

• policy v1.0 — файл политики с датой;
• facts v1.0 — прайс и FAQ;
• prompt v1.0 — системный каркас роли;
• tools v1.0 — список инструментов и контракты;
• сборка v0.1 — связка всего выше + примечание «только чтение» или «чтение + одна запись».

Правило релиза. Любое изменение, которое влияет на внешний ответ или запись в CRM, поднимает минорную версию и сопровождается прогоном набора кейсов. Косметика тона без смены фактов — тоже фиксируйте, иначе через месяц не вспомните, что сломало стопы.

Храните журнал изменений на полстраницы: что изменили, зачем, какой тест подтвердил. Не в переписке «как получится». В клубе Solar Inside как раз удобно смотреть, как живые AGENTS.md меняются во времени — это хороший образец дисциплины версий, а не разовый снимок слайда.

Откат: уметь вернуть предыдущую связку prompt+policy+facts за минуты. Если откат = «переписать всё руками из головы» — версионирования у вас нет.

План сборки на 7–14 дней: от пустого файла к v0.1

Ниже — рабочий календарь. Цифры реалистичны для одной роли и одного канала, если есть владелец процесса хотя бы на час в день.

Дни 1–2. Роль и карта

Выбрать одну роль и один канал. Описать вход, поля брифа, следующий шаг, исключения. Набросать матрицу прав. Список из 3–5 инструментов. Критерий готовности: одностраничный бриф без «цифровой трансформации».

Дни 3–4. Факты, политика, каркас промпта

Собрать facts v1.0 и policy v1.0. Написать короткий системный каркас. Поднять журнал стопов (хотя бы таблица). Пока никакой внешней записи.

Дни 5–7. Инструменты и теневой режим

Подключить чтение CRM/заявок и запись журнала. Прогнать 20+ кейсов. Смотреть стопы. Чинить политику, не «температуру модели». К концу дня 7 — теневой режим на реальном потоке без внешней отправки.

Дни 8–10. Одна обратимая запись

Разрешить одно действие: задача человеку или черновик во внутренний инбокс. Не клиентский канал. Прогон кейсов после каждого изменения. Разбор журнала 20 минут ежедневно.

Дни 11–14. Узкий внешний шаг или честная пауза

Если стопы понятны и человек не переписывает черновики целиком — аккуратный внешний шаблон на узком сегменте или решение остаться на внутренних задачах ещё неделю. Зафиксировать сборку v0.1, журнал изменений и дату следующего разбора.

Что не делать в эти две недели: второй канал, «универсальность», отключение журнала «чтобы быстрее», админский токен, обещание клиентам уровня сервиса выше, чем у команды.

Если к дню 14 нет журнала и версии политики — у вас был спринт энтузиазма, не сборка. Вернитесь к дням 1–4 без стыда: дешевле, чем чинить публичные обещания.

Типичные ошибки при создании контура с нуля

Начать с выбора «самой умной» модели. Модель нужна там, где свободный текст. Дедуп и таймеры часто закрываются правилами. Сначала роль и инструменты.

Смешать пять ролей в одном агенте. Получите шум и невозможность теста. Одна роль — одна сборка.

Политика только в голове основателя. Уволился или уехал — агент орфан. Файл с версией обязателен.

Инструменты без контракта ошибок. «Иногда не создалась задача» без кода в журнале = слепой полёт.

Оценка по вау на созвоне. Смотрите кейсы и стопы. Демо-диалог продаёт идею, не качество сборки.

Сразу Телепилот + входящий квалификатор + голос. Три разных контура. Соберите один.

Клон чужого промпта без ваших полей. Чужой AGENTS.md — образец дисциплины, не копипаст в прод. Адаптируйте под свою CRM и запреты.

Игнорировать обучение команды. Даже идеальная сборка умрёт, если никто не смотрит журнал. Ритм — часть продукта; подробнее про навык — в материале про обучение, здесь достаточно правила: 20 минут в день на стопы.

Когда брать Телепилот, а когда собирать кастом

Кастомная сборка — когда боль во входящих, квалификации, CRM-следе, черновиках и стопах на вашем основном канале. Вы проектируете роль, память и права под свой процесс.

Телепилот — когда Telegram реально канал клиентов, руками уже упёрлись в пачку чатов, нужен парк, поиск чатов и исходящие касания с антибаном. Это готовый узкий контур, а не «ещё одна галочка в универсальном агенте». Кейс: https://4bos.ru/cases/telepilot/

Не вшивайте Телепилот в первую сборку квалификатора «на всякий случай». Сначала входящий контур и журнал. Исходящий парк — расширение, когда входящие уже не стыдно показать. Если боль только в чатах — смотрите Телепилот отдельно, без ожидания, что кастомный «агент всего» закроет антибан и разогрев.

Гибрид возможен позже: кастомный квалификатор входящих + Телепилот на исходящих, с разными политиками и журналами. В одном промпте их смешивать нельзя.

Solar Inside: артефакты для тех, кто собирает сам

На 4bos.ru два разных входа.

Solar Inside — клуб с рабочими AGENTS.md, скриптами и ритмом апдейтов Solar OS. Вы адаптируете под себя. Это ускоритель сборки, не обещание «сдадим без вашего участия». Вход: https://4bos.ru/inside/

Совместная поставка / пилот со студией — когда нет времени собирать самим: бриф, права, журнал, приёмка. Нужны роли на стороне клиента.

Если цель именно создание контура руками команды — клуб даёт образцы структуры: как оформлены роли, стопы, факты, версии. Если цель — чтобы кто-то приехал и собрал за вас — это поставка, и клуб её не заменяет. Покупать «доступ вместо владельца процесса» бессмысленно: файлы сами политику не утвердят.

В блоге 4bos я разбираю инженерию сборки. Витрина кейсов показывает, что уже крутится. Клуб — место, где видно внутренности. Не подменяйте одно другим в брифе на первую неделю.

Что забрать с этой страницы

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

План 7–14 дней достаточен для v0.1 на одном канале: сначала чтение и журнал, потом одна обратимая запись, потом узкий внешний шаг или честная пауза. Телепилот подключайте только если боль в исходящих чатах. Артефакты и живые примеры каркасов — в Solar Inside.

Словарь: https://4bos.ru/blog/ii-agent-dlya-biznesa/ Выкат: https://4bos.ru/blog/vnedrenie-ii-agentov-dlya-biznesa/ Обучение навыку: https://4bos.ru/blog/ii-agenty-dlya-biznesa-obuchenie/ Клуб: https://4bos.ru/inside/

Красивое универсальное демо продаёт идею. Узкая сборка с журналом продаёт операционку. Сначала чтение и стопы, потом одна обратимая запись, потом внешний шаг — или честная пауза. Так выглядит взрослое создание ии агентов для бизнеса: от пустого файла до v0.1 без театра.