Первый ИИ-агент за вечер: собираем помощника для заявок

Собираем рабочего агента

За этот урок вы создадите агента для обработки заявок: пользователь пишет запрос, модель обращается к каталогу услуг через инструмент, а затем предлагает сохранить заявку. Никаких Telegram, CRM и хостинга на старте — запускаем работающий прототип локально.

1. Подготовка

Установите Python 3.10+ и получите API-ключ OpenAI (API оплачивается отдельно от ChatGPT). В терминале выполните:

mkdir first-agent && cd first-agent
python -m venv .venv
# macOS/Linux: source .venv/bin/activate
# Windows: .venv\Scripts\activate
pip install openai

Задайте переменную окружения OPENAI_API_KEY, не храните ключ в коде. При необходимости выберите доступную модель с function calling через OPENAI_MODEL.

Чем ИИ-агент отличается от чат-бота

Чат-бот отвечает текстом на текст. Агент умеет действовать: сам решает, какой инструмент вызвать, получает результат и только потом отвечает. В агенте для заявок это выглядит так: клиент пишет «сколько стоит уборка двушки?», модель вызывает функцию поиска по каталогу услуг, берёт оттуда реальную цену и предлагает оформить заявку. Этот механизм называется function calling, и он отличает рабочего агента от бота, который уверенно врёт про цены.

Почему начинаем локально, без Telegram и CRM

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

Что будет в итоге

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

Опыт программирования не нужен: код короткий, каждую команду можно скопировать, а если что-то пошло не так, агент в Claude Code или Cursor объяснит ошибку.

Рядом по теме: ИИ-агент первого ответа: уточняет и зовёт менеджера, Нейроагент заявок: из грязного сообщения в карточку CRM, Cursor Rules для API: api.mdc без двойных заказов, статья «Как сделать Telegram-бота с ИИ» и 12 модов Claude Code для вайбкодера (490 ₽).