Как создать ИИ-агента: разбор одного агента

Как создать ИИ-агента: короткий ответ

ИИ-агент отличается от чат-бота тем, что не только отвечает, но и делает: создает сделку, ставит задачу, отправляет письмо. Поэтому создание агента - это проектирование действий и ограничений, а промпт лишь одна из частей.

1. Выберите один процесс и опишите результат одной фразой.
2. Разбейте процесс на шаги и отметьте, где нужно решение.
3. Составьте список инструментов: что агент читает и что меняет.
4. Напишите системную инструкцию с правилами и запретами.
5. Соберите схему в n8n, Make или коде.
6. Добавьте журнал действий и подтверждение человеком.
7. Прогоните на тестовом наборе и запустите в режиме черновика.

Дальше каждый шаг разобран на одном примере.

Задача для агента: разбор заявок из почты

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

Результат одной фразой: каждое письмо с заказом превращается в черновик сделки с позициями, а менеджер только подтверждает.

Шаги процесса

1. Прочитать новое письмо и понять, заявка ли это.
2. Найти клиента в CRM по адресу или ИНН.
3. Извлечь позиции, количество и желаемую дату.
4. Сопоставить позиции с каталогом.
5. Создать черновик сделки и отправить менеджеру на подтверждение.

Решения нужны на шагах 1 и 4: отличить заказ от рекламы и понять, что «кабель трехжильный 2,5 бухта» - это конкретный артикул. Остальное - механика. По числу шагов это пилот: до 5 шагов с ручным подтверждением. Если почта, CRM и каталог живут в разных системах, каждая дополнительная интеграция считается отдельно, от 12 000 ₽, или весь процесс уходит в пакет «Бизнес».

Инструменты агента и права доступа

Инструмент - это действие, которое агент может вызвать. Чем меньше прав, тем меньше ущерб от ошибки.

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

Промпт ИИ-агента: пример системной инструкции

Системная инструкция задает роль, порядок действий и запреты. Пишите ее как инструкцию новому сотруднику, а не как рекламный текст.

Ты разбираешь входящие письма отдела продаж оптовой компании. Для каждого письма: 1) реши, заказ ли это. Если нет, пометь «не заявка» и остановись. 2) Найди клиента инструментом поиска. Если не нашел, пометь «новый клиент». 3) Выпиши позиции, количество, дату. 4) Для каждой позиции найди артикул в каталоге. Если уверенного совпадения нет, не угадывай, пометь «уточнить». 5) Создай черновик сделки и передай на подтверждение. Никогда не меняй цены, не отправляй письма клиенту сам, не создавай сделки вне воронки «Входящие заявки».

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

Модель для такого агента в России чаще берут российскую: GigaChat или YandexGPT. Если в письмах есть персональные данные, это еще и вопрос 152-ФЗ: где хранятся данные и кто к ним имеет доступ.

Как создать ИИ-агента в n8n

n8n - платформа визуальной автоматизации, в которой есть готовый узел ИИ-агента. Схема нашего примера собирается так.

Триггер

Узел почты проверяет ящик по расписанию и забирает новые письма из папки заявок. Вложения передаются дальше как файлы.

Узел ИИ-агента

К нему подключают модель, системную инструкцию и инструменты. Инструментами становятся другие узлы: запрос в CRM, поиск по таблице каталога, HTTP-запрос к любому API.

Распознавание вложений

Таблицы читаются напрямую. Фото и сканы сначала проходят распознавание, иначе агент увидит только картинку.

Подтверждение

Агент отправляет менеджеру в Telegram карточку черновика с кнопками «Подтвердить» и «Исправить». Сделка уходит дальше по воронке только после нажатия.

Журнал

Каждый шаг пишется строкой в таблицу или базу. Об этом ниже.

Требования к серверу и готовые схемы описаны на странице автоматизация на n8n. Код вместо n8n нужен, если логика ветвится сильнее, чем удобно рисовать, или нужна система без готового узла.

Журнал действий и точки подтверждения человеком

Журнал отвечает на вопрос «почему агент так сделал». Без него любая ошибка превращается в расследование.

Где ставить подтверждение

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

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

Тестирование и запуск: 10 писем до боевого режима

Соберите тестовый набор из реальных писем прошлого месяца. Минимум 10 штук, и обязательно трудные.

• 2 обычных заказа таблицей;
• 2 заказа текстом с сокращениями и опечатками;
• 1 фото рукописного заказа;
• 1 письмо от нового клиента;
• 1 заказ с позицией, которой нет в каталоге;
• 1 рекламное письмо;
• 1 вопрос о статусе, а не заказ;
• 1 ответ клиента в старой цепочке.

Сравните результат агента с тем, что сделал бы менеджер. Первые две недели агент работает в режиме черновиков, менеджер подтверждает все. Затем по журналу видно, где можно ослабить контроль. Сколько такой агент стоит в разработке и в месяц, мы разобрали в статье сколько стоит ИИ-агент.