AI для разработчиков 14 мин чтения

Как создать AI-агента в 2026: первый рабочий агент без кода за вечер

Пошаговый гайд практика: что такое AI-агент, как выбрать инструмент, собрать агента без кода через n8n, на Claude API и YandexGPT, запустить локально, не наделать частых ошибок и сколько это стоит.

AI-агентыn8nClaudeYandexGPT

Коротко (TL;DR)

  • AI-агент — это не просто чат-бот: он сам ставит подзадачи, вызывает инструменты и итерирует до результата.
  • Начните с формулировки конкретной задачи и списка источников данных — без этого инструмент не важен.
  • Без кода — n8n или Make; с кодом — Claude API или YandexGPT API; локально — Ollama + LangChain.
  • Практический пример в статье: агент-ассистент для ответов на входящие вопросы с базой знаний.
  • Стоимость в продакшне сильно зависит от задачи — диапазоны и ориентиры ниже.

Я занимаюсь внедрением AI-агентов в реальные проекты — от небольших автоматизаций для российского бизнеса до мультиагентных систем. За последние полтора года вопрос «как создать AI-агента» из академического превратился в совершенно прикладной. Его задают маркетологи, операционные директора, разработчики, которые раньше никогда не работали с LLM. В этой статье я пройдусь по всему пути — от теории до конкретного кода и цифр.

Что такое AI-агент простыми словами

Чат-бот отвечает на вопрос. AI-агент — решает задачу. Разница принципиальная.

Когда вы пишете в ChatGPT «напиши письмо», модель генерирует текст и останавливается. Агент в той же ситуации сначала спросит себя: «Что именно нужно сделать?», потом обратится к инструменту (например, прочтёт историю переписки из CRM), потом составит черновик, проверит его на соответствие тону компании, и только потом выдаст результат. Если на каком-то шаге что-то пошло не так — переберёт вариант.

Формально AI-агент — это языковая модель, обёрнутая в цикл рассуждений (ReAct, Chain-of-Thought и т.д.) с доступом к набору инструментов (tools): поиск в интернете, чтение базы данных, отправка HTTP-запросов, запуск кода. Модель сама решает, какой инструмент вызвать и в каком порядке.

Ключевые признаки агента:

  • Автономия. Агент сам определяет последовательность шагов.
  • Инструменты. У него есть функции, которые он может вызывать.
  • Память. Краткосрочная (контекст сессии) или долгосрочная (векторная БД, база знаний).
  • Цикличность. Он итерирует: выполнил шаг — оценил — скорректировал — выполнил следующий.

Отличие от RPA (роботизированной автоматизации): RPA следует жёсткому сценарию. Агент работает с неструктурированными вводными и сам строит сценарий под задачу.

Важный нюанс. Слово «агент» сегодня используется очень широко — от простейшего скрипта с вызовом API до сложной мультиагентной системы. Не позволяйте терминологии вас запутать: смотрите на конкретную архитектуру, а не на маркетинговый ярлык.

С чего начать: задача и данные

Самая частая ошибка при создании AI-агента — начать с выбора инструмента. Правильный порядок обратный.

Шаг 1. Сформулируйте задачу одним предложением

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

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

Шаг 2. Определите источники данных

Агент без данных — это дорогой генератор текста. Составьте список:

  • Где хранятся данные, с которыми будет работать агент (Google Sheets, Notion, PostgreSQL, PDF-файлы, сайт)?
  • Есть ли API для доступа к ним?
  • Как часто данные обновляются?
  • Есть ли конфиденциальные данные, которые нельзя отправлять в сторонние сервисы?

Последний пункт критически важен для российских компаний — он во многом определит выбор между облачным и локальным решением.

Шаг 3. Опишите инструменты

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

  • Поиск по базе знаний (векторный поиск или полнотекстовый)
  • Чтение/запись в CRM или таблицу
  • Отправка уведомлений (email, Telegram, MAX)
  • Вызов внешнего API (погода, курсы валют, склад)
  • Выполнение кода (для вычислений)

На этом этапе не думайте об имплементации — просто перечислите, что должен уметь агент.

Как выбрать инструмент для создания агента

После того как задача и данные описаны, выбор инструмента становится техническим решением, а не маркетинговым. Вот сравнительная таблица основных подходов:

Инструмент Порог входа Гибкость Стоимость Подходит для
n8n (self-hosted) Низкий Средняя Бесплатно (сервер) Автоматизации, простые агенты
n8n Cloud Низкий Средняя От ~20$/мес Быстрый старт без DevOps
Claude API (Anthropic) Средний Высокая Pay-per-token Сложные агенты, мультиагенты
YandexGPT API Средний Средняя Pay-per-token (руб.) Проекты в РФ, данные внутри страны
Ollama + LangChain Высокий Максимальная Только железо Конфиденциальные данные, локальный запуск
OpenAI Assistants API Низкий Средняя Pay-per-token Быстрые прототипы

Моя рекомендация для большинства: начните с n8n для проверки гипотезы, переходите на API-решение, когда задача подтверждена. Это экономит время и деньги.

Создание AI-агента через n8n (без кода)

n8n — это open-source инструмент для автоматизаций с визуальным редактором. В версии 1.x появился полноценный узел AI Agent, который поддерживает OpenAI, Anthropic, Google и другие модели.

Базовая схема агента в n8n

  1. Триггер. Webhook (входящий HTTP-запрос), расписание, событие в Telegram или другом сервисе.
  2. AI Agent node. Здесь вы подключаете модель и задаёте системный промпт.
  3. Tools. К агенту привязываются инструменты — узлы n8n, которые агент может вызывать: HTTP Request, Postgres, Google Sheets и т.д.
  4. Memory. Опционально — Window Buffer Memory для хранения контекста диалога.
  5. Действие по результату. Агент возвращает ответ — вы отправляете его в Telegram, сохраняете в таблицу или возвращаете через webhook.

Практически важный момент: системный промпт в n8n агенте — это не просто «ты помощник». Это подробная инструкция с описанием роли, ограничений, формата ответа и примерами. Вложите в него время — это 80% качества агента.

Частая ошибка с n8n. Люди подключают AI Agent node, пишут один системный промпт и считают, что агент готов. На практике нужно ещё тщательно описать каждый инструмент: что он делает, когда его вызывать, какие параметры передавать. Без этого модель будет угадывать — и ошибаться.

Self-hosted vs Cloud

Если данные чувствительные — разворачивайте n8n на своём сервере. Это несложно: Docker-образ, один файл docker-compose.yml, пять минут. Я использую VPS от российских провайдеров под задачи, где данные не должны покидать страну.

Для быстрого прототипа n8n Cloud — нормальный выбор. Потом при необходимости мигрируете.

Создание AI-агента на Claude API

Claude (Anthropic) — это то, на чём я лично строю большинство сложных агентов. Модели серии Claude 3.5/3.7/4 очень хорошо следуют инструкциям, надёжно вызывают инструменты и редко «галлюцинируют» в структурированных задачах.

Tool use (вызов инструментов)

Claude поддерживает нативный tool use. Вы передаёте в API описание инструментов в формате JSON Schema, и модель возвращает структурированный вызов — вы его исполняете и возвращаете результат. Это основа любого агента на Claude API.

Схема цикла агента:


# Псевдокод агентного цикла на Claude API
messages = [{"role": "user", "content": user_input}]

while True:
    response = claude.messages.create(
        model="claude-sonnet-4-5",
        system=SYSTEM_PROMPT,
        tools=TOOLS_DEFINITION,
        messages=messages
    )

    if response.stop_reason == "end_turn":
        # Агент завершил работу
        return response.content[0].text

    if response.stop_reason == "tool_use":
        # Агент хочет вызвать инструмент
        tool_call = extract_tool_call(response)
        tool_result = execute_tool(tool_call)

        # Добавляем вызов и результат в историю
        messages.append({"role": "assistant", "content": response.content})
        messages.append({"role": "user", "content": [tool_result]})
        # Продолжаем цикл

Это и есть суть любого агента — цикл «рассуждение → действие → наблюдение → рассуждение». ReAct (Reasoning + Acting) в чистом виде.

Мультиагентные системы

Когда задача слишком сложная для одного агента — её делят между несколькими. Orchestrator-агент принимает задачу, декомпозирует её и раздаёт подзадачи специализированным sub-агентам. Каждый sub-агент работает в своём контексте с нужными ему инструментами.

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

Создание AI-агента на YandexGPT

Для проектов внутри России YandexGPT — логичный выбор по нескольким причинам: данные обрабатываются на российских серверах, оплата в рублях, хорошая поддержка русского языка, интеграция с экосистемой Яндекса (Алиса, Tracker, Cloud).

Yandex AI Agent через Yandex Cloud

Яндекс активно развивает направление AI-агентов в рамках Yandex Cloud. Основные варианты:

  • YandexGPT API — прямой вызов модели, аналогично Claude/OpenAI API. Поддерживает function calling начиная с определённых версий моделей.
  • Yandex Foundation Models — более широкий доступ к моделям через единый API Yandex Cloud.
  • Интеграция через n8n или LangChain — используйте YandexGPT как провайдер в привычном фреймворке.

Практически: если у вас уже есть инфраструктура в Yandex Cloud (Managed PostgreSQL, Object Storage, функции), агент на YandexGPT встраивается в неё нативно. Если инфраструктуры нет — взвесьте, стоит ли начинать с Яндекса только ради агента, или проще взять Claude/OpenAI с хранением данных на российском VPS.

Качество русскоязычных ответов у YandexGPT хорошее, особенно в задачах с бизнес-текстами. На сложных многошаговых агентных задачах модели от Anthropic пока ведут по моим наблюдениям, но разрыв сокращается.

Пошаговый пример: агент-ассистент с базой знаний

Разберём конкретный случай: агент отвечает на вопросы клиентов по базе знаний компании. Входящий вопрос приходит через Telegram или webhook, агент ищет в базе, формулирует ответ, при необходимости — эскалирует.

Шаг 1. Подготовка базы знаний

Собираем документы (FAQ, регламенты, описания продуктов) и загружаем их в векторную базу. Я использую pgvector (расширение для PostgreSQL) или Qdrant для более тяжёлых случаев. Тексты разбиваются на чанки (обычно 500–800 токенов с перекрытием 100 токенов), каждый чанк векторизуется embedding-моделью и сохраняется.

Шаг 2. Описание инструментов

Для нашего агента нужны три инструмента:

  1. search_knowledge_base(query) — семантический поиск по базе, возвращает топ-3 релевантных фрагмента.
  2. escalate_to_manager(question, reason) — отправляет вопрос менеджеру с пометкой причины эскалации.
  3. log_interaction(question, answer) — логирует взаимодействие для анализа.

Шаг 3. Системный промпт

Системный промпт должен чётко объяснять агенту:

  • Кто он и в какой компании работает
  • Что он должен делать в первую очередь (всегда искать в базе перед ответом)
  • Когда эскалировать (если база не содержит ответа, если вопрос юридический, если клиент выражает недовольство)
  • Что нельзя делать (придумывать факты, давать скидки без базы)
  • Формат ответа

Шаг 4. Сборка в n8n

В n8n это выглядит так:

  1. Telegram Trigger — получает сообщение
  2. AI Agent node — подключён к Claude Sonnet, системный промпт из шага 3, tools из шага 2
  3. Postgres Tool — реализует search_knowledge_base через pgvector
  4. HTTP Request Tool — реализует escalate_to_manager (POST в систему тикетов или в Telegram менеджера)
  5. Postgres Tool (второй) — реализует log_interaction
  6. Telegram — отправляет ответ пользователю

Шаг 5. Тестирование

Тестируйте не только «счастливый путь». Обязательно проверьте:

  • Вопрос, которого нет в базе — агент должен эскалировать, а не выдумывать
  • Вопрос с опечаткой — семантический поиск должен справиться
  • Агрессивный или провокационный вопрос — агент не должен отвечать на него агрессией
  • Очень длинный вопрос — проверьте лимиты контекста

Шаг 6. Запуск и мониторинг

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

Локальный AI-агент

Если данные нельзя отправлять в облако — нужен локальный агент. Это возможно: Ollama позволяет запустить открытые модели (Llama 3.3, Mistral, Qwen) прямо на вашем сервере или даже ноутбуке.

Минусы локального запуска: более слабое качество (по сравнению с Claude Sonnet или GPT-4o), нужно железо (GPU желательно, на CPU медленно), сложнее обновлять модели.

Детально про локальные решения, сравнение моделей и настройку я разобрал в отдельной статье — бесплатные и локальные AI-агенты в 2026. Там же про агенты с нулевой стоимостью вывода.

Частые ошибки при создании AI-агентов

За полтора года внедрений я видел одни и те же ошибки снова и снова.

Ошибка 1. Слабый системный промпт

«Ты умный ассистент, помогай пользователям» — это не промпт. Агент не знает, что значит «помогать», в каком формате отвечать, что делать в нештатных ситуациях. Хороший промпт занимает минимум 300–500 слов и покрывает все граничные случаи.

Ошибка 2. Нет ограничений на цикл

Агент может войти в бесконечный цикл — особенно если инструменты возвращают неожиданные результаты. Всегда устанавливайте максимальное количество итераций (обычно 10–15 для большинства задач) и таймаут.

Ошибка 3. Слишком много инструментов

Я видел агентов с 30+ инструментами. Модель буквально теряется. Начните с 3–5 инструментами. Если нужно больше — рассмотрите мультиагентную архитектуру, где каждый агент специализирован.

Ошибка 4. Нет обработки ошибок инструментов

Инструмент упал с 500-й ошибкой — что делает агент? Если вы не описали это в промпте и не обработали в коде, агент либо зависнет, либо выдаст что-то несвязное. Каждый инструмент должен возвращать понятный агенту результат даже при ошибке.

Ошибка 5. Игнорирование стоимости

Агент, который делает 20 итераций по 5000 токенов каждая, может стоить дорого в продакшне при высокой нагрузке. Считайте токены на этапе проектирования, не после запуска.

Ошибка 6. Запуск без человеческого надзора

AI-агент, который самостоятельно удаляет данные, отправляет письма или проводит транзакции — это риск. На этапе внедрения всегда добавляйте human-in-the-loop для критических действий. Убирайте надзор постепенно, по мере набора доверия.

Сколько стоит AI-агент в продакшне

Прямой ответ: зависит от задачи. Но диапазоны дать можно.

Стоимость вывода (inference)

Основная статья расходов — токены. Ориентиры (актуальны на середину 2026, могут меняться):

  • Claude Sonnet — несколько долларов за миллион токенов ввода/вывода. Агент с 5000 токенов на запрос при 1000 запросах в день — порядка 100–300 USD/мес. Сильно зависит от длины контекста и числа итераций.
  • Claude Haiku — значительно дешевле Sonnet, подходит для простых агентов с короткими ответами.
  • YandexGPT — тарификация в рублях, сопоставима по порядку величин с зарубежными аналогами при пересчёте.
  • Локальные модели (Ollama) — стоимость вывода нулевая, но нужно оплачивать железо (VPS с GPU от 5000–15000 руб/мес в зависимости от мощности).

Разработка и поддержка

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

Инфраструктура

Self-hosted n8n на VPS — от 500 руб/мес. Yandex Cloud с Managed PostgreSQL — от 2000–5000 руб/мес в зависимости от нагрузки. Собственный сервер с GPU — значительно дороже, но окупается при большом объёме.

Подробнее про экономику AI-агентов в реальных проектах — в статье AI-агенты в бизнесе: кейсы и ROI.

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

Можно ли создать AI-агента без программирования? Да, через n8n или аналогичные no-code платформы можно собрать вполне рабочего агента без написания кода. Но понимание базовых концепций (что такое webhook, как работает JSON, что такое API-ключ) всё равно потребуется. Нулевые технические знания — это ограничение, которое нельзя полностью обойти даже с no-code инструментами.

Чем отличается AI-агент от обычной автоматизации в Zapier или Make? Классическая автоматизация работает по жёстко заданному сценарию: если А, то Б. AI-агент принимает решения на каждом шаге на основе контекста и рассуждений. Он может отклониться от «стандартного» пути, если ситуация этого требует. Это делает его значительно мощнее для сложных задач и значительно сложнее для отладки.

Насколько надёжны AI-агенты — можно ли им доверять критические процессы? С осторожностью и постепенно. Агенты ошибаются — реже при хорошем промпте и надёжных инструментах, чаще при плохих данных или неожиданных ситуациях. Для критических процессов (финансовые транзакции, юридически значимые действия) всегда предусматривайте human-in-the-loop. По мере накопления данных о работе агента можно расширять его автономию.

Какая модель лучше для русскоязычного агента в 2026? По моему опыту: для максимального качества рассуждений — Claude Sonnet или Opus; для русскоязычных бизнес-задач с хранением данных в РФ — YandexGPT; для баланса цены и качества — Claude Haiku или GPT-4o-mini. Тестируйте на ваших конкретных задачах, не доверяйте только бенчмаркам.

Можно ли запустить агента на базе open-source модели бесплатно? Можно, если есть подходящее железо. Llama 3.3 70B или Qwen 2.5 72B на GPU-сервере дают вполне приемлемое качество для многих задач. На CPU это будет медленно — 1–5 минут на ответ, что неприемлемо для интерактивных приложений. Подробнее — в статье про бесплатные и локальные AI-агенты.

Выводы

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

Главное, что я хочу донести:

  • Начинайте с задачи, не с инструмента. Правильно сформулированная задача — это 50% успеха.
  • Итерируйте быстро. Сделайте прототип за день, запустите, посмотрите на реальные ошибки, улучшите. Не пытайтесь сделать идеально с первого раза.
  • Инвестируйте в промпты. Качество системного промпта определяет качество агента больше, чем выбор модели.
  • Мониторьте. Агент без мониторинга — это риск. Логируйте всё, просматривайте ошибки регулярно.
  • Не автоматизируйте то, что не понимаете. Если процесс плохо работает без агента, агент его не исправит — только ускорит хаос.

AI-агенты — это инструмент, который при правильном применении реально экономит время и деньги. При неправильном — тратит их. Разница между этими двумя исходами — в дисциплине на этапе проектирования.

Услуги по теме

Что я делаю по AI для бизнеса

  • AI-агенты и LLM-решения под задачу
  • Интеграция с n8n, CRM и мессенджерами
  • RAG: агент по вашей базе знаний
  • Локальное развёртывание под 152-ФЗ
Написать в Telegram

Готовы обсудить вашу задачу?

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

Готовые решения под ключ 449 готовых IT-решений для бизнеса Автоматизация, боты, AI, 152-ФЗ и платформы · бесплатная консультация Смотреть каталог