n8n-node-configuration

用途

n8n-node-configuration 是一个面向 n8n 工作流节点配置的指导技能，核心是“操作感知（operation-aware）”的配置方法。它帮助使用者在配置节点时理解：并非所有字段始终必填，哪些字段必填取决于所选资源（resource）与操作（operation），以及字段之间的依赖关系。

主要能力

操作感知配置：资源 + 操作共同决定必填字段。例如 Slack 节点在 operation='post' 时需要 channel 与 text，而在 operation='update' 时需要 messageId 与 text，channel 不再必填。
属性依赖理解：字段会随其他字段取值而显示或隐藏，由 displayOptions 控制。例如 HTTP Request 节点在 method='POST' 时出现 sendBody，sendBody=true 时 body 变为必填。
渐进式发现工具链：
- get_node_essentials：快速概览、必填字段与常用选项，资料称基于 essentials 的配置成功率约 91.7%，平均约 18 秒。
- get_property_dependencies：展示字段依赖树与条件必填规则，用于 essentials 不足时。
- get_node_info：返回完整 schema、全部属性与高级选项，用于前两者仍不足时。
校验驱动流程：通过 validate_node_operation 迭代校验，按错误提示补齐字段，资料称平均 2-3 轮迭代属正常。
常见节点模式：涵盖资源/操作型（Slack、Google Sheets、Airtable）、HTTP 型（HTTP Request、Webhook）、数据库型（Postgres、MySQL、MongoDB）、条件逻辑型（IF、Switch、Merge）。
反模式提示：避免过度配置、跳过校验、忽略操作上下文、盲目复制配置等。

使用方式

资料给出的标准流程为：

确定节点类型与操作；
调用 get_node_essentials；
配置必填字段；
校验配置；
依赖不清时调用 get_property_dependencies；
按需添加可选字段；
再次校验；
部署。

示例（HTTP Request POST JSON）：

const info = get_node_essentials({
  nodeType: "nodes-base.httpRequest"
});

最小配置：

{
  "method": "POST",
  "url": "https://api.example.com/create",
  "authentication": "none"
}

校验：

validate_node_operation({
  nodeType: "nodes-base.httpRequest",
  config,
  profile: "runtime"
});

按错误提示补充 sendBody 与 body 后再次校验，直至通过。

依赖查询示例：

const deps = get_property_dependencies({
  nodeType: "nodes-base.httpRequest"
});

适用场景

首次配置某类节点，需要快速了解必填字段与常用选项。
切换节点操作后，需要确认字段要求是否变化。
校验失败但不清楚某字段为何缺失或必填。
配置 HTTP、数据库、条件逻辑等具有条件依赖的节点。

限制

资料未提供该技能的具体安装方式、运行环境要求、支持的 n8n 版本、收费或价格信息，也未说明其独立部署方式。相关工具（get_node_essentials、get_property_dependencies、get_node_info、validate_node_operation）的具体调用环境与前置条件暂未提供。

技能介绍

用途

主要能力

使用方式

适用场景

限制