n8n-node-configuration

n8n 节点配置专家技能

技能概述

提供 n8n 工作流中操作感知的节点配置指导，帮助开发者理解属性依赖关系、确定必需字段，并掌握 get_node 的渐进式发现方法。

适用场景

1. 配置 n8n 节点时

当你需要为 n8n 工作流添加或修改节点配置时，本技能可以指导你如何正确配置字段。通过理解不同操作（operation）下的字段要求差异，避免配置错误。例如，Slack 节点的 post 操作需要 channel 字段，但 update 操作需要的是 messageId。

2. 理解属性依赖关系

当某些字段在界面上"消失"或验证失败时，通常是 displayOptions 在起作用。本技能帮助你理解字段之间的依赖关系，例如 HTTP Request 节点中 sendBody 为 true 时才会显示 body 字段。

3. 确定 n8n 节点必需字段

不确定当前操作需要哪些必需字段时，使用 get_node 的 standard 详情级别快速获取核心字段信息，覆盖 95% 的配置需求，响应仅 1-2K tokens。

核心功能

操作感知配置

不同操作（operation）对应不同的字段要求，本技能教你如何根据 resource + operation 组合确定正确的配置结构。例如：IF 节点的二元运算符（equals、contains）需要 value1 和 value2，而一元运算符（isEmpty）只需要 value1。

渐进式发现方法

推荐使用 get_node({detail: "standard"}) 作为默认起点，仅在标准详情不足时才升级到 full 级别。对于查找特定字段，使用 get_node({mode: "search_properties", propertyQuery: "..."}) 可以精准定位。

验证驱动配置

采用"配置→验证→修复"的迭代流程，平均 2-3 次迭代即可完成正确配置。仔细阅读验证错误信息，它们会明确指出缺失或错误的字段。

常见问题

get_node 的 standard 和 full 详情级别有什么区别？

standard 是默认级别，返回必需字段、常见选项和操作列表，响应约 1-2K tokens，覆盖 95% 的使用场景。full 返回完整架构和所有嵌套选项，响应约 3-8K tokens，仅在 standard 不足以满足需求时使用。

为什么配置验证时提示某些字段找不到？

这通常是 displayOptions 机制在起作用——字段的存在依赖于其他字段的值。例如，HTTP Request 节点的 body 字段只有在 sendBody 为 true 且 method 为 POST/PUT/PATCH 时才会显示。使用 search_properties 模式可以查看字段的显示条件。

不同 operation 下字段要求有什么变化？

operation 决定了哪些字段是必需的。以 Slack 节点为例：post 操作需要 channel 和 text，update 操作需要 messageId 和 text，而 create 操作（针对 channel）只需要 name。切换操作时，务必使用 get_node 重新获取字段要求。