用途:为 n8n 节点配置提供操作感知的指导,解决“哪些字段在当前操作下必填、字段为何出现或消失”等问题。核心理念是渐进式披露:先配置最小可用集,再按需增加复杂度;据资料,基于 essentials 的配置成功率约 91.7%,多数配置只需 essentials 而非完整 schema。
主要能力:一是操作感知配置,资源(resource)与操作(operation)共同决定必填字段,例如 Slack 的 message/post 需要 channel 与 text,而 message/update 需要 messageId 与 text。二是属性依赖,字段通过 displayOptions 控制可见性,如 HTTP Request 的 sendBody=true 且 method 为 POST/PUT/PATCH 时才显示 body。三是渐进式发现:get_node_essentials 用于快速获取必填字段与常用选项;get_property_dependencies 用于查看字段间的条件依赖;get_node_info 用于获取完整 schema。四是校验闭环,用 validate_node_operation 按 runtime profile 校验并依据报错迭代。
使用方式:先确定节点类型与操作,调用 get_node_essentials 获取要点,配置必填字段,再调用 validate_node_operation 校验;若不明白字段为何缺失或必填,改用 get_property_dependencies;essentials 与依赖信息仍不足时再上 get_node_info;修改后再次校验,通过后部署。资料给出的典型流程平均需 2–3 轮迭代。
适用场景:Slack、Google Sheets、Airtable 等资源/操作型节点;HTTP Request、Webhook 等 HTTP 型节点;Postgres、MySQL、MongoDB 等数据库节点;IF、Switch、Merge 等条件逻辑节点。
限制与注意:资料未提供价格、平台支持范围与安装命令等信息,暂未提供。避免过度配置、跳过校验、忽视操作上下文或直接照搬配置;单值运算符等结构由自动清理机制处理,无需手工增删。