Рой агентовВыпуск 4· 58:61· 24.06.2026

Архитектор роя: что происходит между паспортом и готовой воронкой

Превращаем паспорт роя в архитектуру: какие события заводить для аналитики и автоматизаций, какие нужны таблицы и как собрать детальное ТЗ для нейросетей.

Вадим Щербанев
Ключевые моментыНажмите на время — плеер перемотает к фрагменту24 таймингов

Конспект

Конспект выпуска №4: Архитектор — из паспорта в детальное ТЗ для нейросетей

База данных, переменные, транспорты, события и 40 пространств со спецификациями — что делает Архитектор за 43 минуты и что остаётся ручными шагами

Четвертый выпуск цикла «Рой агентов». В первых эфирах мы с Методологом собирали паспорт — огромное описание того, что должна делать наша воронка (для проекта это ~200 страниц A4). В этом выпуске запускаем следующего сотрудника команды — Архитектора — и смотрим, как он за ~40 минут превращает это словесное описание в полноценное техническое задание: базу данных, переменные, транспорты, события, пространства, конфигураторы лендов и рассылок. Что вы вынесете: как устроен этап «архитектуры» в Верховном Ботане, что ИИ делает сам, что обязаны сделать руками вы, на что смотреть при проверке и из чего складывается итоговая цена генерации.

1. Что мы строим (контекст проекта)

Проект — «ИИ-подруга Нелли»: агент-персонаж ведёт пользователя из рекламы в мобильное приложение emi (триал → платная подписка emi Pro). Это воронка нового типа: вместо жёстких автовебинарных серий — живые агенты, которые общаются и продают.

К этому моменту паспорт собран и утверждён (этап «описание» — единственное, что человек делает по-настоящему скрупулёзно). После Методолога отработал Квалификатор (отдел контроля качества) — отдельный агент, который вычитал весь документ, задал уточняющие вопросы, что-то переписал и вынес вердикт: документ в порядке и готов к архитектуре. Важно: готов именно к проектированию архитектуры, ещё не к генерации.

Паспорт — это набор разделов в интерфейсе Верховного Ботана (меню-«бутерброд»): описание, база данных, конфигураторы, переменные, транспорты, события, пространство, отдел агентов. До этого выпуска мы заполняли только описание. Всё остальное — и есть «архитектура».

💡 Урок для вашего проектаКачество всего, что будет ниже, определяется качеством паспорта. Архитектор не выдумывает за вас бизнес — он переводит ваше описание в технические сущности. Плохое описание → плохая архитектура → нерабочая воронка. Время, вложенное в паспорт, не «потеряно» — оно окупается на всех следующих шагах.

2. Кто такой Архитектор и зачем его вынесли отдельно

Архитектор — дополнительный агент внутри команды Верховного Ботана. Его не нужно собирать и обучать: он живёт в платформе Чатиуме и ждёт команды. Раньше эту работу делал сам Верховный Ботан; его разгрузили, чтобы он занимался оркестрацией, а Архитектор — планированием всей организации работ.

Запуск: Ботан сам предлагает кнопку «запустить Архитектора», подставляет в чат готовое сообщение, вы его отправляете. Архитектор подтверждает явное согласие на запуск и уходит работать одним вызовом субагента. Работа долгая — в этом проекте 43 минуты (ориентир: 30–40 минут и больше).

💡 Урок для вашего проектаНе пугайтесь, что «он долго думает» и переходит на английский в логах — читать его рассуждения по ходу бессмысленно. Это нормальный режим: большой объём проектирования идёт фоном.

3. Главная идея: «сделай мне что-нибудь» не работает

Почему обычное общение с нейросетью часто даёт нерабочий результат? Потому что мы говорим ей «сделай нам лендинг» — и она делает «что-нибудь». Архитектор устроен иначе: он не выполняет задачу, он ставит задачу — пишет подробное ТЗ, по которому потом кодирующий агент собирает конкретную страницу/агента/рассылку.

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

📌 Забираем себеЦенность платформы не в том, что «ИИ сам всё сделал по одной фразе», а в том, что между вашим описанием и результатом встроен слой, который превращает расплывчатое пожелание в строгое, машиночитаемое ТЗ. Это и есть разница между «погенерил картинку в чате» и «собрал работающий бизнес-процесс».

4. Что именно проектирует Архитектор

Архитектор заполняет все разделы паспорта, кроме «описания» (которое вы сделали сами): базу данных, переменные, транспорты, события, пространства со спецификациями, ТЗ на инструкции агентов, автоматизации и сервисы. Рассмотрим каждый блок подробно.

4.1 База данных

Архитектор сам определяет, какие таблицы и поля нужны процессу, исходя из паспорта. Представьте Excel-таблицы с проработанными колонками. В готовой соседней воронке (автовебинар) это вышло 9 таблиц, 119 полей: регистрации, авто-вебинары, расписание, сессии участников, события сценария, опросы/игры, личные чаты, попытки оплаты, заказы.

В нашей воронке Нелли на момент съёмки он сделал 5 таблиц, 60 полей (ещё в процессе, мог переписать). Примеры таблиц:

  • Лиды и путь входа Нелли: ID, контакт, имя, e-mail, предпочтительный мессенджер, источник/путь, handoff-токен, UTM-атрибуция, рекламные параметры и вариант креатива, клик по ссылке установки приложения, первое открытие emi, начало триала, оплата подписки, дата последнего апгрейда.
  • Приглашение подруг (реферальная механика): кто пригласил, кого пригласил.
  • Персональные маршруты: цель маршрута, сегмент, статус, шаги — по какому пути агент ведёт человека (пригодится и для аналитики: можно группировать людей по целям).
  • Контекст диалога: сводка мотивации, денежная цель, текущий навык, возражения/барьеры, готовность к следующему шагу, статус emi App / emi Pro, последняя сводка диалога, последнее полезное действие.
💡 Урок для вашего проектаНе-технарям разбираться в полях не нужно — это зона ИИ. Технарю достаточно знать, что такая опция есть и что структуру можно посмотреть и поправить руками. Для масштаба: рабочая CRM на этой же базе накопила порядка 2–2,5 млн строк в одной только таблице звонков.

4.2 Переменные

Переменные — это значения, которые подставляются в сообщения, страницы и агентам, чтобы менять их в одном месте, а не переинструктировать всё заново. Архитектор сам придумывает, формулирует и записывает их, понимая, где они используются. В проекте — 15 переменных, например:

  • ссылка на приложение в App Store и Google Play (поменялась ссылка — правите одну переменную, агентов не трогаете);
  • цена emi Pro (490 ₽/мес — поменять цену = поменять переменную);
  • рекламные «якоря» (например, обещание доступа за 0 ₽ — используется только в рекламном тексте).
📌 Забираем себеВсё, что в будущем может поменяться (цены, ссылки, контакты, оффер), выносите в переменные. Тогда правка занимает секунды и не ломает инструкции агентов. Сюда же позже добавляются коды аналитики — Яндекс.Метрика, пиксели ВКонтакте: их Архитектору не давали, так что это ручная задача. Часть переменных он оставит незаполненными с пометкой «заполнить вам» — следите за такими местами.

4.3 Транспорты

Транспорт — это канал, через который агенты общаются: Telegram (боты, менеджеры, каналы), ВКонтакте, Viber, WhatsApp, e-mail, SMS, MAX, Авито, Telegram Business, внутренний транспорт для виджетов на сайте и т.д. Появилась новая опция «Отдел агентов отвечает на входящие» — агенты могут отвечать человеку, который прислал текст, голосовое или картинку.

Архитектор сам спроектирует, какие каналы нужны воронке. В проекте он попросил подключить, ориентировочно, Telegram-бота и MAX-бота (с включённым «отвечать на входящие»); SMS для входящих ответов отключить. Но подключение и включение тумблеров — ручная работа, которую он за вас не делает: вы сами отмечаете галочками, в каких конкретных ботах/каналах работает процесс.

💡 Урок для вашего проектаЗапомните это как обязательный ручной шаг перед генерацией: «выбрать и включить транспорты». Архитектор только планирует каналы — физически подключаете боты вы.

4.4 События (аналитика и автоматизации)

Событие — это то, что вы хотите измерять и/или то, что запускает автоматизацию. Под капотом Chatium пишет события в ClickHouse — можно фиксировать что угодно, вплоть до скроллинга страницы, и собирать из этого дэшборд (или спрашивать у Верховного Ботана «сколько было оплат / заказов» прямо в чате).

Примеры спроектированных событий: открыл лендинг регистрации, зарегистрировался, выбрал сегмент аудитории, подключил Telegram/MAX-бота, начал/досмотрел вебинар, открыл продающую страницу, начал оформление покупки. Для Нелли: лид зарегистрирован, выбран мессенджер и т.п.

Ключевой принцип: не записал событие — не будет аналитики. Но и записывать всё подряд нельзя — 5000 событий вы всё равно смотреть не будете, и система «ляжет». Нужно осознанно решить, какие метрики вам действительно важны; недостающие события легко добавить, просто попросив Архитектора или назвав нужную метрику.

📌 Забираем себеАналитика — это решение, а не «галочка по умолчанию». Сформулируйте 10–20 метрик, которые реально будете смотреть (цена регистрации по источникам, доходимость, клики, открываемость, заказы, оплаты), и убедитесь, что под них заведены события.

4.5 Пространства и спецификации (самая важная часть)

Пространство — это контейнер под одну сущность воронки (лендинг, страница «Спасибо», агент, вебинарная комната, рассылка, сервис). Внутри каждого пространства Архитектор пишет огромный файл — спецификацию: полное ТЗ для кодирующего агента. В соседней готовой воронке таких пространств 40.

Для лендинга спецификация описывает: тип и цель ленда, формат, структуру, механики, стиль, копирайтинг; какие секции паспорта прочитать; какие связи с другими пространствами нужны (например, ленд регистрации связан со страницей «Спасибо», с таблицами и событиями). То, что видно глазами (связи, таблицы, события), — лишь верхушка; под ней лежит подробная задача + связи + описание ожидаемого результата. Эта «портянка» и уходит кодирующему агенту.

💡 Урок для вашего проектаЧеловек физически не напишет такие спецификации под 40 пространств — в этом и смысл. Но именно поэтому стоит хотя бы выборочно их проверять: качество ТЗ напрямую определяет качество результата.

4.6 Отдел агентов (ТЗ на инструкции)

Тонкий момент: на этом этапе Архитектор не создаёт агентов — он пишет ТЗ для агента, который потом будет писать инструкции всем агентам. Для каждого агента он планирует роль и инструменты (tools) — функции, которыми агент «дотягивается» до данных и действий:

  • отправить сообщение в чат
  • прочитать контекст пользователя
  • обновить профиль диалога
  • создать/обновить персональный маршрут
  • подобрать материал или функцию emi
  • создать ссылку на установку приложения
  • проверить заказ/подписку
  • создать обращение в поддержку
⚠️ ВажноНа момент съёмки в интерфейсе было видно только 3 агента, хотя в паспорте спроектировано 14. Объяснение: остальные появятся здесь уже после генерации; плюс на каждую серию рассылок создаётся отдельный агент (14 + 3 серии = 17). Это как раз тот участок, который стоит внимательно проверить вручную после генерации — «что он наинструктировал».

4.7 Автоматизации и сервисы

Архитектор заводит автоматизации: вход после регистрации, активация после перехода в emi, после старта триала emi Pro, после оплаты, возврат по полезным действиям. И сервисы — в т.ч. платёжный сервис, которого на момент съёмки не хватало (см. бонус выпуска ниже). Это ещё один ручной шаг, который стоит проверить перед генерацией.

5. Конфигураторы: почему вместе с Архитектором запускаются ещё два агента

Параллельно с Архитектором стартуют конфигуратор лендов и конфигуратор серий сообщений. Они нужны, потому что в паспорте мы не описывали структуру, внешний вид и стиль ленда — и не должны были. Эти детали добавляет отдельный агент, и его «портянка» передаётся кодирующему ботану вместе с задачей от Архитектора.

5.1 Конфигуратор лендинга — какие решения он фиксирует

Итог конфигуратора — ещё одна большая инструкция в дополнение к ТЗ Архитектора. Что он настраивает:

  • Тип ленда (продающий, онлайн-курс, услуга/консалтинг, товарка, промо, вебинар/МК…). Можно довериться агенту, но потом проверить.
  • Структура — набор блоков (hero, спикер, секция с формой, программа/модули, «для кого», проблема→решение и т.д.).
  • Механики конверсии — форма заявки, sticky-кнопка, поп-ап. Пример правила: на регистрационных лендах поп-ап появляется на 35-й секунде — это даёт примерно +15% к конверсии против варианта без поп-апа.
  • A/B-тест — без теста / только текст / только дизайн / текст+дизайн (до 9 комбинаций; разным посетителям показываются разные варианты).
  • Визуальный стиль — из готовых пресетов или свой (можно дать ссылку на workspace с UI-китом или на уже понравившийся ленд).
  • Копирайтинг (классический, авторский, современный, эмоциональный, нишевый…), тональность/фон (светлый/тёмный), генерация изображений (или свои), анимация и hover-эффекты.
📌 Забираем себеЗабираем себе. Без false-обещаний: чтобы ленд понравился «почти с первого раза», на вход подаётся очень много ТЗ — техническое, контентное, структурное, дизайнерское. Это не «нажал кнопку — готово». Это «один раз настроил правила — дальше система выдаёт предсказуемый результат».

5.2 Конфигуратор серий рассылок

Заполняется агентом из паспорта: какой процесс, номер серии, сколько сообщений, сколько серий всего, какие были предыдущие. Настраивается:

  • Тон (на «ты» / на «вы») — обычно подтягивается из документа (Нелли — подруга → «на ты»).
  • Тип/структура серии: например, продающая серия на холодную аудиторию пишется по схеме хук → боль → история → доказательства → закрытие возражений → разрушение мифа → срочный оффер с CTA → открытые «петли». Любой пункт можно убрать/вернуть/собрать свою схему.
  • E-mail-дизайн, стили баннеров и изображений под каждое сообщение.
  • Системные правила — например, длина SMS: 70 символов на кириллице (чтобы агент не сгенерировал письмо на 500 символов и не сделал одну SMS дорогой).
💡 Урок для вашего проектаКонфигуратор — это способ один раз задать «как мы вообще пишем», чтобы все сообщения серии были выдержаны в единой логике, а не «каждое письмо в своём жанре». Хотите контроля — соберите структуру вручную; доверяете — проверьте после. Пример живого вывода: серия «основное сопровождение первого цикла — 11 сообщений за 5 дней».

6. Тонкий ручной момент: URL страницы

Архитектор спрашивает адрес страницы (например, одноэкранный вход к Нелли). Этот URL потом не поменять, поэтому его задают руками — коротким и человекочитаемым (вида `pro.emionline.ru/nelly/reg`), иначе ИИ может налепить длинный «хвост».

📌 Забираем себеПродумайте чистые, короткие URL заранее — это необратимое решение. Адрес воркспейса нельзя менять после установки, важно продумать его заранее.

7. Сколько это стоит

Списание бюджета происходит на этапе генерации, в зависимости от объёма процесса. Ориентиры из выпуска (могут меняться — Chatium постоянно оптимизирует стоимость):

  • Документация/паспорт: ~1000–1500 ₽ при нормальной работе (у автора первый раз вышло ~5000 ₽ — «потому что сам не понимал, чего хочет»).
  • Работа Архитектора: ~1500 ₽.
  • Ленды через конфигуратор: дешевле, т.к. задача чёткая.
  • Отдел из 7–10 агентов с инструкциями: ~1500 ₽.
  • Маленький процесс (один агент + один продающий лендинг): пара тысяч рублей.
  • Большой процесс (21 страница × 3 варианта, 6 серий × ~10 сообщений, 7 агентов, 7 автоматизаций, ~6 сервисов): ориентировочно 20–30 тыс. ₽.
  • Воронка Нелли (лендов почти нет, серий нет): автор ожидает ~20 тыс. ₽. *(Это прогноз до генерации — фактическую цифру увидим в следующем выпуске.)*
📌 Забираем себеЗабираем себе. Честно: цена растёт с объёмом задумки. Чем больше «извращений» вы хотите, тем дороже генерация. Это нормально — вы платите за объём собранного бизнес-процесса, а не за «токены».

8. Утверждение паспорта и что дальше

Когда Архитектор закончил, появляется чек-лист подтверждения перед генерацией: «изучил описание процесса», «выбрал каналы коммуникации», «понимаю, что агенты генерируют на основе паспорта», «проверил переменные», «настроил конфигураторы лендингов и рассылок», «согласен на списание бюджета». Сам по себе экран ни на что не влияет — это осознанная точка «я проверил и беру ответственность».

После подписания запускается генерация: ботан дробит ТЗ на ~15–20 задач, собираются воркспейсы, страницы, агенты пишут свои инструкции — и «толпа» начинает работать. Это ещё 2–3 часа.

Перед тем как нажать «генерировать», автор закладывает отдельный день на проверку — чтобы система не «сгенерила чушь». Что проверять в первую очередь: количество и инструкции агентов (почему именно столько), переменные, спецификации пространств, выбранные транспорты, наличие платёжного сервиса и юридических ссылок (политика ПДн, пользовательское соглашение).

💡 Урок для вашего проектаПроверка — не формальность, а самостоятельный этап работы. Заложите на неё время. Дешевле поправить ТЗ до генерации, чем переделывать собранную воронку.

Бонус выпуска: платёжная страница

У Chatium есть встроенная платёжка и можно подключить любого провайдера (ЮKassА, GetPlatinum, T-банк и др.) с разными методами (карта, СБП, Янд.Сплит, рассрочка/«долями»). Страницу можно полностью кастомизировать (раскладка, цвета) и навесить механики: ИИ-агент-сопровождение оплаты, поп-ап удержания при попытке закрыть форму («не уходи, держи бонус» → цена 5900 → 5400, таймер 5 минут).

Это иллюстрация, что платёжный шаг — тоже управляемая часть воронки, а не «чёрный ящик эквайринга».

9. Ключевые принципы (забираем в свой проект)

  • Качество результата = качество паспорта. Архитектор переводит ваше описание в технику, но не придумывает бизнес за вас.
  • ИИ не «делает», а получает ТЗ. Рабочий результат даёт не фраза «сделай лендинг», а подробная спецификация. Слой Архитектора — это и есть ценность платформы.
  • Архитектор планирует — вы подключаете. Транспорты (тумблеры/боты), коды аналитики, незаполненные переменные, URL страниц, юридические ссылки — ручные шаги, которые он за вас не сделает.
  • Аналитика — это осознанный выбор событий. Не записал событие — нет метрики; но и «писать всё» вредно. Сформулируйте, что реально будете смотреть.
  • Конфигураторы задают единые правила для лендов и серий, чтобы выход был предсказуемым, а не «каждый раз по-разному».
  • Выносите изменяемое в переменные (цены, ссылки, контакты, офферы) — правка в одном месте без переинструктирования агентов.
  • Без false-обещаний: это не «5 минут и кнопка». Архитектор работает ~40 минут, генерация — ещё 2–3 часа, плюс отдельный день на вашу проверку. Зато один раз настроенные правила дают системный, повторяемый результат.
  • Цена зависит от объёма процесса, а не от «токенов»: маленькая воронка — пара тысяч, большая — десятки тысяч рублей.
  • Проверка перед генерацией — отдельный этап. Смотрите агентов и их инструкции, спецификации пространств, переменные, платёжный сервис.