---

name: n8n-node-configuration description: 操作感知的节点配置指南。在配置节点、理解属性依赖关系、确定必填字段、选择 get_node 详细级别或学习按节点类型分类的常见配置模式时使用。 risk: unknown source: community

n8n 节点配置

操作感知节点配置的专家指南，包含属性依赖关系。

何时使用

• 你需要为特定资源和操作正确配置 n8n 节点。
• 任务涉及必填字段、属性依赖关系或选择正确的 get_node 详细级别。
• 你正在排查节点设置问题而非整体工作流架构。

---

配置理念

渐进式展示：从最小配置开始，按需增加复杂度

配置最佳实践：

• get_node 配合 detail: "standard" 是最常用的发现模式
• 配置编辑之间平均间隔56秒
• 用1-2K token 的响应覆盖95%的用例

关键洞察：大多数配置只需要标准详细级别，而非完整 schema！

---

核心概念

1. 操作感知配置

并非所有字段始终必填 - 取决于操作！

示例：Slack 节点

// For operation='post'
{
  "resource": "message",
  "operation": "post",
  "channel": "#general",  // Required for post
  "text": "Hello!"        // Required for post
}

// For operation='update'
{
  "resource": "message",
  "operation": "update",
  "messageId": "123",     // Required for update (different!)
  "text": "Updated!"      // Required for update
  // channel NOT required for update
}

关键：资源 + 操作决定哪些字段是必填的！

2. 属性依赖关系

字段根据其他字段的值出现/消失

示例：HTTP Request 节点

// When method='GET'
{
  "method": "GET",
  "url": "https://api.example.com"
  // sendBody not shown (GET doesn't have body)
}

// When method='POST'
{
  "method": "POST",
  "url": "https://api.example.com",
  "sendBody": true,       // Now visible!
  "body": {               // Required when sendBody=true
    "contentType": "json",
    "content": {...}
  }
}

机制：displayOptions 控制字段可见性

3. 渐进式发现

使用正确的详细级别：

1. get_node({detail: "standard"}) - 默认

   • 快速概览（约1-2K token）
   • 必填字段 + 常用选项
   • 优先使用 - 覆盖95%的需求

2. get_node({mode: "search_properties", propertyQuery: "..."}) （用于查找特定字段）

   • 按名称查找属性
   • 当查找 auth、body、headers 等时使用

3. get_node({detail: "full"}) （完整 schema）

   • 所有属性（约3-8K token）
   • 仅在标准详细级别不够时使用

---

配置工作流

标准流程

1. Identify node type and operation
   ↓
2. Use get_node (standard detail is default)
   ↓
3. Configure required fields
   ↓
4. Validate configuration
   ↓
5. If field unclear → get_node({mode: "search_properties"})
   ↓
6. Add optional fields as needed
   ↓
7. Validate again
   ↓
8. Deploy

示例：配置 HTTP Request

步骤 1：确定需求

// Goal: POST JSON to API

步骤 2：获取节点信息

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

// Returns: method, url, sendBody, body, authentication required/optional

步骤 3：最小配置

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

步骤 4：验证

validate_node({
  nodeType: "nodes-base.httpRequest",
  config,
  profile: "runtime"
});
// → Error: "sendBody required for POST"

步骤 5：添加必填字段

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

步骤 6：再次验证

validate_node({...});
// → Error: "body required when sendBody=true"

步骤 7：完成配置

{
  "method": "POST",
  "url": "https://api.example.com/create",
  "authentication": "none",
  "sendBody": true,
  "body": {
    "contentType": "json",
    "content": {
      "name": "={{$json.name}}",
      "email": "={{$json.email}}"
    }
  }
}

步骤 8：最终验证

validate_node({...});
// → Valid! ✅

---

get_node 详细级别

标准详细级别（默认 - 使用这个！）

用于开始配置

get_node({
  nodeType: "nodes-base.slack"
});
// detail="standard" is the default

返回（约1-2K token）：

• 必填字段
• 常用选项
• 操作列表
• 元数据

用途：95%的配置需求

完整详细级别（谨慎使用）

当标准级别不够时

get_node({
  nodeType: "nodes-base.slack",
  detail: "full"
});

返回（约3-8K token）：

• 完整