n8n 커넥터
n8n용 Entity Enricher 커뮤니티 노드를 사용하면 시각적 드래그 앤 드롭 편집기로 자동화된 강화 파이프라인을 구축할 수 있습니다. 코드를 작성하지 않고도 400개 이상의 앱에 연결하세요.
설치
n8n 인스턴스에 커뮤니티 노드를 설치합니다:
npm install n8n-nodes-entity-enricher
또는 n8n UI를 통해 설치하세요. Settings → Community Nodes로 이동하여 n8n-nodes-entity-enricher를 검색하세요.
사전 요구 사항
ent_XXXXXXXXXXXX입니다.https://entityenricher.ai 또는 자체 호스팅 URL).사용 가능한 작업
이 커넥터는 7개 리소스 범주에 걸쳐 18개 작업을 제공합니다:
| 리소스 | 작업 | 설명 |
|---|---|---|
| Enrichment | Enrich Entity | 단일 엔티티를 보강합니다 — 스키마만 선택하면 조직의 최적 모델과 전략이 자동으로 선택됩니다. SSE를 통해 실시간 진행 상황과 함께 결과를 스트리밍합니다. |
| Enrichment | Enrich Entity Advanced | 모델, 융합, 전략, 분류, 구조화된 출력을 완전히 제어하면서 단일 엔티티를 보강합니다. |
| Enrichment | Batch Enrich | 자동 모델과 전략으로 모든 입력 항목을 단일 배치로 보강합니다. 엔티티별 진행 상황 추적과 함께 병렬로 처리합니다. |
| Enrichment | Batch Enrich Advanced | 전체 매개변수 집합으로 모든 입력 항목을 단일 배치로 보강합니다. |
| Schema | List Schemas | 보강 워크플로에서 선택할 수 있도록 저장된 스키마를 나열합니다. |
| Schema | Get Schema Details | 특정 schema의 추출된 주요 속성과 함께 전체 schema 내용을 조회합니다. |
| Schema | Generate Sample | 하나의 작업에서 단일 엔티티 유형의 현실적인 샘플 JSON 객체를 1..N개 생성합니다. 스키마 작성 루프의 시작점입니다. 언어는 기본값이 auto이며, 사용자가 입력한 요청의 어휘에서 추론됩니다. |
| Schema | Generate Schema | JSON 스키마를 생성하고 자동 저장합니다. 입력 항목은 모두 동일한 엔티티 유형의 샘플이며, 필드는 합집합으로 구성되고, 일부 샘플에 없는 필드는 nullable로 표시되며, 실제 관측된 값이 예시로 사용됩니다. Language 옵션으로 스키마가 자기 자신을 설명하는 언어를 지정합니다. |
| Record | List Records | 유형 및 성공 필터로 강화 레코드를 조회합니다. 결과는 페이지로 나뉩니다. |
| Record | Get Record | 전체 구조화 출력과 함께 ID로 특정 enrichment 결과를 조회합니다. |
| Record | Sync Records to Database | 저장된(또는 변환된) 보강 결과를 해당 스키마의 데이터베이스 동기화로 전송합니다 — 게시된 계약에 따라 다시 검증한 뒤 승인 게이트를 거칩니다. |
| Fusion | Merge Results | 여러 강화 레코드의 결과를 선택적 LLM 중재와 함께 융합합니다. |
| Attachment | Add Attachment | 입력 항목의 바이너리 파일을 하나 이상 업로드하고(단일 multipart 요청) 첨부 파일 ID마다 항목 하나를 반환합니다. |
| Attachment | Delete Attachment | ID로 첨부 파일을 삭제합니다 — 강화 후 유용한 정리 단계입니다. |
| Database Sync | List Database Syncs | schema에 등록된 database sync 목록을 대기 중인 델타 수와 함께 나열합니다. |
| Database Sync | Fetch Deltas | 데이터베이스 델타의 다음 FIFO 윈도우(SQL + JSON)를 가져오며, 선택적으로 확인 처리를 위해 리스할 수 있습니다. |
| Database Sync | Acknowledge Deltas | 특정 ID까지 적용된 델타를 확인 처리합니다 — 리스를 해제하고, sync 옵션에 따라 전달된 사본을 삭제합니다. |
| Configuration | Get Options | 동적 구성을 위해 사용 가능한 모델, 언어, 전략 및 요금제 한도를 가져옵니다. |
트리거 노드
이 패키지에는 별도의 Entity Enricher Trigger 노드도 포함되어 있습니다 — schema 이벤트 발생 시 워크플로를 시작하고 구독을 자동으로 등록하는 웹훅 트리거입니다:
Database Sync 작업과 함께 이 트리거는 n8n만으로 외부 데이터베이스를 수렴 상태로 유지합니다 — Database Sync 문서를 참조하세요.
단일 엔티티 보강
가장 간단한 워크플로: 새 데이터로 트리거하고, 단일 엔터티를 보강한 후, 결과를 대상으로 전송합니다. 이 노드는 전체 보강이 완료될 때까지 기다린 후 구조화된 출력을 다운스트림으로 전달합니다.
예시 워크플로 — 단일 엔티티 강화:
노드 구성 — 엔터티 보강 작업:
구성
기본 Enrich Entity 및 Batch Enrich 작업은 필수 항목만 표시합니다: 스키마, 파일 업로드, 언어, 웹 검색. Entity Enricher는 조직의 최적 모델 — 고정된 기본값 또는 벤치마크 점수가 가장 높은 모델 — 로 자동 실행되며 스키마에 따라 보강 전략을 선택합니다. Enrich Entity Advanced 및 Batch Enrich Advanced 작업은 아래의 전체 옵션 집합을 제공합니다.
동적 드롭다운에서 스키마를 선택하고, 하나 이상의 모델을 선택한 뒤, 엔티티 데이터를 키-값 필드로 입력하세요. 노드는 선택한 스키마에 따라 검색 키 필드를 자동으로 채웁니다.
선택적 설정에는 strategy(single-pass 또는 multi-expertise), 다국어 출력을 위한 언어, entity 유형 확인을 위한 classification model, 다중 model 충돌 해결을 위한 arbitration model, 그리고 지원되는 model에서 schema에 부합하는 출력을 강제하는 응답 schema / 엄격한 구조화 출력 토글이 포함됩니다.
소스 문서를 enrichment에 공급하려면 Upload Input Binary Files를 켜세요. 이 노드는 입력 항목의 바이너리 파일을 단일 요청으로 attachment로 업로드하며(전체 또는 Binary Fields to Upload에 지정된 파일만), Delete Uploaded Attachments After Enrichment(기본값 켜짐)를 사용하면 enrichment가 끝난 후 이를 정리합니다. 별도의 Add Attachment / Delete Attachment 단계는 필요하지 않습니다. 또는 Attachment IDs 필드(이전 Add Attachment 호출에서 얻은 쉼표로 구분된 UUID)를 제공하면 한 번 업로드한 문서를 여러 enrichment에서 재사용할 수 있으며, 두 소스를 함께 사용할 수도 있습니다. Batch Enrich에서도 사용할 수 있는데, 이 경우 파일은 모든 입력 항목에서 수집되어 작업의 모든 entity에 적용됩니다. 파일 소스와 enrich 노드 사이에 Edit Fields 노드가 있으면 해당 노드의 Include Other Input Fields 스위치를 켜세요. 그렇지 않으면 바이너리 데이터가 제거됩니다.
배치 보강
모든 입력 항목을 단일 배치로 처리합니다. 스프레드시트, 데이터베이스 또는 API 응답의 목록을 보강하는 데 이상적입니다. 모든 엔터티가 제공자별 속도 제한과 함께 병렬로 처리됩니다.
노드 구성 — 배치 보강 작업:
배치 모드 작동 방식
- 항목 수집 — 이 노드는 이전 노드의 모든 입력 항목(예: 스프레드시트의 행)을 수집합니다.
- batch 작업 시작 — 모든 entity는
POST /api/batch/start를 통해 제출되어 병렬로 처리됩니다. - 진행 상황 스트리밍 — 노드는 모든 entity가 완료되거나 시간 초과에 도달할 때까지 SSE 스트림을 소비합니다.
- 결과 출력 — 엔터티당 하나의 출력 항목에 보강된 구조화 데이터가 담겨 후속 처리에 바로 사용할 수 있습니다.
주요 특징
간단 및 고급 작업
기본 Enrich Entity 및 Batch Enrich 작업은 스키마, 파일 업로드, 언어, 웹 검색만 표시합니다 — 최적 모델과 전략은 자동으로 선택됩니다. Advanced 작업은 모델, 융합, 전략, 구조화된 출력을 완전히 제어할 수 있게 합니다.
동적 드롭다운
스키마, 모델, 언어, 전략 선택기는 구성 시점에 사용자의 Entity Enricher 인스턴스에서 옵션을 가져옵니다.
SSE 스트리밍
보강 작업은 SSE 스트림을 실시간으로 소비하며, 완료를 기다린 후 다음 노드로 결과를 반환합니다.
자동 계속
사전 분류에서 불일치가 감지되면 커넥터가 자동으로 계속 진행합니다(n8n 워크플로는 비대화형입니다).
구성 가능한 시간 초과
강화 호출당 기본 300초 타임아웃이며, 대규모 스키마나 느린 모델의 경우 노드별로 조정할 수 있습니다.
다중 모델 지원
강화마다 여러 모델을 선택하세요. 2개 이상의 모델을 사용하면 결과가 자동으로 융합됩니다.
기본적으로 출력 정리
기본적으로 출력에는 보강된 데이터 필드만 포함됩니다. 비용, 토큰, 융합 세부 정보, 레코드 ID를 추가하려면 "보강 메타데이터 포함"을 켜세요.
모델별 출력
다운스트림 비교를 위해 fusion 결과와 함께 개별 model 결과를 선택적으로 출력합니다.
플랜 한도 인식
모델 및 언어 드롭다운은 설정된 경우 요금제 한도를 표시합니다. 할당량 적용으로 인한 HTTP 402 오류는 한도 세부 정보와 함께 명확하고 실행 가능한 메시지로 표시됩니다. 메타데이터 출력에는 다운스트림 라우팅을 위한 현재 요금제 한도가 포함됩니다.
AI 에이전트에서 사용하거나 예제로 시작하세요
AI 에이전트 도구
Entity Enricher 노드는 n8n AI Agent에 도구로 연결할 수 있어, 에이전트가 대화 도중 엔티티를 보강하거나 스키마를 가져올 시점을 스스로 판단합니다. 트리거 노드는 의도적으로 이 방식으로 제공하지 않습니다. 트리거는 워크플로를 시작하는 장치일 뿐 에이전트가 호출하는 대상이 아니기 때문입니다.
가져올 수 있는 워크플로 6종
이 패키지에는 미리 만들어진 워크플로 파일이 포함되어 있습니다. 단일 보강, 배치, 문서에서 보강, 이미지에서 샘플을 거쳐 스키마로, 샘플에서 스키마로, 그리고 델타 피드를 PostgreSQL로 내보내기입니다. 처음부터 구성하지 말고 하나를 가져온 뒤 자신의 자격 증명으로 바꿔 사용하세요.
워크플로우 아이디어
n8n으로 보강 파이프라인을 구축하는 일반적인 패턴: