База знания - AI-агентов

Инструкция: Интеграция n8n с AI-сервисами Яндекса (YandexGPT)

Интеграция n8n с нейросетями от Яндекса позволяет добавить в ваши сценарии автоматизации мощный искусственный интеллект. Вы сможете автоматически писать тексты, анализировать входящие сообщения, классифицировать данные и многое другое.
Поскольку в n8n нет готового узла для YandexGPT, интеграция настраивается с помощью универсального узла «HTTP Request». Процесс состоит из двух основных этапов: получение ключей доступа в консоли Yandex.Cloud и настройка самого узла в n8n.

Часть 1: Подготовительный этап в Yandex.Cloud

Для взаимодействия с API Яндекса вашему n8n потребуются два основных идентификатора: ID каталога и секретный API-ключ.

Шаг 1: Получение ID каталога

  1. Войдите в вашу консоль управления Yandex.Cloud.
  2. Убедитесь, что вы находитесь в нужном облаке. В левом верхнем углу вы увидите ваш каталог (обычно он называется default).
  3. Нажмите на имя каталога. В открывшемся окне вы увидите строку ID каталога. Скопируйте этот идентификатор (длинную строку из букв и цифр) и сохраните его в надежном месте. Он понадобится нам позже.

Шаг 2: Создание API-ключа

Для автоматизации лучше всего использовать статические API-ключи, привязанные к специальному сервисному аккаунту.
  1. В консоли управления Yandex.Cloud, находясь в вашем каталоге, в строке поиска вверху введите «Сервисные аккаунты» и перейдите в этот раздел.
  2. Нажмите кнопку «Создать сервисный аккаунт».
  3. Придумайте любое имя (например, n8n-integrator) и нажмите «Создать».
  4. После создания аккаунта вы вернетесь к списку. Напротив нового аккаунта нажмите на три точки и выберите «Назначить роль». Назначьте ему роль ai.languageModels.user. Это даст ему право обращаться к YandexGPT.
  5. Снова вернитесь к списку сервисных аккаунтов, нажмите на имя вашего нового аккаунта (n8n-integrator).
  6. Вверху вы увидите кнопку «Создать новый ключ». Нажмите ее и выберите «Создать API-ключ».
  7. Дайте ключу любое описание (например, «ключ для n8n») и нажмите «Создать».
  8. Появится окно с ID ключа и секретным ключом. Обязательно скопируйте и немедленно сохраните «Секретный ключ». Он отображается только один раз и больше вы его не увидите.
Подготовительный этап завершен. У вас есть ID каталога и секретный API-ключ.

Часть 2: Настройка сценария в n8n

Теперь создадим сценарий, который отправляет запрос к YandexGPT.
  1. В n8n создайте новый рабочий процесс. Вы можете использовать любой триггер.
  2. Добавьте на холст узел «HTTP Request».
  3. Откройте настройки этого узла и заполните поля следующим образом:
  • Method: POST
  • URL: https://llm.api.cloud.yandex.net/foundationModels/v1/completion
  • Authentication: Header Auth
  • В появившемся разделе "Name" введите: Authorization
  • В поле "Value" введите Api-Key (с пробелом после него) и вставьте ваш секретный API-ключ. Должно получиться так: Api-Key ВАШ_СЕКРЕТНЫЙ_КЛЮЧ
  • Body Content Type: JSON
  • Body: В это поле нужно вставить JSON-объект с вашим запросом. Вот базовый шаблон:
  • JSON

{
"modelUri": "gpt://ВАШ_ID_КАТАЛОГА/yandexgpt-lite",
"completionOptions": {
"stream": false,
"temperature": 0.6,
"maxTokens": "2000"
},
"messages": [
{
"role": "system",
"text": "Ты — полезный ассистент, который пишет краткие и информативные ответы."
},
{
"role": "user",
"text": "Напиши рекламный пост для Telegram о поступлении новой коллекции летних платьев."
}
]
}

Важные моменты в настройке Body:

  • В строке "modelUri" замените ВАШ_ID_КАТАЛОГА на тот ID, который вы скопировали на первом шаге. Модель yandexgpt-lite — самая быстрая и дешевая, для более сложных задач можно использовать yandexgpt.
  • В поле "text" у роли "user" вы можете вставить любой ваш запрос. Чтобы использовать данные из предыдущих узлов n8n, просто перетащите их в это поле с помощью конструктора выражений.
  • В поле "text" у роли "system" вы задаете общее поведение для нейросети.
Нажмите "Execute Node", чтобы протестировать запрос. Если все настроено правильно, в ответе вы получите сгенерированный нейросетью текст.

Итог

Интеграция с YandexGPT в n8n состоит из двух ключевых шагов: получение ID каталога и API-ключа в консоли Yandex.Cloud и правильная настройка узла HTTP Request в вашем сценарии. Освоив этот процесс, вы сможете встраивать одну из самых мощных русскоязычных нейросетей в любую точку вашей бизнес-автоматизации.
N8N