aiagent/前端测试邮件和消息队列节点.md

前端测试邮件和消息队列节点

🎯 快速测试指南

由于后端服务已经在运行，您可以直接在前端界面测试新实现的邮件节点和消息队列节点。

📧 测试邮件节点

步骤1: 创建工作流

1. 登录系统: http://101.43.95.130:8038
2. 点击"工作流管理"
3. 点击"创建新工作流"

步骤2: 添加节点

1. 添加开始节点

   • 从左侧工具箱拖拽"开始"节点到画布

2. 添加邮件节点

   • 从左侧工具箱拖拽"邮件"节点到画布
   • 连接开始节点到邮件节点

3. 添加结束节点

   • 从左侧工具箱拖拽"结束"节点到画布
   • 连接邮件节点到结束节点

步骤3: 配置邮件节点

点击邮件节点，在右侧配置面板中填写：

基础配置

• SMTP服务器: smtp.gmail.com (或使用测试服务如 smtp.mailtrap.io)
• SMTP端口: 587
• SMTP用户名: 您的邮箱地址
• SMTP密码: 应用专用密码（Gmail需要）
• 使用TLS: ✅ 开启

邮件内容

• 发件人邮箱: your-email@gmail.com
• 收件人邮箱: recipient@example.com
• 邮件主题: 测试邮件 - {test_key}
• 邮件正文类型: 纯文本 或 HTML
• 邮件正文:

  这是一封测试邮件。
  
  测试数据: {test_data}
  时间: {timestamp}
  

变量替换示例

邮件节点支持变量替换，使用 {key} 或 ${key} 格式：

• {test_key} - 从输入数据中获取 test_key 的值
• {test_data} - 从输入数据中获取 test_data 的值

步骤4: 保存并运行

1. 点击工具栏的"保存"按钮
2. 点击"运行"按钮
3. 在运行对话框中输入测试数据：

   {
     "test_key": "Hello World",
     "test_data": "这是测试数据",
     "timestamp": "2024-01-01 12:00:00"
   }
   

4. 点击"开始运行"
5. 查看执行结果和执行日志

步骤5: 验证结果

• ✅ 检查执行状态是否为"成功"
• ✅ 查看执行日志，确认邮件发送成功
• ✅ 检查收件箱，确认收到邮件
• ✅ 验证邮件主题和正文中的变量是否正确替换

🐰 测试RabbitMQ消息队列节点

前置条件

确保RabbitMQ服务正在运行：

# 使用Docker启动RabbitMQ
docker run -d \
  --name rabbitmq \
  -p 5672:5672 \
  -p 15672:15672 \
  -e RABBITMQ_DEFAULT_USER=admin \
  -e RABBITMQ_DEFAULT_PASS=admin123 \
  rabbitmq:3-management

访问管理界面: http://localhost:15672

步骤1-2: 创建工作流并添加节点

1. 添加开始节点
2. 添加"消息队列"节点
3. 添加结束节点
4. 连接节点

步骤3: 配置消息队列节点

点击消息队列节点，在右侧配置面板中：

1. 选择队列类型: RabbitMQ

2. RabbitMQ配置:

   • 主机地址: localhost (或服务器IP)
   • 端口: 5672
   • 用户名: admin (或您的RabbitMQ用户名)
   • 密码: admin123 (或您的RabbitMQ密码)
   • 队列名称: test_queue
   • Routing Key: test.routing.key (可选)
   • Exchange: (可选，如果使用Exchange)

3. 消息内容:

   {
     "test_key": "{test_key}",
     "test_data": "{test_data}",
     "timestamp": "{timestamp}"
   }
   

步骤4: 保存并运行

1. 保存工作流
2. 运行工作流，输入测试数据：

   {
     "test_key": "Hello RabbitMQ",
     "test_data": "这是测试数据",
     "timestamp": "2024-01-01 12:00:00"
   }
   

3. 查看执行结果

步骤5: 验证结果

1. 访问RabbitMQ管理界面: http://localhost:15672
2. 登录后，进入"Queues"标签
3. 找到 test_queue 队列
4. 点击队列名称，查看消息
5. 确认消息内容正确，变量已替换

📨 测试Kafka消息队列节点

前置条件

确保Kafka服务正在运行（需要Zookeeper）：

# 使用Docker Compose启动Kafka
# 创建 docker-compose-kafka.yml 文件

步骤1-2: 创建工作流并添加节点

1. 添加开始节点
2. 添加"消息队列"节点
3. 添加结束节点
4. 连接节点

步骤3: 配置Kafka节点

点击消息队列节点，在右侧配置面板中：

1. 选择队列类型: Kafka

2. Kafka配置:

   • Bootstrap Servers: localhost:9092 (多个服务器用逗号分隔)
   • Topic: test_topic

3. 消息内容:

   {
     "test_key": "{test_key}",
     "test_data": "{test_data}",
     "timestamp": "{timestamp}"
   }
   

步骤4: 保存并运行

1. 保存工作流
2. 运行工作流，输入测试数据
3. 查看执行结果

步骤5: 验证结果

使用Kafka消费者工具查看消息：

# 使用kafka-console-consumer
kafka-console-consumer --bootstrap-server localhost:9092 --topic test_topic --from-beginning

🔍 测试检查清单

邮件节点

• 节点可以正常添加到画布
• 配置面板所有字段正常显示
• 保存配置成功
• 工作流执行成功
• 邮件成功发送
• 变量替换正确（主题和正文）
• HTML格式邮件正确渲染（如果使用HTML）
• 执行日志显示详细信息

消息队列节点

• 节点可以正常添加到画布
• 可以切换队列类型（RabbitMQ/Kafka）
• 配置面板根据队列类型显示不同字段
• 保存配置成功
• 工作流执行成功
• 消息成功发送到队列/Topic
• 变量替换正确
• 执行日志显示详细信息

🐛 常见问题排查

邮件节点问题

1. SMTP连接失败

   • 检查SMTP服务器地址和端口
   • 确认网络连接正常
   • 检查防火墙设置

2. 认证失败

   • Gmail需要使用应用专用密码，不是普通密码
   • 确认账号已启用"允许不够安全的应用"
   • 检查用户名和密码是否正确

3. 变量未替换

   • 确认输入数据中包含对应的key
   • 检查变量格式：{key} 或 ${key}
   • 查看执行日志确认输入数据

消息队列节点问题

1. RabbitMQ连接失败

   • 确认RabbitMQ服务正在运行
   • 检查主机地址和端口
   • 确认用户名和密码正确
   • 检查网络连接

2. Kafka连接失败

   • 确认Kafka服务正在运行
   • 检查Bootstrap Servers配置
   • 确认Topic已创建
   • 检查网络连接

3. 消息未发送

   • 查看执行日志中的错误信息
   • 检查节点配置是否正确
   • 确认队列/Topic存在

📝 测试数据示例

邮件节点测试数据

{
  "test_key": "Hello World",
  "test_data": "这是测试数据",
  "timestamp": "2024-01-01 12:00:00",
  "user_name": "测试用户",
  "order_id": "12345"
}

消息队列节点测试数据

{
  "test_key": "Hello Queue",
  "test_data": "这是测试数据",
  "timestamp": "2024-01-01 12:00:00",
  "event_type": "user_action",
  "user_id": "12345"
}

🎯 下一步

测试通过后，您可以：

1. 在实际工作流中使用这些节点
2. 继续开发其他功能
3. 优化节点功能和用户体验

---

提示: 如果遇到问题，请查看执行详情页面的日志信息，那里会显示详细的错误信息。