Узел сообщества 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 — вебхук-триггер, который запускает рабочий процесс при любом событии платформы и автоматически регистрирует подписку. Список в поле Event загружается напрямую из вашего аккаунта, поэтому все события платформы доступны без обновления ноды:
Каждая доставка подписывается: заголовок X-EE-Signature содержит HMAC-SHA256 от тела с меткой времени, а X-EE-Delivery не меняется при повторных попытках, поэтому его можно использовать как ключ идемпотентности. Неудачные доставки повторяются три раза в течение получаса. Эндпоинты можно зарегистрировать и вручную — без коннектора — в разделе «Настройки › Вебхуки», где журнал доставок показывает каждую попытку и позволяет повторить её.
Вместе с операциями 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 и обрабатываются параллельно.Операции Enrich Entity и Batch Enrich по умолчанию показывают только схему, загрузку файла, языки и веб-поиск — лучшая модель и стратегия выбираются автоматически. Расширенные операции дают полный контроль над моделями, слиянием, стратегией и структурированным выводом.
Селекторы схемы, модели, языка и стратегии получают параметры из вашего экземпляра Entity Enricher во время настройки.
Операции обогащения потребляют поток SSE в реальном времени, ожидая завершения перед передачей результатов следующему узлу.
Когда предварительная классификация обнаруживает несоответствие, коннектор автоматически продолжает работу (рабочие процессы n8n неинтерактивны).
Тайм-аут по умолчанию 300 секунд на вызов обогащения, настраиваемый для каждого узла для больших схем или медленных моделей.
Выбирайте несколько моделей для каждого обогащения. При использовании 2+ моделей результаты автоматически объединяются (слияние).
По умолчанию вывод содержит только обогащённые поля данных. Включите «Включить метаданные обогащения», чтобы добавить стоимость, токены, детали слияния и идентификаторы записей.
При желании выводить результаты отдельных моделей вместе с результатом слияния для последующего сравнения.
Выпадающие списки моделей и языков отображают лимиты плана, если они настроены. Ошибки HTTP 402, связанные с контролем квот, отображаются в виде понятных, полезных сообщений с деталями лимитов. Вывод метаданных включает текущие лимиты плана для последующей маршрутизации.
Узел Entity Enricher можно подключить к AI Agent в n8n как инструмент, чтобы агент сам решал, когда обогатить сущность или получить схему по ходу диалога. Триггерный узел намеренно так не предлагается: триггер запускает рабочий процесс, а не вызывается агентом.
Пакет содержит готовые файлы рабочих процессов: одиночное обогащение, пакетное, документ → обогащение, изображение → образец → схема, образцы → схема и вычитывание потока изменений в PostgreSQL. Импортируйте нужный и подставьте свои учётные данные вместо того, чтобы собирать всё с нуля.
Типичные паттерны построения конвейеров обогащения с n8n: