[ PROMPT_NODE_28118 ]
N8N MCP Tools Expert Validation Guide
[ SKILL_DOCUMENTATION ]
# 配置验证工具指南
验证节点配置和工作流的完整指南。
---
## 验证理念
**尽早验证,频繁验证**
验证通常是迭代进行的,包含 验证 → 修复 循环。
---
## validate_node_minimal (快速检查)
**成功率**: 97.4% | **速度**: <100ms
**使用场景**: 检查哪些字段是必填的
**语法**:
javascript
validate_node_minimal({
nodeType: "nodes-base.slack",
config: {} // 为空以查看所有必填字段
})
**返回**:
javascript
{
"valid": true, // 通常为 true (大多数节点没有严格要求)
"missingRequiredFields": []
}
**使用时机**: 规划配置、查看基本要求时
---
## validate_node_operation (全面验证)
**成功率**: 不定 | **速度**: <100ms
**使用场景**: 部署前验证实际配置
**语法**:
javascript
validate_node_operation({
nodeType: "nodes-base.slack",
config: {
resource: "channel",
operation: "create",
channel: "general"
},
profile: "runtime" // 推荐!
})
### 验证配置文件
根据你的阶段选择:
**minimal** - 仅必填字段
- 最快
- 最宽松
- 使用场景: 编辑时的快速检查
**runtime** - 值 + 类型 (**推荐**)
- 平衡验证
- 捕获真实错误
- 使用场景: 部署前验证
**ai-friendly** - 减少误报
- 针对 AI 生成的配置
- 容忍轻微问题
- 使用场景: 当 AI 配置节点时
**strict** - 最大限度验证
- 最严格规则
- 可能有误报
- 使用场景: 生产环境部署
### 返回
javascript
{
"valid": false,
"errors": [
{
"type": "missing_required",
"property": "name",
"message": "频道名称为必填项",
"fix": "提供频道名称 (小写,无空格,1-80 个字符)"
}
],
"warnings": [
{
"type": "best_practice",
"property": "errorHandling",
"message": "Slack API 可能存在速率限制",
"suggestion": "添加 onError: 'continueRegularOutput' 并配合 retryOnFail"
}
],
"suggestions": [],
"summary": {
"hasErrors": true,
"errorCount": 1,
"warningCount": 1
}
}
### 错误类型
- `missing_required` - 必须修复
- `invalid_value` - 必须修复
- `type_mismatch` - 必须修复
- `best_practice` - 建议修复 (警告)
- `suggestion` - 可选改进
---
## validate_workflow (结构验证)
**成功率**: 95.5% | **速度**: 1