n8n コネクター - Entity Enricher ドキュメント

n8n コネクター

n8n用のEntity Enricherコミュニティノードを使用すると、ビジュアルなドラッグ&ドロップエディタで自動化されたエンリッチメントパイプラインを構築できます。コードを書くことなく、400以上のアプリに接続できます。

インストール

お使いの n8n インスタンスにコミュニティノードをインストールします:

npm install n8n-nodes-entity-enricher

または n8n の UI からインストール：Settings → Community Nodes に移動し、n8n-nodes-entity-enricher を検索します。

前提条件

APIキー— Entity Enricherでorganizationアクセスキーを作成します。詳細はAPI Keysのドキュメントを参照してください。キーの形式はent_XXXXXXXXXXXXです。
ベース URL— Entity EnricherインスタンスのURL(例:https://entityenricher.ai、またはセルフホストのURL)。
認証情報の設定— n8nで、APIキーとベースURLを使ってEntity Enricher APIのクレデンシャルを作成します。すべてのノードがこのクレデンシャルを使用します。

利用可能な操作

コネクタは、6つのリソースカテゴリにわたって10個の操作を提供します:

リソース操作説明
EnrichmentEnrich Entity単一の entity を 1 つ以上の AI model で enrichment します。SSE 経由でリアルタイムの進捗とともに結果をストリーミングします。
EnrichmentBatch Enrichすべての入力項目を単一の batch として enrichment します。entity ごとの進捗追跡を伴う並列処理です。
SchemaList Schemasエンリッチメントワークフローで選択できるよう、保存済みのスキーマを一覧表示します。
SchemaGet Schema Details特定のschemaについて、抽出された主要なプロパティを含む完全なschemaコンテンツを取得します。
RecordList Recordsタイプと成功のフィルターでエンリッチメントレコードを照会します。結果はページ分割されます。
RecordGet Record完全な構造化出力を含む特定のenrichment結果をIDで取得します。
FusionMerge Results複数のエンリッチメントレコードの結果を、オプションの LLM 調停でフュージョンします。
AttachmentAdd Attachment入力項目からバイナリプロパティ（multipart）をアップロードし、そのアタッチメント ID を返します。
AttachmentDelete AttachmentIDでattachmentを削除します。enrichment後の便利なクリーンアップ手順です。
ConfigurationGet Options動的な設定のために、利用可能なmodel、言語、戦略、プラン上限を取得します。

単一エンティティエンリッチメント

最もシンプルなワークフローです。新しいデータをトリガーにして単一の entity を enrichment し、その結果を出力先にプッシュします。このノードは、構造化出力を下流に渡す前に、enrichment 全体が完了するのを待ちます。

ワークフローの例 — 単一エンティティのエンリッチメント:

ノード設定 — Enrich Entity操作:

単一エンリッチメント用の Entity Enricher ノード設定

設定

動的ドロップダウンからスキーマを選択し、1つ以上のモデルを選択して、エンティティデータをキーと値のフィールドとして入力します。ノードは選択したスキーマに基づいて検索キーフィールドを自動的に入力します。

任意の設定には、戦略（シングルパスまたはマルチ専門領域）、多言語出力のための言語、エンティティ型検証のための分類モデル、マルチモデルの競合解決のためのアービトレーションモデル、そして対応可能なモデルでスキーマ準拠の出力を強制するレスポンススキーマ／厳密な構造化出力のトグルが含まれます。

Attachment IDフィールド(以前のAdd Attachment呼び出しで取得したUUIDをカンマ区切りで指定)を入力すると、ソースドキュメントをenrichmentに取り込めます。Batch Enrichでも利用可能です。

バッチエンリッチメント

すべての入力項目を単一のバッチとして処理します。スプレッドシート、データベース、API レスポンスからのリストのエンリッチメントに最適です。すべてのエンティティは、プロバイダーごとのレート制限のもとで並列処理されます。

ノード設定 — Batch Enrich操作:

バッチエンリッチメント用の Entity Enricher ノード設定

バッチモードの仕組み

  1. アイテムの収集 — ノードが前のノードからすべての入力アイテム（例：スプレッドシートの行）を収集します。
  2. batchジョブを開始 — すべてのentityはPOST /api/batch/startで送信され、並列で処理されます。
  3. 進捗のストリーミング — ノードは、すべてのentityが完了するかタイムアウトに達するまでSSEストリームを消費します。
  4. 結果を出力 — エンティティごとに1つの出力アイテムが、エンリッチされた構造化データとして下流処理向けに準備されます。

主な特徴

動的ドロップダウン

スキーマ、モデル、言語、戦略のセレクターは、設定時にお使いのEntity Enricherインスタンスから選択肢を取得します。

SSEストリーミング

エンリッチメント操作はSSEストリームをリアルタイムで消費し、完了を待ってから次のノードに結果を返します。

自動継続

プリフライトの classification が不一致を検出した場合、コネクタは自動的に処理を続行します（n8n ワークフローは非対話型です）。

設定可能なタイムアウト

エンリッチメント呼び出しごとのデフォルトのタイムアウトは300秒で、大きなスキーマや低速なモデルに対応してノードごとに調整できます。

マルチモデルサポート

エンリッチメントごとに複数のモデルを選択できます。2つ以上のモデルを使用すると、結果は自動的にフュージョンされます。

デフォルトで出力をクリーンにする

デフォルトでは、出力にはenrichment済みのデータフィールドのみが含まれます。「Enrichmentメタデータを含める」をオンにすると、コスト、トークン、fusionの詳細、recordのIDが追加されます。

model ごとの出力

下流での比較のために、フュージョン結果と併せて個々のモデルの結果を任意で出力します。

プラン上限の把握

設定されている場合、モデルと言語のドロップダウンにはプラン制限が表示されます。クォータ適用による HTTP 402 エラーは、制限の詳細を含む明確で実行可能なメッセージとして表示されます。メタデータ出力には、下流のルーティング用に現在のプラン制限が含まれます。

ワークフローのアイデア

n8nでエンリッチメントパイプラインを構築する際の一般的なパターン：

CRMエンリッチメント— 新しいHubSpot/Salesforceの連絡先でトリガーし、会社データでエンリッチして、CRMレコードを更新します。
スプレッドシートパイプライン— Google Sheetsからエンティティを読み込み、バッチでエンリッチし、結果を新しいシートに書き戻します。
ウォーターフォール enrichment— 複数の enrichment ステップを条件ロジックで連結します。最初は高速な model を使い、失敗したものはより高性能な model で再 enrichment します。
スケジュールされた更新— cronスケジュールで実行し、古くなったレコードを最新のAIモデルで再エンリッチします。
Webhook駆動— エンティティデータを受け取り、エンリッチメントして結果を同期的に返すWebhookエンドポイントを公開します。

次のステップ

APIキー

n8n認証情報用のorganizationアクセスキーを作成します。

バッチ処理

並列実行、進捗トラッキング、エクスポートについて学びましょう。

APIリファレンス

高度な連携のための完全な REST API ドキュメントです。