Make.com 커넥터 - Entity Enricher 문서

Make.com 커넥터

단일 Make 모듈을 원하는 scenario에 넣고 이전 단계의 entity를 매핑하면, 구조화되고 schema 검증을 거친 다중 model fusion JSON 객체를 받을 수 있습니다 — 단일 LLM 처리로 40개 언어의 다국어 출력을 생성합니다. Make의 작업당 과금 모델에 맞춰 설계된, 동적 드롭다운과 요금제 제한을 인식하는 오류 처리를 갖춘 9개의 최상위 모듈을 제공합니다.

Make를 위해 설계됨

Entity Enricher는 Server-Sent Events 스트림을 사용하는 n8n 커넥터를 이미 제공합니다. Make 모듈은 SSE를 기본적으로 사용할 수 없으며, 각 모듈은 하나의 원자적 HTTP 호출입니다. 강화를 단일 Make 작업으로 지원하기 위해 백엔드는 스트리밍 흐름을 서버 측에서 래핑하고 최종 융합 결과를 하나의 응답으로 반환하는 전용 POST /api/single/enrich/sync 엔드포인트를 제공합니다.

n8n connector
POST /enrich/stream → job_id
GET /llm/stream/{id}
GET /llm/stream/{id}
... (events)
[final bundle out]
Make.com connector
POST /enrich/sync
(server awaits internally)
[final bundle out]

한 번의 패스로 다국어 보강

Languages 필드에서 두 개 이상의 언어를 선택하면 Entity Enricher가 모든 다국어 속성을 단일 LLM 호출로 선택한 모든 언어에 채웁니다 — 언어마다 N번의 순차적 왕복 호출이 아닙니다. 40개 언어가 주요 유럽, 아시아, 중동, 아프리카 시장을 포괄합니다.

languages = ["en", "fr", "de", "ja"]로 Enrich Entity를 한 번 호출한 결과:

{
  "names": {
    "primary": {
      "en": "Aspirin",
      "fr": "Aspirine",
      "de": "Aspirin",
      "ja": "アスピリン"
    }
  },
  "indications": {
    "en": "Pain, fever, inflammation; antiplatelet therapy.",
    "fr": "Douleur, fièvre, inflammation ; antiagrégant plaquettaire.",
    "de": "Schmerz, Fieber, Entzündung; Thrombozytenaggregationshemmer.",
    "ja": "痛み、発熱、炎症;抗血小板療法。"
  }
}

다운스트림 Make 모듈은 모든 언어를 직접 매핑할 수 있습니다: {{enrichEntity.result.names.primary.fr}}. 언어 드롭다운에는 전체 40개 언어 목록이 표시되며, organization 프로필에서 선택 가능한 언어 수를 제한하는 경우 요금제 제한 알림이 표시됩니다.

Make 모듈: 지원되는 40개 언어를 표시하는 언어 다중 선택 드롭다운

설치

Make 앱 소스는 공개 TOT-Concept 저장소에 있습니다(Entity Enricher 모노레포에서 동기화됨). v1.0이 Make 마켓플레이스에 출시되기 전까지는 Developer Hub를 통해 사이드로드하세요:

  1. 개발자로 Make 조직에 로그인하세요.
  2. Apps → Create a new app → Custom App으로 이동합니다.
  3. make-app-entity-enricher/ 디렉터리를 .zip으로 업로드하거나, 각 .json / .imljson 파일을 편집기의 해당 탭에 붙여넣으세요.
  4. Entity Enricher → Settings → API Keys의 키를 사용하여 API Key connection을 추가하세요 (형식 ent_XXXXXXXXXXXX). 이 연결은 /api/enrichment/options에 대해 자동으로 테스트됩니다.
Make: API 키 연결 설정 양식

동적 드롭다운

Make 모듈의 모든 선택 가능한 필드는 구성 시점에 Entity Enricher API를 호출하는 RPC로 채워집니다. 고정된 스키마가 먼저 표시되고(📌 표시), 모델 레이블에는 백만 토큰당 가격이 포함되며, 플랜 제한이 있는 조직은 할당량에 도달하면 알림을 보게 됩니다.

Make 모듈: 상단에 고정된 스키마가 있는 스키마 드롭다운이 열린 상태

사전 요구 사항

API 키Entity Enricher에서 organization access key를 생성하세요. API Keys 문서를 참조하세요. 서비스 간 통합에는 (자체 역할을 가진) organization access key를 사용하세요.
기본 URLEntity Enricher 인스턴스의 URL입니다 — 기본값은 https://entityenricher.ai입니다. 자체 호스팅 배포의 경우에만 재정의하세요.
OAuth 2.0Entity Enricher의 인증 서버가 출시되면 API 키 인증과 함께 v0.4에 도입됩니다. 최종 사용자 시나리오는 표준 Make OAuth 플로우를 통해 자신의 계정을 연결할 수 있습니다.

엔터티 보강 실제 동작

중앙 모듈은 동적 드롭다운으로 입력 필드를 노출합니다: 스키마, 모델(다중 선택), 언어(다중 선택), 전략, 선택적 분류 및 중재 모델, 웹 검색, 응답 스키마, 엄격한 구조화 출력, 타임아웃, 메타데이터 토글. Entity data 필드를 통해 이전 모듈의 엔터티를 매핑하세요.

모델을 2개 이상 선택하면 결과가 서버 측에서 자동으로 융합됩니다. Make 출력 패널에는 is_fused: true, source_models 목록, 그리고 일치하거나 충돌한 필드 수를 집계한 fusion 요약이 표시됩니다:

Make 출력 패널: 다중 모델 융합 강화 결과

사용 가능한 모듈

5개 카테고리에 걸친 9개 모듈. Search 모듈은 다운스트림 Iterator/Aggregator 체인을 위해 결과당 하나의 번들을 내보내고, Action 모듈은 단일 번들을 내보냅니다.

범주모듈설명
EnrichmentEnrich Entity다중 모델 융합을 사용하는 단일 호출 보강. 최종 융합(또는 최상의 단일 모델) 결과를 반환합니다. 분류 경고 시 자동으로 취소됩니다.
SchemasList Schemas저장된 schema마다 하나의 Make 번들을 반환하며, Iterator/Aggregator 체인에 바로 사용할 수 있습니다.
SchemasGet Schema Details전문 영역, 속성, 검색 키를 포함한 전체 스키마 콘텐츠입니다.
RecordsList Records필터(유형, 성공 여부, 자유 텍스트)로 과거 강화 레코드를 검색합니다.
RecordsGet Recordprompt별 전체 지표와 함께 단일 enrichment 결과를 조회합니다.
FusionMerge Results여러 보강 결과를 다시 병합하며, 선택적으로 다른 LLM 중재자를 사용할 수 있습니다.
AttachmentsUpload Attachment파일(상위 모듈에서 버퍼로 매핑됨, 예: HTTP ▸ Get a File)을 업로드하고 Enrich Entity에서 사용할 첨부 파일 ID를 반환합니다.
AttachmentsDelete AttachmentID로 첨부 파일을 삭제합니다 — 강화 후 유용한 정리 단계입니다.
ConfigurationGet Options사용 가능한 model, 언어, 전략 및 organization의 요금제 한도입니다.

다중 엔티티 워크플로: 반복자 패턴

Make 시나리오는 작업당 요금이 청구됩니다. Make 앱은 n8n 커넥터의 Batch Enrich 모듈을 이식하는 대신 Make의 기본 Iterator + Enrich Entity를 사용합니다. 각 반복은 독립적이며, 실패가 연쇄되지 않고, 청구는 실제로 처리된 내용을 정확히 반영합니다.

[trigger: array of entities]
[Make: Iterator] (splits into N bundles)
[this app: Enrich Entity] (one operation per entity)
[Make: Aggregator] (recombines, optionally with skip-on-error)
[downstream: upsert to CRM / database]

주요 특징

40개 언어 다국어 지원

단일 Enrich Entity 호출로 선택한 모든 언어의 다국어 속성을 채웁니다 — N번의 순차 왕복이 아니라 한 번의 LLM 패스로 생성됩니다. 어떤 언어든 직접 매핑하세요: {{result.names.primary.fr}}.

단일 호출 보강

전용 POST /api/single/enrich/sync 엔드포인트가 스트리밍 흐름을 서버 측에서 래핑합니다. 하나의 Make 작업 = 하나의 번들. 폴링도, 두 모듈 패턴도 없습니다.

동적 드롭다운 (RPC)

7개의 RPC가 구성 시점에 스키마, 모델, 언어, 전략, 분류/중재 모델, 웹 검색 옵션을 가져옵니다 — 고정된 스키마가 먼저 표시되고, 모델 레이블에는 가격이 포함됩니다.

다중 모델 자동 융합

모델을 2개 이상 선택하면 결과가 자동으로 융합됩니다. 출력 번들에는 is_fused, source_models[], 그리고 fusion: {agreed_fields, conflicted_fields, total_fields} 요약이 포함됩니다.

사전 분류

선택적인 저렴한 classification model이 enrichment을 실행하기 전에 entity가 schema에서 기대하는 유형과 일치하는지 확인합니다. 불일치는 환각 데이터 대신 유형이 지정된 DataError를 생성합니다.

플랜 한도 및 크레딧 인식

HTTP 402 오류(요금제 한도 또는 크레딧 부족)는 형식이 지정된 Make OutOfMoneyError로 변환됩니다. 메시지에는 백엔드의 사람이 읽을 수 있는 세부 정보(크레딧이 소진된 경우 결제 충전 URL 포함)와 기계가 읽을 수 있는 코드가 함께 표시됩니다. 이 코드를 기준으로 시나리오 오류 처리기를 분기하여 담당자에게 알리거나, 더 저렴한 모델로 대체하거나, 일시 중지하세요.

웹 검색 드롭다운 잠금

Web Search 드롭다운은 parameters.models를 읽으며, 선택한 모델 중 supports_web_search를 선언하는 모델이 없으면 자동으로 비활성화됩니다.

배치 모듈 없음

Make 시나리오는 작업당 요금이 청구됩니다. 다중 엔티티 워크플로는 Make의 기본 Iterator + Enrich Entity를 사용하여 엔티티별 세분화된 오류 처리와 정확한 청구를 제공합니다.

구성 가능한 시간 초과

호출당 기본 300초 타임아웃이며 [10, 900] 범위로 제한됩니다. 작업이 제시간에 완료되지 않으면 서버 측에서 자동으로 취소되며 형식화된 ConnectionError를 반환합니다.

오류 계약

백엔드가 반환할 수 있는 모든 상태는 유형이 지정된 Make 오류로 매핑되어, 시나리오 오류 핸들러가 문자열을 파싱하는 대신 실패 모드에 따라 분기할 수 있습니다.

Make 시나리오: OutOfMoneyError에서 분기하는 오류 핸들러
HTTPMake 오류 유형실행 시점
400DataError스키마를 찾을 수 없거나, 검색 키가 없거나, 모델 또는 언어가 유효하지 않습니다.
401InvalidCredentialsAPI 키가 잘못되었거나 누락되었습니다.
402OutOfMoneyError플랜 한도 초과 또는 크레딧 부족. 메시지 = body.detail.detail (사람이 읽을 수 있으며, insufficient_credits의 경우 충전 URL 포함) + body.detail.code (기계가 읽을 수 있음). 코드에 따라 분기하세요: insufficient_credits, model_limit_exceeded, language_limit_exceeded, concurrent_job_limit_reached, daily/weekly/monthly_prompt_limit_exceeded.
403AccessDeniedError역할 또는 범위가 부족합니다.
404InvalidConfigurationError스키마 또는 레코드를 찾을 수 없습니다.
422DataError분류 경고. body.detail.classification에 status, reasoning, confidence, entity_description이 포함됩니다.
429RateLimitError프로바이더 속도 제한(일시적)입니다.
499RuntimeError작업이 취소되었습니다.
502ConnectionError업스트림 LLM 공급자 오류입니다 (예: 컨텍스트 오버플로).
504ConnectionErrortimeout_seconds가 경과했습니다. 작업이 서버 측에서 자동으로 취소되었습니다.

워크플로우 아이디어

CRM 강화새 HubSpot/Salesforce 연락처에서 트리거하고, 회사 데이터로 보강하며, CRM 레코드를 업데이트합니다.
스프레드시트 파이프라인Google Sheets에서 엔터티를 읽고 Iterator + Enrich Entity로 처리한 뒤 결과를 새 시트에 기록합니다.
조건부 재중재먼저 규칙 기반 융합을 실행하고, conflicted_fields > 5인 경우 Merge Results를 통해 LLM 중재자로 다시 병합합니다 — 비용이 많이 드는 보강을 다시 실행하지 않아도 됩니다.
플랜 한도 라우팅OutOfMoneyError 발생 시, Slack에서 담당자에게 알리고 할당량 기간이 재설정될 때까지 scenario를 일시 중지합니다.
예약된 새로고침cron 스케줄(Make Schedule 트리거)로 실행하여 오래된 레코드를 최신 모델로 다시 보강합니다.

다음 단계