Telegram MAX Отвечаем в рабочее время за 15 минут
Нужна консультация

Разработка ИИ-агента: что внутри, сколько занимает и чем проверяется

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

Из чего состоит агент

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

  • Модель Отвечает за понимание вопроса и формулировку ответа. Меняется относительно легко: если смена модели ломает весь проект, значит, остальные части собраны неправильно.
  • Инструменты Функции, которые агент вызывает: найти клиента, поднять заказ, собрать сегмент, поставить задачу, отправить сообщение. Каждый инструмент — это явно разрешённое действие с проверкой прав на стороне вашего бэкенда, а не на стороне модели.
  • Память и знания База знаний по товарам, правилам возврата и условиям программы лояльности плюс состояние диалога. Знания хранятся отдельно от модели, поэтому обновление регламента — это правка документа, а не переобучение.
  • Правила Что агент говорит и чего не говорит: границы тона, запретные темы, обязательные формулировки, пороги эскалации на человека.
  • Журналирование Каждый запрос, каждый вызов инструмента и каждый ответ сохраняются. Без логов нельзя ни разобрать жалобу, ни понять, почему качество просело.

Стек в российском контуре

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

СлойВариантыНа что смотреть
МодельЯндекс и Сбер в облаке, открытые модели на своих серверахЦена за тысячу токенов, лимиты, возможность зафиксировать версию
ЗнанияВекторное хранилище рядом с приложениемОбновление без простоя, разграничение доступа по разделам
ОркестрацияСвой сервис на стороне компанииПовторы при сбоях, таймауты, аккуратная деградация при отказе модели
ИнтеграцииCRM, платформа рассылок, учётная система, служба доставкиГотовность API: наличие методов и лимиты на запросы

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

Этапы и что происходит на каждом

Проект первого агента занимает 6–10 недель, из них половина приходится на данные и правила, а не на код.

  1. Разбор процесса и сбор примеров. 50–100 реальных обращений с эталонными ответами. Этот набор станет мерой качества на всём проекте.
  2. Доступы и данные. Подключение к CRM и смежным системам, проверка полноты полей, сверка справочников. Здесь обычно вскрываются дубли и пустые поля, которых «не было».
  3. Сборка инструментов. Каждое действие оформляется отдельной функцией с проверкой прав и ограничением на частоту вызова.
  4. Правила и тон. Описываем, как агент говорит от лица бренда и что делает в спорной ситуации. Формулировки согласуются до запуска, а не после первой жалобы.
  5. Проверка и запуск на части потока. Прогон по золотому набору, затем 10–20% обращений с контрольной группой.

Как проверяется качество

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

  • Золотой набор. 50–100 вопросов с эталонными ответами, включая неудобные: нестандартный возврат, конфликт двух акций, клиент без заказа в системе.
  • Регрессионный прогон. После правки сравниваем результат с предыдущим: исправление одного случая часто ломает соседний.
  • Проверка границ. Отдельные тесты на то, что агент не делает: не обещает скидку, не раскрывает чужие данные, не отвечает на провокации.
  • Разбор логов за неделю. Ручной просмотр случайной выборки диалогов — без него метрики показывают благополучие там, где его нет.

Что нужно от заказчика

Доступ к системам по API, ответственный за содержание со стороны бизнеса и примеры обращений. Чем точнее примеры, тем короче проект: на них проверяется каждая итерация.

Какие задачи агенту по силам — в материале об ИИ-агентах для бизнеса. Как устроен проект по неделям — в статье о внедрении ИИ в бизнес-процессы. Состав работ и форматы — на странице разработки ИИ-агентов.

Частые вопросы

Из чего состоит ИИ-агент?

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

Можно ли сделать ИИ-агента без передачи данных за рубеж?

Да. Модель разворачивается в российском облаке или на своих серверах, база знаний и векторное хранилище живут рядом с приложением, оркестрация работает на стороне компании. Данные не покидают периметр, требование локализации по 152-ФЗ выполняется.

Как проверить качество ИИ-агента перед запуском?

Золотым набором: 50–100 реальных обращений с эталонными ответами, включая неудобные случаи. Агент прогоняется по набору после каждого изменения модели, правил или базы знаний, результат сравнивается с предыдущим прогоном. Отдельно тестируются границы: что агент не обещает скидку и не раскрывает чужие данные.

// НАШИ КАНАЛЫ

Подписывайтесь на наши каналы

Актуальные кейсы, инсайты и практические советы по CRM-маркетингу. Строго без воды, только работающие решения.

Выбирайте удобный канал — 300+ подписчиков, 10–12 постов в неделю.

Готовы к захватывающему росту?

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