Инструменты роя: как агенты совершают реальные действия, а не только болтают

Инструменты (тулы) ИИ-агентов — на примере воронки EmiPro

Этот выпуск — продолжение цикла, где мы шаг за шагом собираем воронку продаж на отделе из ИИ-агентов. Дорабатываем связи в базе знаний, запускаем генерацию всей воронки (14 агентов, 2 лендинга, реферальный сервис) и подробно разбираем тулы — то, без чего агент остаётся просто болтливым чат-ботом.

Главное из выпуска: агент начинает приносить деньги не от красивого промпта, а от того, до каких данных и действий он может дотянуться.

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

Кейс — мобильное приложение EmiPro (бьюти-подписка для мастеров и их аудитории), собранное на Chatium. Внутри: подписочная модель (триал 7 дней → 490 руб/мес → 1990 руб/6 мес → 3490 руб/год), дневники, челленджи, онлайн-запись, лента, рейтинги, баллы и кристаллы.

Поверх этого строим отдел агентов во главе с Нелли. Вести и поддерживать она может только если умеет заглянуть внутрь приложения — отсюда и тулы.

Три опоры любого агента

Чтобы агент заработал как адекватный персонаж, нужны три вещи. Запомните их как чек-лист.

• 1. Инфраструктура. Где агент «живёт»: Chatium — контакты, воркспейсы, базы знаний, режимы, настройки автономности, модель.
• 2. Инструкция (промпт). Должностная инструкция: что делает, зачем, какие цели, какими инструментами пользуется.
• 3. Инструменты (тулы). «Ручки», которыми агент дотягивается до информации и действий. Через них растут конверсии.

Как пишется должностная инструкция: структура и «смысл существования»

Инструкция не пишется с чистого листа — вас ведёт по структуре Методолог. Базовый каркас: роль, триггеры включения, главная задача, как собирается информация, границы роли, результаты работы.

Ключевая часть — смысл существования агента: ради чего он существует и по каким конкретным, измеримым параметрам можно оценить его работу. Разобрано на Нелли-подруге: смысл — создавать условия, при которых у пользовательницы хорошее настроение. Метрики: позитивная отметка в календаре настроения и индекс счастья сообщества.

Что такое тул на самом деле — на одном примере

Самый наглядный разбор — тул «Изучить дневники пользователя EmiPro». В приложении есть дневники (настроения, благодарности, успеха, «Мой день»). Тул описывается по понятной схеме:

• Тип — чтение данных, анализ последних записей
• Источник данных — таблицы дневников и оценок энергии
• Что делает — наличие записей, темы, индекс энергии, динамика и регулярность
• Когда используется — когда Нелли хочет поддержать персонально, заметить спад, похвалить за успех
• Что возвращает — краткую картину: записи, смыслы, индекс энергии, регулярность, сигналы спада/роста
• Что НЕ делает — не создаёт и не редактирует записи. Границы обязательны!

Тулы на чтение и тулы на запись

Большинство тулов — на чтение: агент смотрит и реагирует. Но тул может и писать в приложение: Нелли может сама спросить «как настроение?» и сама проставить отметку; предложить записать благодарность — и сама внести запись.

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

Каталог тулов (~20 штук) — что заказали под отдел

Один тул — на нескольких агентов. Тул CheckTask стоит и у Нелли-подруги, и у Нелли-наставника — один и тот же инструмент, просто разрешённый разным агентам. Переиспользуйте, не плодите копии.

• Выдать персональную реферальную ссылку — Нелли присылает её прямо в чат. Бонусы: 100 баллов + 500 кристаллов за установку другом, +10 дней подписки если друг купил EmiPro
• Проверить статус профиля — заполнен ли профиль, чем занимается, фото (кладезь контекста)
• Проверить подписку EmiPro — тариф, сколько дней осталось. Без этого агент звучит тупо
• Отправить ссылку на paywall + оформить заказ — продающая страница и ссылка на оплату прямо в чат
• Проверить онлайн-запись мастера и цель по доходу — сколько записей, какие статусы
• Получить информацию о базе клиентов мастера — сколько клиентов, появились ли новые
• Проверить челленджи + получить каталог — подобрать и предложить с наградой
• Проверить стрик «в огне» — сколько дней подряд (рекордсмен — 208 дней)
• Проверить прохождение уроков — что и в каких категориях прошёл
• Проверить историю баллов — «кто перед нами» (у кого 100, у кого 40 000)
• Проверить статус заказа и оплаты — оформлен, но не оплачен → повод дожать
• Получить актуальные тарифы — агент всегда говорит по свежим цифрам и знает про акции
• Проверить «Мои дела» / задачи и заметки — агент не забывает, как тебя зовут
• Проверить профиль мастера, услуги и прайс — качество упаковки
• Проверить график и свободные окна мастера — голосовой: «что у меня послезавтра?»
• Проверить активность в ленте — публикует ли посты, комментирует; для задачи «строить личный бренд»
• Получить ссылки на приложение — App Store / Google Play для нужного момента

Архитектура и генерация: что собралось и где затык

Транспорты надо включить руками — email, Max, Telegram-бот. Без этого агентам не в чем разговаривать. Нелли также живёт внутри приложения (отдельный чат).

В базе знаний прописаны связи с существующими воркспейсами: EmiPro, UserList (заказы, подписки, рекуррентные платежи), конструктор курсов, онлайн-запись. Без этих интеграций тулам не к чему подключаться.

• 2 лендинга (короткий рекламный вход к Нелли + большой)
• 6 автоматизаций
• Реферальный сервис Nelly
• Серия сервисных сообщений (тёплым голосом Нелли на ключевые события)
• База из 5 таблиц на 52 поля (лиды Нелли, реферальные таблицы, обращения в поддержку)

Паспорт как защитный шлюз

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

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

Автономность: проактивные агенты вместо ждущих

Обычно агент вступает в диалог только после сообщения человека. Но галочка «автономность» позволяет агенту включиться самому. Управляет автономностью Верховная Леночка: она видит лид, который обещал оплатить и не оплатил, и сама вызывает агента-продавца «иди дожми».

Отдел — не 14 пассивных болтунов, а проактивная команда под управлением, которая идёт к своим целям.

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

• Три опоры агента: инфраструктура → должностная инструкция → тулы. Именно в этом порядке.
• Тулы — это конверсия. Болтливый агент без доступа к данным бесполезен.
• Глубина тулов = единая инфраструктура. Всё внутри одной платформы — глубокие тулы.
• Описывайте тул по схеме: тип → источник → что делает → когда → вход → что возвращает → что НЕ делает.
• Смысл существования агента — измеримый. Привязывайте к реальным метрикам продукта.
• Один тул — на многих агентов. Переиспользуйте, не плодите копии.
• Тулы на запись — точка монетизации. Действия агента за пользователя логично закрывать подпиской.
• Паспорт читать, конфигураторы открывать. Шлюз спасает от слитого бюджета.
• Автономность через руководителя отдела. Проактивность по событиям, централизованный вызов — иначе спам.
• Тулы не встают с первого раза. Закладывайте тестирование и переделки в план.