docs: fix connection keys documentation to say "node names" not "node IDs" (#510) (#511)

The documentation incorrectly stated connection keys should be "node IDs"
when n8n actually requires "node names". This caused workflow creation
failures for AI-generated workflows.

Changes:
- tools-n8n-manager.ts: "Keys are source node names (the name field, not id)"
- n8n-create-workflow.ts: "Keys are source node names (not IDs)"
- Fixed example: "Webhook"/"Slack" instead of "webhook_1"/"slack_1"
- get-template.ts: clarified "source node names"

Closes #510

Conceived by Romuald Członkowski - https://www.aiadvisors.pl/en

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Romuald Członkowski <romualdczlonkowski@MacBook-Pro-Romuald.local>
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Romuald Członkowski
2025-12-26 14:50:58 +01:00
committed by GitHub
parent 20663dad0d
commit 808088f25e
5 changed files with 44 additions and 8 deletions

View File

@@ -7,6 +7,42 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
## [Unreleased]
## [2.31.3] - 2025-12-26
### Fixed
**Documentation Bug: Connection Keys Say "Node IDs" but Require "Node Names" (Issue #510)**
Fixed documentation that incorrectly stated connection keys should be "node IDs" when n8n actually requires "node names".
**Problem:**
The `n8n_create_workflow` documentation and examples showed using node IDs (e.g., `"webhook_1"`) as connection keys, but the validator requires node names (e.g., `"Webhook"`). This caused workflow creation failures and contributed to low success rates for AI-generated workflows.
**Changes:**
- Updated `tools-n8n-manager.ts` parameter description: "Keys are source node names (the name field, not id)"
- Updated `n8n-create-workflow.ts` documentation: "Keys are source node names (not IDs)"
- Fixed example to use `"Webhook"` and `"Slack"` instead of `"webhook_1"` and `"slack_1"`
- Clarified `get-template.ts` return description
**Before (incorrect):**
```javascript
connections: {
"webhook_1": { "main": [[{node: "slack_1", ...}]] } // WRONG
}
```
**After (correct):**
```javascript
connections: {
"Webhook": { "main": [[{node: "Slack", ...}]] } // CORRECT
}
```
**Impact:**
- AI models following documentation will now generate valid workflows
- Clear distinction between node `id` (internal identifier) and `name` (connection key)
- No breaking changes - validator behavior unchanged
## [2.31.2] - 2025-12-24
### Changed