Коннектор n8n
Узел сообщества Entity Enricher для n8n позволяет создавать автоматизированные конвейеры обогащения с визуальным редактором drag-and-drop. Подключайтесь к более чем 400 приложениям без написания кода.
Установка
Установите community-узел в вашем экземпляре n8n:
npm install n8n-nodes-entity-enricher
Или установите через интерфейс n8n: перейдите в Settings → Community Nodes и найдите n8n-nodes-entity-enricher.
Предварительные требования
ent_XXXXXXXXXXXX.https://entityenricher.ai или ваш URL при самостоятельном размещении).Доступные операции
Коннектор предоставляет 18 операций в 7 категориях ресурсов:
| Ресурс | Операция | Описание |
|---|---|---|
| Enrichment | Enrich Entity | Обогащение одной сущности — просто выберите схему; лучшая модель и стратегия вашей организации выбираются автоматически. Результаты передаются через SSE с прогрессом в реальном времени. |
| Enrichment | Enrich Entity Advanced | Обогащение одной сущности с полным контролем над моделями, слиянием, стратегией, классификацией и структурированным выводом. |
| Enrichment | Batch Enrich | Обогащение всех входных элементов одним пакетом с автоматическим выбором модели и стратегии. Параллельная обработка с отслеживанием прогресса по каждой сущности. |
| Enrichment | Batch Enrich Advanced | Обогащение всех входных элементов одним пакетом с полным набором параметров. |
| Schema | List Schemas | Выводит список доступных сохранённых schemas для выбора в рабочих процессах enrichment. |
| Schema | Get Schema Details | Получить полное содержимое схемы с извлечёнными ключевыми свойствами для конкретной схемы. |
| Schema | Generate Sample | Сгенерируйте от 1 до N реалистичных JSON-примеров одного типа сущности за одно задание — точка входа в цикл создания схемы. Язык по умолчанию — auto: он определяется по словам вашего запроса. |
| Schema | Generate Schema | Сгенерировать и автоматически сохранить JSON-схему — каждый входной элемент является примером одного и того же типа сущности: объединение полей, nullable там, где поле отсутствует в части примеров, реальные наблюдаемые значения в качестве примеров. Параметр «Язык» задаёт язык, на котором схема описывает саму себя. |
| Record | List Records | Запрашивайте записи обогащения с фильтрами по типу и успешности. Результаты с постраничной разбивкой. |
| Record | Get Record | Получить конкретный результат обогащения по ID с полным структурированным выводом. |
| Record | Sync Records to Database | Отправьте сохранённый (или преобразованный) результат обогащения в синхронизацию базы данных его схемы — он повторно проверяется по опубликованному контракту, а затем проходит через шлюз допуска. |
| Fusion | Merge Results | Объединяйте результаты нескольких записей обогащения с опциональным арбитражем LLM. |
| Attachment | Add Attachment | Загружает один или несколько бинарных файлов из входного элемента (одним multipart-запросом) и возвращает по одному элементу на каждый ID вложения. |
| Attachment | Delete Attachment | Удалить вложение по ID — удобный шаг очистки после обогащения. |
| Database Sync | List Database Syncs | Список database sync, зарегистрированных для схемы, с количеством ожидающих дельт. |
| Database Sync | Fetch Deltas | Получите следующее FIFO-окно дельт базы данных (SQL + JSON), при необходимости арендуя их для подтверждения. |
| Database Sync | Acknowledge Deltas | Подтвердите применённые дельты вплоть до указанного ID — освобождает аренду (lease) и, согласно настройкам синхронизации, удаляет доставленные копии. |
| Configuration | Get Options | Получите доступные модели, языки, стратегии и лимиты плана для динамической конфигурации. |
Узел-триггер
В пакет также входит отдельный узел Entity Enricher Trigger — webhook-триггер, запускающий рабочий процесс при событиях схемы и автоматически регистрирующий свою подписку:
Вместе с операциями Database Sync триггер поддерживает синхронизацию внешней базы данных силами одного n8n — см. документацию по Database Sync.
Обогащение одной сущности
Самый простой рабочий процесс: срабатывание на новые данные, обогащение одной сущности и отправка результата в место назначения. Узел ждёт полного завершения обогащения, прежде чем передать структурированный вывод дальше.
Пример рабочего процесса — обогащение одной сущности:
Конфигурация узла — операция обогащения сущности:
Конфигурация
По умолчанию операции Enrich Entity и Batch Enrich показывают только самое необходимое: схему, загрузку файла, языки и веб-поиск. Entity Enricher автоматически работает с лучшей моделью вашей организации — вашей закреплённой моделью по умолчанию или моделью с наивысшей оценкой по бенчмаркам — и выбирает стратегию обогащения на основе вашей схемы. Операции Enrich Entity Advanced и Batch Enrich Advanced открывают полный набор опций, приведённых ниже.
Выберите схему из динамического выпадающего списка, выберите одну или несколько моделей и укажите данные сущности в виде полей «ключ-значение». Узел автоматически заполняет поля ключей поиска на основе выбранной схемы.
Необязательные настройки включают стратегию (одинарный проход или несколько областей экспертизы), языки для многоязычного вывода, модель классификации для проверки типа сущности, модель арбитража для разрешения конфликтов между моделями и переключатели схемы ответа / строгого структурированного вывода, которые обеспечивают соответствие вывода схеме на поддерживающих это моделях.
Чтобы передать исходные документы в обогащение, включите Upload Input Binary Files: узел загружает бинарные файлы входного элемента как вложения одним запросом (все либо только указанные в Binary Fields to Upload) и при включённом Delete Uploaded Attachments After Enrichment (по умолчанию включено) удаляет их после завершения обогащения — отдельные шаги Add Attachment / Delete Attachment не нужны. Как вариант, укажите поле Attachment IDs (UUID через запятую из предыдущих вызовов Add Attachment), чтобы повторно использовать однажды загруженные документы во многих обогащениях; оба источника можно комбинировать. Также доступно в Batch Enrich, где файлы собираются из всех входных элементов и применяются к каждой сущности в задании. Если между источником файлов и узлом обогащения находится узел Edit Fields, включите его переключатель Include Other Input Fields — иначе он удалит бинарные данные.
Пакетное обогащение
Обрабатывайте все входные элементы как единый batch. Идеально для enrichment списков из электронных таблиц, баз данных или ответов API. Все entity обрабатываются параллельно с ограничением частоты запросов для каждого provider.
Конфигурация узла — операция пакетного обогащения:
Как работает пакетный режим
- Сбор элементов — Узел собирает все входные элементы из предыдущего узла (например, строки из таблицы).
- Запуск пакетного задания — Все сущности отправляются через
POST /api/batch/startи обрабатываются параллельно. - Потоковый прогресс — Узел читает поток SSE, пока все сущности не будут обработаны или не истечёт тайм-аут.
- Результаты вывода — Один выходной элемент на сущность с обогащёнными структурированными данными, готовыми к дальнейшей обработке.
Ключевые функции
Простые и расширенные операции
Операции Enrich Entity и Batch Enrich по умолчанию показывают только схему, загрузку файла, языки и веб-поиск — лучшая модель и стратегия выбираются автоматически. Расширенные операции дают полный контроль над моделями, слиянием, стратегией и структурированным выводом.
Динамические выпадающие списки
Селекторы схемы, модели, языка и стратегии получают параметры из вашего экземпляра Entity Enricher во время настройки.
Потоковая передача SSE
Операции обогащения потребляют поток SSE в реальном времени, ожидая завершения перед передачей результатов следующему узлу.
Автопродолжение
Когда предварительная классификация обнаруживает несоответствие, коннектор автоматически продолжает работу (рабочие процессы n8n неинтерактивны).
Настраиваемый тайм-аут
Тайм-аут по умолчанию 300 секунд на вызов обогащения, настраиваемый для каждого узла для больших схем или медленных моделей.
Поддержка нескольких моделей
Выбирайте несколько моделей для каждого обогащения. При использовании 2+ моделей результаты автоматически объединяются (слияние).
Очищать вывод по умолчанию
По умолчанию вывод содержит только обогащённые поля данных. Включите «Включить метаданные обогащения», чтобы добавить стоимость, токены, детали слияния и идентификаторы записей.
Вывод по каждой модели
При желании выводить результаты отдельных моделей вместе с результатом слияния для последующего сравнения.
Учёт лимитов плана
Выпадающие списки моделей и языков отображают лимиты плана, если они настроены. Ошибки HTTP 402, связанные с контролем квот, отображаются в виде понятных, полезных сообщений с деталями лимитов. Вывод метаданных включает текущие лимиты плана для последующей маршрутизации.
Используйте из AI-агента или начните с примера
Инструмент для AI-агента
Узел Entity Enricher можно подключить к AI Agent в n8n как инструмент, чтобы агент сам решал, когда обогатить сущность или получить схему по ходу диалога. Триггерный узел намеренно так не предлагается: триггер запускает рабочий процесс, а не вызывается агентом.
Шесть рабочих процессов, готовых к импорту
Пакет содержит готовые файлы рабочих процессов: одиночное обогащение, пакетное, документ → обогащение, изображение → образец → схема, образцы → схема и вычитывание потока изменений в PostgreSQL. Импортируйте нужный и подставьте свои учётные данные вместо того, чтобы собирать всё с нуля.
Идеи рабочих процессов
Типичные паттерны построения конвейеров обогащения с n8n: