n8n 中文文档

从 n8n-nodes-databricks 社区包迁移

内置 Databricks 节点取代了 n8n-nodes-databricks 社区包。本页面将每个社区节点映射到对应的内置节点,列出已移动的字段,并说明需要注意的行为变化。

社区节点和内置节点使用不同的 node type,因此无法原地转换节点。对于工作流中的每个社区节点:添加内置节点,复制设置,重新连接,然后删除社区节点。

内置 AI 节点需要使用服务主体或用户登录的 Databricks OAuth2 凭据。社区包使用 host 和个人访问令牌的凭据,在内置 AI 节点中没有对应方式;只有内置 Databricks 和 Databricks Trigger 节点接受个人访问令牌。

节点映射

社区节点 内置节点 变化
Databricks Databricks 资源相同。内置节点新增 Job 操作,以及 Databricks Trigger 节点。
Databricks Chat Model Databricks Chat Model Model 模型选择 Unity AI Gateway 模型服务 catalog.schema.service,而不是 serving endpoint。Conversation ID 会话 ID和 Return Trace 返回跟踪选项已不存在。
Embeddings Databricks Embeddings Databricks Serving Endpoint 服务端点改为 Model 模型,即支持 embeddings 的模型服务列表。
Databricks Vector Store Databricks Vector Store Index Name 索引名称改为 Index 索引,可从列表选择或输入完整的 catalog.schema.index 名称。Text Column 文本列改为 Content Column 内容列,从索引列中选择。Metadata Columns 元数据列从逗号分隔列表改为多选字段。Score Threshold 分数阈值已移除;请使用 Limit 限制。新增:Search Mode 搜索模式和 Metadata Filter 元数据筛选器。
Databricks AI Agent Databricks AI Agent Enable MLflow Tracking 启用 MLflow 跟踪改为 Export Traces to MLflow 导出跟踪到 MLflow。默认 experiment 路径 /Shared/n8n-workflows-<workflow-id> 保持不变,新的 Experiment 实验字段可用于选择现有 experiment。agent 上的凭据仅用于导出。

Vector Store 节点的字段差异

社区字段 内置字段 说明
Index Name 索引名称(文本) Index 索引 选择 From List 从列表中选择,或在 Name 名称中输入全名。在 Insert Documents 插入文档模式下,列表仅显示 Direct Access 索引。
Text Column 文本列(默认 text) Content Column 内容列 从索引列中选择。在托管索引上留空可使用 embedding source column。
Metadata Columns 元数据列(逗号分隔文本) Metadata Columns 元数据列选项 多选字段。留空时返回除 primary key、content column 和 vector column 以外的所有列。
Score Threshold 分数阈值(默认 0.8) 无 使用 Limit 限制。原因请参阅不提供分数阈值。
无 Search Mode 搜索模式选项 Vector 向量或 Hybrid 混合。
无 Metadata Filter 元数据筛选器选项 作为 filters_json 发送的 JSON 筛选器。

需要注意的行为变化

  • 现在可以搜索托管索引。社区节点始终发送 query_vector,因此对使用 Databricks 计算 embeddings 的 Delta Sync 索引执行搜索都会失败。内置节点会根据索引要求发送 query_text 或 query_vector。请参阅索引类型和嵌入。
  • 不再因阈值丢弃结果。社区节点的 Score Threshold 分数阈值默认为 0.8,会丢弃相似度分数远低于该值的索引中的所有结果。内置节点返回 Limit 限制指定数量的顶部结果。
  • 混合搜索和 metadata filter 可用于所有搜索模式,包括 agent 将索引用作工具时。
  • 插入前会先验证。如果使用 Delta Sync 索引或错误的 Content Column 内容列,节点会给出明确指出问题的消息,而不是原始 API 错误。
  • Agent 不会偏离主版本。内置 Databricks AI Agent 运行 AI Agent 节点自身的代码,而不是 fork,因此拥有相同选项,并获得相同修复。
  • 替换 agent 节点后,trace 仍写入同一 experiment,因为默认 experiment 路径包含 workflow ID。

相关资源

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。