Обновление нод для Yandex Cloud в n8n

Несколько месяцев назад я анонсировал пакет нод для Yandex Cloud в n8n, и он получил отличный отклик от сообщества. С тех пор проект значительно вырос: пакет @nikolaymatrosov/n8n-nodes-yc обновился с 10 до 18 нод, добавив поддержку критически важных сервисов Yandex Cloud. Помимо новых возможностей, все существующие ноды получили улучшенную систему обработки ошибок для повышения надёжности.

Версия v0.9.2 привносит 8 новых нод и комплексные улучшения, делающие работу с Yandex Cloud в n8n ещё удобнее и надёжнее.

Новые возможности: 8 нод расширяют горизонты

Yandex Cloud YDB — распределённая SQL-база данных

Нода YDB (появилась в v0.5.0) открывает доступ к мощной распределённой базе данных с автоматическим горизонтальным масштабированием. Она позволяет выполнять YQL (Yandex Query Language) запросы прямо из n8n workflow с поддержкой параметризованных запросов для безопасности и автоматическим преобразованием типов между JavaScript и YDB.

Практическое применение:

• Аналитические запросы в реальном времени для дашбордов
• CRUD операции с пользовательскими данными
• ETL-процессы для трансформации данных
• Транзакционные нагрузки с сильной согласованностью

Уникальная особенность: YDB использует двойную аутентификацию — yandexCloudAuthorizedApi для service account и отдельный yandexCloudYdbApi для параметров подключения (Endpoint и Database). Это позволяет легко переключаться между базами, не меняя аутентификацию.

Yandex Cloud Search — веб-поиск и AI-генеративный поиск

Нода Search (v0.6.0) даёт доступ к двум мощным возможностям:

Веб-поиск с традиционной фильтрацией, сортировкой по релевантности или времени, группировкой результатов и гибкой локализацией.

Генеративный поиск использует AI для создания естественноязыковых ответов на основе результатов поиска с атрибуцией источников. Поддерживает диалоги (multi-message conversations) и потоковую передачу ответов для прогрессивного отображения.

Практическое применение:

• Создание поисковых приложений и интеграций
• AI-ассистенты с доступом к актуальным веб-знаниям
• Исследовательские инструменты для анализа информации
• Системы обнаружения и мониторинга контента

Yandex Cloud Vision OCR — распознавание текста на изображениях

Нода Vision OCR (v0.7.0) предоставляет мощные возможности оптического распознавания текста (OCR) на основе Yandex Cloud Vision. Поддерживает работу с изображениями в форматах JPEG, PNG и PDF (до 10MB) и может распознавать текст на более чем 50 языках. Нода предлагает различные модели распознавания, включая Page, Table, Markdown, Math Markdown и Handwritten, а также шаблонное распознавание документов, таких как паспорта, водительские удостоверения и номера машин.

Практическое применение:

• Оцифровка документов
• Обработка счетов и чеков
• Извлечение данных из удостоверений личности
• Распознавание номерных знаков

Yandex Cloud Logging — централизованное управление логами

Нода Logging (v0.8.0) обеспечивает комплексное управление логами через Yandex Cloud Logging. Поддерживает запись и чтение логов с уровнями от TRACE до FATAL, структурированное логирование с JSON-данными, фильтрацию по времени, уровням, ресурсам и потокам, а также автоматическую пагинацию для больших объёмов данных.

Практическое применение:

• Централизованное логирование микросервисной архитектуры
• Мониторинг приложений с оповещениями об ошибках
• Аудит действий для соответствия compliance требованиям
• Быстрое устранение неполадок через поиск по логам

Yandex Cloud YandexART — AI-генерация изображений

Нода YandexART (v0.9.0) открывает доступ к нейросетевой генерации изображений из текстовых описаний. Поддерживает негативные промпты для исключения нежелательных элементов, выбор соотношения сторон (от квадрата 1:1 до портрета 9:21), форматы JPEG и PNG, а также воспроизводимость результатов через seed.

Нода автоматически обрабатывает асинхронные операции с опросом до завершения, возвращая готовое изображение как бинарные данные.

Практическое применение:

• Создание уникального маркетингового контента
• Быстрые иллюстрации для блогов и статей
• Визуальный контент для социальных сетей
• Прототипирование дизайн-концептов

Yandex Cloud SpeechKit STT — распознавание речи

Нода SpeechKit STT обеспечивает асинхронную транскрибацию аудио с поддержкой 16+ языков и автоматическим определением языка. Работает с форматами LPCM, OGG Opus и MP3, автоматически опрашивает результаты до завершения и предлагает фильтрацию нецензурной лексики.

Практическое применение:

• Транскрибация деловых встреч и звонков
• Голосовые интерфейсы для приложений
• Автоматическая генерация субтитров
• Аналитика качества обслуживания в call-центрах

Yandex Cloud Translate — машинный перевод

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

Практическое применение:

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

Yandex Cloud Foundation Models — прямой доступ к YandexGPT

Нода Foundation Models представляет собой обновлённую и упрощённую версию прежней ноды Yandex Cloud GPT. Теперь с единой системой версионирования вместо нескольких версий, она предоставляет прямой REST API доступ к YandexGPT и работает как обычная трансформационная нода (в отличие от Chat Model, которая интегрируется с LangChain для AI-цепочек и агентов).

Улучшения существующих нод

Комплексная система обработки ошибок SDK

Все ноды, использующие Yandex Cloud SDK, получили значительное обновление системы обработки ошибок. Введён новый класс YandexCloudSdkError для единообразного представления ошибок, автоматическое извлечение RequestId и ServerTraceId для упрощения отладки саппортом Yandex Cloud. Если вы столкнётесь с ошибкой API, вы можете скопировать идентификаторы и приложить их в обращение в саппорт.

Улучшения YandexART: автоматическая обрезка промптов

API YandexART имеет ограничение в 500 символов для промпта. Раньше превышение этого лимита приводило к ошибке и остановке workflow. Теперь нода автоматически обрезает промпт до допустимой длины и показывает предупреждение пользователю, что промпт был обрезан. Workflow продолжает работать, а вы получаете прозрачную обратную связь и можете скорректировать промпт при необходимости.

Обновлённая система аутентификации

С добавлением YDB в пакет появился новый тип credentials — yandexCloudYdbApi, содержащий только параметры подключения (Endpoint и Database). Он используется в паре с yandexCloudAuthorizedApi (Service Account JSON), что разделяет аутентификацию и параметры подключения. Это делает переключение между базами данных максимально удобным.

Теперь пакет поддерживает четыре типа credentials:

1. yandexCloudYdbApi — параметры подключения к YDB
2. yandexCloudGptApi — API ключ для Foundation Models
3. yandexCloudStaticApi — статические ключи для S3-совместимых сервисов
4. yandexCloudAuthorizedApi — Service Account JSON для сервисов с IAM-токенами

Как обновиться

Обновление полностью обратно совместимо. Все существующие workflow продолжат работать без изменений.

Для обновления через npm:

npm update @nikolaymatrosov/n8n-nodes-yc

Для обновления через UI n8n: Перейдите в Settings → Community Packages и нажмите "Update" рядом с пакетом @nikolaymatrosov/n8n-nodes-yc.

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

Что дальше

Актуальную информацию и полную документацию вы всегда найдёте в GitHub репозитории. Если у вас есть предложения по улучшению или вы нашли баг, создайте Issue.

к сведению

Если вам понравился пакет и вы хотите поддержать дальнейшую разработку, буду рад вашим звёздам на GitHub