ИИ-ассистент в n8n: как подключить свою модель

В n8n появился встроенный ассистент, который строит и чинит сценарии по описанию на обычном языке. С версии 2.35 он включён по умолчанию и доступен в самостоятельно развёрнутых экземплярах, а не только в облаке. Самое важное для нашего читателя — в устройстве: модель подключаете вы сами и платите её поставщику напрямую. Выбор поставщика делается в интерфейсе, туда же настраивается песочница и поиск. Функция помечена как предварительная: разработчики прямо предупреждают, что она может ошибаться и что сгенерированные сценарии стоит проверять перед выкаткой. Разбираем, как это устроено, почему схема «свой ключ» лучше подписки и что проверить перед подключением.

Что он умеет

По документации, ассистент закрывает четыре типа задач.

Создание сценария по описанию. Вы формулируете, что нужно сделать, он собирает узлы и связи.

Правка существующего. Изменить логику, добавить ветку, поменять условие — не переставляя узлы руками.

Тестирование и починка. Прогнать сценарий, посмотреть на ошибку, предложить исправление.

Задачи экземпляра. Переименование, публикация и прочие операции, которые обычно делаются через интерфейс.

Отдельно заявлено, что он умеет строить агентов — то есть сценарии, где модель вызывается внутри самого процесса.

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

Почему «свой ключ» — правильная схема

Здесь то, ради чего мы вообще пишем об этом инструменте.

Есть два способа встроить ИИ в продукт. Продать подписку: разработчик покупает доступ оптом, накручивает маржу и берёт с вас фиксированную сумму. Дать подключить свой ключ: вы платите поставщику модели напрямую, разработчик не участвует в этой цепочке.

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

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

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

Нет зависимости от посредника. Разработчик инструмента не может ни поднять вам цену на инференс, ни ограничить доступ: он его не продаёт.

Мы уже отмечали ту же конструкцию у кодинг-агента fx и у настольного агента с четырьмя уровнями прав. Схема «харнесс отдельно, модель отдельно» становится нормой, и это в пользу пользователя.

Что проверить перед подключением

Практический порядок, если решите попробовать.

1. Проверьте, какая модель вам нужна и открыт ли маршрут. Читать нужно protocols.chat_completions в ответе GET /v1/models: значение available означает, что запрос пройдёт.
2. Начните с дешёвой позиции. Ассистент делает много обращений, и ставка умножается на их число. В каталоге есть позиции от 3 ₽ за миллион токенов и пять с нулевой ставкой.
3. Проверьте параметры. Часть моделей отклоняет то, что другие принимают — что ломается при переносе.
4. Заведите отдельный ключ. Не общий с продакшеном: так виден расход именно на ассистента, и его лимит не пересекается с рабочим.
5. Настройте логирование расхода. Пять полей превращают счёт из загадки в таблицу — какие именно.

Четвёртый пункт стоит сделать сразу: инструмент в предварительном состоянии может вести себя непредсказуемо по объёму, и отдельный ключ с лимитом — самая дешёвая страховка.

Почему это важно именно для автоматизации

Отдельное наблюдение, потому что аудитория таких инструментов отличается от аудитории кодинг-агентов.

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

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

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

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

Чем это отличается от кодинг-агента

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

Кодинг-агент работает с файлами и шеллом. Основные риски — удаление, выполнение произвольного кода, доступ к секретам в окружении. Мы разбирали случай, где агент удалил домашний каталог.

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

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

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

Сколько это будет стоить

Практический вопрос, на который в документации ответа нет, потому что зависит он от вас.

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

Сборка простого сценария из нескольких узлов — это, по опыту работы с подобными инструментами, единицы обращений, суммарно тысячи токенов. На модели за 3 ₽ за миллион это доли копейки. На флагманской позиции — всё ещё копейки, но уже в десятки раз больше.

Разговор становится предметным на объёме. Если ассистентом пользуется команда и каждый собирает по несколько сценариев в день, разница между дешёвой и дорогой моделью превращается в заметную сумму за месяц.

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

И ещё одно, специфичное для этого класса инструментов: у ассистента, который строит сценарии, есть объективная проверка. Сценарий либо запускается и делает что нужно, либо нет. Это редкая роскошь — большинство задач с моделями так не проверяется, и здесь ей стоит воспользоваться.

Про данные и песочницу

Два свойства реализации, заявленные в документации, заслуживают внимания.

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

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

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

Чего мы не утверждаем

Мы не тестировали ассистента. Все свойства — по документации, перечисленной в источниках.

Не проверяли связку с нашим каталогом. Схема «свой ключ» это допускает, но конкретную настройку мы не проверяли и работоспособность не обещаем.

Функция предварительная. Разработчики прямо предупреждают об ошибках и об изменении поведения; переносить наблюдения на будущие версии нельзя.

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

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

Что держать в голове

В популярном инструменте автоматизации появился встроенный помощник, работающий на вашем ключе. Это значит, что расход виден, модель выбираете вы, а разработчик инструмента в цепочку оплаты инференса не входит.

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

Как мы отделяем проверенное от предполагаемого — на странице о проекте. Ключ для любого совместимого инструмента заводится за минуту: keydealer.ru/login.