Files
aiagent/测试指南.md
2026-01-19 00:09:36 +08:00

183 lines
4.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 测试指南
## 🚀 快速测试
### 1. 访问前端
打开浏览器访问http://localhost:8038
### 2. 注册/登录
1. 点击"注册"标签
2. 填写用户名、邮箱、密码
3. 点击"注册"按钮
4. 注册成功后自动切换到登录标签
5. 使用刚才注册的账号登录
### 3. 创建工作流
1. 登录后,点击"创建工作流"按钮
2. 进入工作流设计器
3. 从左侧工具箱拖拽节点到画布
4. 连接节点(点击节点的连接点并拖拽到目标节点)
5. 点击节点进行配置
6. 点击"保存"按钮保存工作流
### 4. 执行工作流
1. 在工作流设计器中点击"运行"按钮
2. 或通过API执行
```bash
# 先获取token登录后
curl -X POST http://localhost:8037/api/v1/auth/login \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "username=your_username&password=your_password"
# 执行工作流替换TOKEN和WORKFLOW_ID
curl -X POST http://localhost:8037/api/v1/workflows/{WORKFLOW_ID}/execute \
-H "Authorization: Bearer {TOKEN}" \
-H "Content-Type: application/json" \
-d '{"input": "测试数据"}'
```
### 5. 查看执行结果
1. 在工作流列表页面查看执行历史
2. 或通过API查看
```bash
curl http://localhost:8037/api/v1/executions \
-H "Authorization: Bearer {TOKEN}"
```
## 📋 API测试示例
### 用户注册
```bash
curl -X POST http://localhost:8037/api/v1/auth/register \
-H "Content-Type: application/json" \
-d '{
"username": "testuser",
"email": "test@example.com",
"password": "test123456"
}'
```
### 用户登录
```bash
curl -X POST http://localhost:8037/api/v1/auth/login \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "username=testuser&password=test123456"
```
### 创建工作流
```bash
curl -X POST http://localhost:8037/api/v1/workflows \
-H "Authorization: Bearer {TOKEN}" \
-H "Content-Type: application/json" \
-d '{
"name": "测试工作流",
"description": "这是一个测试工作流",
"nodes": [
{
"id": "node1",
"type": "start",
"position": {"x": 100, "y": 100},
"data": {"label": "开始"}
},
{
"id": "node2",
"type": "llm",
"position": {"x": 300, "y": 100},
"data": {"label": "LLM处理", "prompt": "处理输入: {input}"}
},
{
"id": "node3",
"type": "end",
"position": {"x": 500, "y": 100},
"data": {"label": "结束"}
}
],
"edges": [
{"id": "e1", "source": "node1", "target": "node2"},
{"id": "e2", "source": "node2", "target": "node3"}
]
}'
```
### 执行工作流
```bash
curl -X POST http://localhost:8037/api/v1/workflows/{WORKFLOW_ID}/execute \
-H "Authorization: Bearer {TOKEN}" \
-H "Content-Type: application/json" \
-d '{
"input": "这是测试输入"
}'
```
## 🔍 检查服务状态
### 检查所有服务
```bash
docker-compose -f docker-compose.dev.yml ps
```
### 查看日志
```bash
# 查看所有服务日志
docker-compose -f docker-compose.dev.yml logs -f
# 查看特定服务日志
docker-compose -f docker-compose.dev.yml logs -f backend
docker-compose -f docker-compose.dev.yml logs -f frontend
docker-compose -f docker-compose.dev.yml logs -f celery
```
### 健康检查
```bash
# 后端健康检查
curl http://localhost:8037/health
# 应该返回: {"status":"healthy"}
```
## 🐛 常见问题
### 1. 前端无法访问
- 检查前端服务是否运行:`docker-compose ps`
- 检查端口8038是否被占用
- 查看前端日志:`docker-compose logs frontend`
### 2. API请求失败
- 检查后端服务是否运行
- 检查JWT Token是否有效
- 查看后端日志:`docker-compose logs backend`
### 3. 工作流执行失败
- 检查Celery Worker是否运行`docker-compose logs celery`
- 检查Redis连接是否正常
- 查看执行记录的error_message字段
### 4. 数据库连接失败
- 检查数据库连接信息是否正确
- 确认服务器能访问腾讯云MySQL
- 检查网络连接
## 📝 下一步
完成基础功能测试后,可以继续开发:
1. OpenAI模型真实集成
2. WebSocket实时推送
3. 更多节点类型
4. 执行结果可视化