n8n 连接器 - Entity Enricher 文档

n8n 连接器

适用于 n8n 的 Entity Enricher 社区节点让你可以通过可视化拖放编辑器构建自动化丰富化流程。无需编写代码即可连接 400 多个应用。

安装

在您的 n8n 实例中安装社区节点：

npm install n8n-nodes-entity-enricher

或通过 n8n 界面安装：进入Settings → Community Nodes，搜索 n8n-nodes-entity-enricher。

前置条件

API 密钥— 在 Entity Enricher 中创建组织访问密钥。详情请参阅API 密钥文档。密钥格式为 ent_XXXXXXXXXXXX。
基础 URL— 你的 Entity Enricher 实例的 URL（例如 https://entityenricher.ai 或你的自托管 URL）。
凭据设置— 在 n8n 中，使用您的 API 密钥和基础 URL 创建一个 Entity Enricher API 凭证。所有节点都将使用此凭证。

可用操作

该连接器在 6 个资源类别中公开了 10 项操作：

资源操作描述
EnrichmentEnrich Entity使用一个或多个 AI 模型富化单个实体。通过 SSE 实时流式传输结果与进度。
EnrichmentBatch Enrich将所有输入项作为单个批次富化。并行处理并逐实体跟踪进度。
SchemaList Schemas列出可供在增强工作流中选择的已保存模式。
SchemaGet Schema Details检索特定 schema 的完整 schema 内容及提取的关键属性。
RecordList Records按类型和成功状态筛选查询富集记录。结果分页显示。
RecordGet Record按 ID 检索特定的 enrichment 结果，包含完整的结构化输出。
FusionMerge Results融合来自多条丰富记录的结果，可选 LLM 仲裁。
AttachmentAdd Attachment从输入项上传一个二进制属性（multipart），并返回其附件 ID。
AttachmentDelete Attachment按 ID 删除附件——便捷的丰富后清理步骤。
ConfigurationGet Options获取可用的模型、语言、策略和套餐限制，用于动态配置。

单实体增强

最简单的工作流：在有新数据时触发，enrich 单个 entity，并将结果推送到你的目标位置。该节点会等待完整的 enrichment 完成后，再将结构化输出向下游传递。

工作流示例——单个实体扩充：

节点配置——Enrich Entity 操作：

用于单次增强的 Entity Enricher 节点配置

配置

从动态下拉菜单中选择一个 schema，选择一个或多个 model，并以键值字段形式提供 entity 数据。节点会根据所选 schema 自动填充搜索键字段。

可选设置包括策略（单遍或多专业领域）、用于多语言输出的语言、用于实体类型验证的分类模型、用于多模型冲突解决的仲裁模型，以及响应 schema / 严格结构化输出开关，可在支持的模型上强制输出符合 schema 的结果。

提供 附件 ID 字段（以逗号分隔的 UUID，来自先前的“添加附件”调用），即可将源文档送入 enrichment——批量 Enrich 中也可使用。

批量丰富化

将所有输入项作为单个批处理进行处理。非常适合从电子表格、数据库或 API 响应中富集列表。所有实体都会并行处理，并按提供商进行速率限制。

节点配置——Batch Enrich 操作：

用于批量增强的 Entity Enricher 节点配置

批量模式的工作原理

  1. 收集项目——节点会从上一个节点收集所有输入项目（例如电子表格中的行）。
  2. 启动 batch 任务——所有 entity 都通过 POST /api/batch/start 提交并并行处理。
  3. 流式进度——该节点会持续消费 SSE 流，直到所有 entity 完成或达到超时。
  4. 输出结果 — 每个实体对应一个输出项，包含增强后的结构化数据，可供下游处理。

主要特性

动态下拉菜单

Schema、模型、语言和策略选择器会在配置时从你的 Entity Enricher 实例获取可选项。

SSE 流式传输

丰富化操作实时消费 SSE 流，等待完成后再将结果返回给下一个节点。

自动继续

当预检分类检测到不匹配时，连接器会自动继续（n8n 工作流为非交互式）。

可配置超时

每次 enrichment 调用默认超时 300 秒，可针对大型 schema 或较慢的模型按节点进行调整。

多模型支持

每次 enrichment 可选择多个 model。使用 2 个以上 model 时，结果会自动进行 fusion。

默认清理输出

默认情况下，输出仅包含丰富后的数据字段。开启“包含丰富元数据”可添加成本、令牌、融合详情和记录 ID。

各模型输出

可选择在融合结果之外一并输出各个模型的单独结果，供下游比较。

套餐限额提示

配置后，模型和语言下拉菜单会显示套餐限制。配额强制执行产生的 HTTP 402 错误会以清晰、可操作的消息呈现，并附带限制详情。元数据输出包含当前套餐限制，供下游路由使用。

工作流创意

使用 n8n 构建 enrichment 流水线的常见模式：

CRM 富集— 在新增 HubSpot/Salesforce 联系人时触发，用公司数据进行增强，并更新 CRM 记录。
电子表格流水线— 从 Google Sheets 读取实体，批量增强，并将结果写回新的工作表。
瀑布式增强— 使用条件逻辑串联多个数据丰富化步骤——先使用快速模型，再用能力更强的模型重新丰富化失败的记录。
定时刷新— 按 cron 计划运行，用最新 AI 模型重新充实过时记录。
由 Webhook 驱动— 公开一个 webhook 端点，接受实体数据、对其进行富化并同步返回结果。

后续步骤

API 密钥

为 n8n 凭据创建组织访问密钥。

批处理

了解并行执行、进度跟踪和导出。

API 参考

面向高级集成的完整 REST API 文档。