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

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

---

## ✅ 前置条件检查

在开始之前，确认：
- [x] 已创建 Data-governance 工作流（ID: `tWfjLZE1FmMfQAIn`）
- [x] 后端 API 接口已部署（192.168.3.143:5000）
- [x] AI Agent 系统消息已更新
- [x] 可以访问 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
- [ ] 工作流已保存并激活
- [ ] 测试通过

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

