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).사용 가능한 작업
커넥터는 6개 리소스 범주에 걸쳐 10개의 작업을 노출합니다:
| 리소스 | 작업 | 설명 |
|---|---|---|
| Enrichment | Enrich Entity | 하나 이상의 AI 모델로 단일 엔터티를 보강합니다. SSE를 통해 실시간 진행 상황과 함께 결과를 스트리밍합니다. |
| Enrichment | Batch Enrich | 모든 입력 항목을 단일 배치로 보강합니다. 엔터티별 진행 상황 추적과 함께 병렬 처리합니다. |
| Schema | List Schemas | 보강 워크플로에서 선택할 수 있도록 저장된 스키마를 나열합니다. |
| Schema | Get Schema Details | 특정 schema의 추출된 주요 속성과 함께 전체 schema 내용을 조회합니다. |
| Record | List Records | 유형 및 성공 필터로 강화 레코드를 조회합니다. 결과는 페이지로 나뉩니다. |
| Record | Get Record | 전체 구조화 출력과 함께 ID로 특정 enrichment 결과를 조회합니다. |
| Fusion | Merge Results | 여러 강화 레코드의 결과를 선택적 LLM 중재와 함께 융합합니다. |
| Attachment | Add Attachment | 입력 항목의 바이너리 속성(multipart)을 업로드하고 해당 첨부 파일 ID를 반환합니다. |
| Attachment | Delete Attachment | ID로 첨부 파일을 삭제합니다 — 강화 후 유용한 정리 단계입니다. |
| Configuration | Get Options | 동적 구성을 위해 사용 가능한 모델, 언어, 전략 및 요금제 한도를 가져옵니다. |
단일 엔티티 보강
가장 간단한 워크플로: 새 데이터로 트리거하고, 단일 엔터티를 보강한 후, 결과를 대상으로 전송합니다. 이 노드는 전체 보강이 완료될 때까지 기다린 후 구조화된 출력을 다운스트림으로 전달합니다.
예시 워크플로 — 단일 엔티티 강화:
노드 구성 — 엔터티 보강 작업:
구성
동적 드롭다운에서 스키마를 선택하고, 하나 이상의 모델을 선택한 뒤, 엔티티 데이터를 키-값 필드로 입력하세요. 노드는 선택한 스키마에 따라 검색 키 필드를 자동으로 채웁니다.
선택적 설정에는 strategy(single-pass 또는 multi-expertise), 다국어 출력을 위한 언어, entity 유형 확인을 위한 classification model, 다중 model 충돌 해결을 위한 arbitration model, 그리고 지원되는 model에서 schema에 부합하는 출력을 강제하는 응답 schema / 엄격한 구조화 출력 토글이 포함됩니다.
소스 문서를 보강에 제공하려면 Attachment IDs 필드(이전 Add Attachment 호출에서 생성된 쉼표로 구분된 UUID)를 입력하세요 — Batch Enrich에서도 사용할 수 있습니다.
배치 보강
모든 입력 항목을 단일 배치로 처리합니다. 스프레드시트, 데이터베이스 또는 API 응답의 목록을 보강하는 데 이상적입니다. 모든 엔터티가 제공자별 속도 제한과 함께 병렬로 처리됩니다.
노드 구성 — 배치 보강 작업:
배치 모드 작동 방식
- 항목 수집 — 이 노드는 이전 노드의 모든 입력 항목(예: 스프레드시트의 행)을 수집합니다.
- batch 작업 시작 — 모든 entity는
POST /api/batch/start를 통해 제출되어 병렬로 처리됩니다. - 진행 상황 스트리밍 — 노드는 모든 entity가 완료되거나 시간 초과에 도달할 때까지 SSE 스트림을 소비합니다.
- 결과 출력 — 엔터티당 하나의 출력 항목에 보강된 구조화 데이터가 담겨 후속 처리에 바로 사용할 수 있습니다.
주요 특징
동적 드롭다운
스키마, 모델, 언어, 전략 선택기는 구성 시점에 사용자의 Entity Enricher 인스턴스에서 옵션을 가져옵니다.
SSE 스트리밍
보강 작업은 SSE 스트림을 실시간으로 소비하며, 완료를 기다린 후 다음 노드로 결과를 반환합니다.
자동 계속
사전 분류에서 불일치가 감지되면 커넥터가 자동으로 계속 진행합니다(n8n 워크플로는 비대화형입니다).
구성 가능한 시간 초과
강화 호출당 기본 300초 타임아웃이며, 대규모 스키마나 느린 모델의 경우 노드별로 조정할 수 있습니다.
다중 모델 지원
강화마다 여러 모델을 선택하세요. 2개 이상의 모델을 사용하면 결과가 자동으로 융합됩니다.
기본적으로 출력 정리
기본적으로 출력에는 보강된 데이터 필드만 포함됩니다. 비용, 토큰, 융합 세부 정보, 레코드 ID를 추가하려면 "보강 메타데이터 포함"을 켜세요.
모델별 출력
다운스트림 비교를 위해 fusion 결과와 함께 개별 model 결과를 선택적으로 출력합니다.
플랜 한도 인식
모델 및 언어 드롭다운은 설정된 경우 요금제 한도를 표시합니다. 할당량 적용으로 인한 HTTP 402 오류는 한도 세부 정보와 함께 명확하고 실행 가능한 메시지로 표시됩니다. 메타데이터 출력에는 다운스트림 라우팅을 위한 현재 요금제 한도가 포함됩니다.
워크플로우 아이디어
n8n으로 보강 파이프라인을 구축하는 일반적인 패턴: