DataOps-platform/QUICK_START_N8N_TOOLS.md

🚀 Data-governance 工作流配置快速开始

⏱️ 预计时间: 15-20 分钟
🎯 目标: 完成元数据管理工作流的 Tools 配置

---

✅ 前置条件检查

在开始之前，确认：

• 已创建 Data-governance 工作流（ID: tWfjLZE1FmMfQAIn）
• 后端 API 接口已部署（192.168.3.143:5000）
• AI Agent 系统消息已更新
• 可以访问 n8n 界面（https://n8n.citupro.com）

---

📝 3 步完成配置

步骤 1: 登录并打开工作流

1. 访问 https://n8n.citupro.com
2. 登录账号
3. 进入 Workflows → 找到 "Data-governance" → 点击打开

步骤 2: 添加检查元数据工具

2.1 添加节点

• 点击 "+" → 搜索 "HTTP Request Tool" → 选择（LangChain分类下的）

2.2 配置

【基本信息】
Name: check_metadata
Description: 检查元数据中文名是否已经存在。需要参数：name_zh（元数据中文名）。返回exists字段表示是否存在（true/false）

【HTTP配置】
Method: GET
URL: http://192.168.3.143:5000/api/meta/check?name_zh={{ $parameter.name_zh }}
Authentication: None

【参数定义】
点击 "Add Placeholder" 添加：
- Name: name_zh
- Description: 元数据中文名

2.3 连接

• 从该节点拖线到 "AI Agent"
• 选择连接类型：ai_tool （重要！）

---

步骤 3: 添加创建元数据工具

3.1 添加节点

• 再次点击 "+" → 搜索 "HTTP Request Tool" → 选择

3.2 配置

【基本信息】
Name: create_metadata
Description: 创建新的元数据。需要参数：name_zh（中文名，必填）, data_type（数据类型，默认string）, description（描述信息，选填）。返回创建结果

【HTTP配置】
Method: POST
URL: http://192.168.3.143:5000/api/meta/node/add
Authentication: None
Send Body: ✅ 启用
Body Content Type: JSON

【JSON Body】（重要：复制粘贴）
{
  "name_zh": "={{ $parameter.name_zh }}",
  "data_type": "={{ $parameter.data_type || 'string' }}",
  "describe": "={{ $parameter.description || '' }}",
  "source": "data-governance-workflow",
  "status": true
}

【参数定义】
点击 "Add Placeholder" 三次添加：
1. Name: name_zh, Description: 元数据中文名（必填）
2. Name: data_type, Description: 数据类型（string/int/float等，默认string）
3. Name: description, Description: 描述信息（选填）

3.3 连接

• 从该节点拖线到 "AI Agent"
• 选择连接类型：ai_tool

---

完成！保存并激活

1. 点击右上角 "Save" 保存
2. 确认 "Active" 开关为开启状态
3. 完成！🎉

---

🧪 立即测试

测试 URL

https://n8n.citupro.com/chat/tWfjLZE1FmMfQAIn

测试对话

用户: "是，我要创建元数据"
AI: （询问元数据信息）

用户: "中文名：测试字段001，类型：string，描述：这是测试"
AI: （检查→创建→返回成功）

预期结果:

• ✅ AI 询问信息
• ✅ AI 检查是否存在
• ✅ AI 创建元数据
• ✅ 返回成功消息

---

❓ 遇到问题？

问题 1: AI 不调用工具

解决:

• 检查 Tool 是否通过 ai_tool 连接（不是 main）
• 检查 Description 是否清晰

问题 2: API 调用失败

解决:

• 测试 URL 是否可访问：http://192.168.3.143:5000/api/meta/check?name_zh=test
• 检查网络连接

问题 3: 参数未传递

解决:

• 检查 Placeholder Definitions 是否正确定义
• 检查 JSON Body 中的表达式语法

---

📚 详细文档

需要更多信息？查看：

• 完整配置指南: docs/n8n_add_tools_guide.md
• 设计方案: docs/n8n_improved_workflow_design.md
• 故障排除: docs/n8n_chat_trigger_error_diagnosis.md
• 工作总结: docs/n8n_workflow_enhancement_summary.md

---

✅ 配置检查清单

完成后确认：

• 添加了 2 个 HTTP Request Tool 节点
• check_metadata 配置正确
• create_metadata 配置正确
• 两个 Tool 都通过 ai_tool 连接到 AI Agent
• 工作流已保存并激活
• 测试通过

全部完成？恭喜！您的数据治理工作流已准备就绪！ 🎉