Коннектор 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 при самостоятельном размещении).Доступные операции
Коннектор предоставляет 10 операций в 6 категориях ресурсов:
| Ресурс | Операция | Описание |
|---|---|---|
| Enrichment | Enrich Entity | Обогащение одной сущности с помощью одной или нескольких моделей ИИ. Потоковая передача результатов через SSE с прогрессом в реальном времени. |
| Enrichment | Batch Enrich | Обогащение всех входных элементов как единого пакета. Параллельная обработка с отслеживанием прогресса по каждой сущности. |
| Schema | List Schemas | Выводит список доступных сохранённых schemas для выбора в рабочих процессах enrichment. |
| Schema | Get Schema Details | Получить полное содержимое схемы с извлечёнными ключевыми свойствами для конкретной схемы. |
| Record | List Records | Запрашивайте записи обогащения с фильтрами по типу и успешности. Результаты с постраничной разбивкой. |
| Record | Get Record | Получить конкретный результат обогащения по ID с полным структурированным выводом. |
| Fusion | Merge Results | Объединяйте результаты нескольких записей обогащения с опциональным арбитражем LLM. |
| Attachment | Add Attachment | Загрузите бинарное свойство из входного элемента (multipart) и получите ID его вложения. |
| Attachment | Delete Attachment | Удалить вложение по ID — удобный шаг очистки после обогащения. |
| Configuration | Get Options | Получите доступные модели, языки, стратегии и лимиты плана для динамической конфигурации. |
Обогащение одной сущности
Самый простой рабочий процесс: срабатывание на новые данные, обогащение одной сущности и отправка результата в место назначения. Узел ждёт полного завершения обогащения, прежде чем передать структурированный вывод дальше.
Пример рабочего процесса — обогащение одной сущности:
Конфигурация узла — операция обогащения сущности:
Конфигурация
Выберите схему из динамического выпадающего списка, выберите одну или несколько моделей и укажите данные сущности в виде полей «ключ-значение». Узел автоматически заполняет поля ключей поиска на основе выбранной схемы.
Необязательные настройки включают стратегию (одинарный проход или несколько областей экспертизы), языки для многоязычного вывода, модель классификации для проверки типа сущности, модель арбитража для разрешения конфликтов между моделями и переключатели схемы ответа / строгого структурированного вывода, которые обеспечивают соответствие вывода схеме на поддерживающих это моделях.
Укажите поле Attachment IDs (UUID через запятую из предыдущих вызовов Add Attachment), чтобы передать исходные документы в обогащение — также доступно в Batch Enrich.
Пакетное обогащение
Обрабатывайте все входные элементы как единый batch. Идеально для enrichment списков из электронных таблиц, баз данных или ответов API. Все entity обрабатываются параллельно с ограничением частоты запросов для каждого provider.
Конфигурация узла — операция пакетного обогащения:
Как работает пакетный режим
- Сбор элементов — Узел собирает все входные элементы из предыдущего узла (например, строки из таблицы).
- Запуск пакетного задания — Все сущности отправляются через
POST /api/batch/startи обрабатываются параллельно. - Потоковый прогресс — Узел читает поток SSE, пока все сущности не будут обработаны или не истечёт тайм-аут.
- Результаты вывода — Один выходной элемент на сущность с обогащёнными структурированными данными, готовыми к дальнейшей обработке.
Ключевые функции
Динамические выпадающие списки
Селекторы схемы, модели, языка и стратегии получают параметры из вашего экземпляра Entity Enricher во время настройки.
Потоковая передача SSE
Операции обогащения потребляют поток SSE в реальном времени, ожидая завершения перед передачей результатов следующему узлу.
Автопродолжение
Когда предварительная классификация обнаруживает несоответствие, коннектор автоматически продолжает работу (рабочие процессы n8n неинтерактивны).
Настраиваемый тайм-аут
Тайм-аут по умолчанию 300 секунд на вызов обогащения, настраиваемый для каждого узла для больших схем или медленных моделей.
Поддержка нескольких моделей
Выбирайте несколько моделей для каждого обогащения. При использовании 2+ моделей результаты автоматически объединяются (слияние).
Очищать вывод по умолчанию
По умолчанию вывод содержит только обогащённые поля данных. Включите «Включить метаданные обогащения», чтобы добавить стоимость, токены, детали слияния и идентификаторы записей.
Вывод по каждой модели
При желании выводить результаты отдельных моделей вместе с результатом слияния для последующего сравнения.
Учёт лимитов плана
Выпадающие списки моделей и языков отображают лимиты плана, если они настроены. Ошибки HTTP 402, связанные с контролем квот, отображаются в виде понятных, полезных сообщений с деталями лимитов. Вывод метаданных включает текущие лимиты плана для последующей маршрутизации.
Идеи рабочих процессов
Типичные паттерны построения конвейеров обогащения с n8n: