[ PROMPT_NODE_28128 ]
n8n-node-configuration
[ SKILL_DOCUMENTATION ]
# n8n 节点配置
针对具有属性依赖关系的节点进行操作感知配置的专家指南。
---
## 配置哲学
**渐进式披露**:从最小化开始,根据需要增加复杂性
配置最佳实践:
- `get_node_essentials` 是最常用的发现模式
- 配置编辑之间平均间隔 56 秒
- 基于基本信息的配置成功率达 91.7%
**关键洞察**:大多数配置只需要基本信息,而不需要完整的架构!
---
## 核心概念
### 1. 操作感知配置
**并非所有字段总是必填的** - 取决于操作!
**示例**:Slack 节点
javascript
// 对于操作='post'
{
"resource": "message",
"operation": "post",
"channel": "#general", // post 必填
"text": "Hello!" // post 必填
}
// 对于操作='update'
{
"resource": "message",
"operation": "update",
"messageId": "123", // update 必填(不同!)
"text": "Updated!" // update 必填
// update 不需要 channel
}
**关键**:资源 + 操作决定了哪些字段是必填的!
### 2. 属性依赖
**字段根据其他字段的值显示/隐藏**
**示例**:HTTP 请求节点
javascript
// 当 method='GET'
{
"method": "GET",
"url": "https://api.example.com"
// sendBody 不显示(GET 没有 body)
}
// 当 method='POST'
{
"method": "POST",
"url": "https://api.example.com",
"sendBody": true, // 现在可见!
"body": { // 当 sendBody=true 时必填
"contentType": "json",
"content": {...}
}
}
**机制**:`displayOptions` 控制字段可见性
### 3. 渐进式发现
**针对不同任务使用合适的工具**:
1. **get_node_essentials** (91.7% 成功率)
- 快速概览
- 必填字段
- 常见选项
- **优先使用** - 覆盖 90% 的需求
2. **get_property_dependencies** (针对复杂节点)
- 显示字段间的依赖关系
- 揭示条件要求
- 在基本信息不足时使用
3. **get_node_info** (完整架构)
- 完整文档
- 所有可能的字段
- 在基本信息 + 依赖关系不足时使用
---
## 配置工作流
### 标准流程
1. 识别节点类型和操作
↓
2. 使用 get_node_essentials
↓
3. 配置必填字段
↓
4. 验证配置
↓
5. 如果依赖关系不明确 → 使用 get_property_dependencies
↓
6. 根据需要添加可选字段