aiagent/节点测试功能说明.md

# 节点测试功能使用说明

## ✅ 已修复的问题

1. **输出为 null 的问题**：
   - 修复了后端未正确处理节点执行失败的情况
   - 现在会正确显示错误信息，而不是只显示 `null`

2. **错误信息显示**：
   - 改进了错误信息的传递和显示
   - 前端会清晰显示具体的错误原因

## 🔧 配置检查

### DeepSeek API 配置

已在 `docker-compose.dev.yml` 中配置：
```yaml
environment:
  - DEEPSEEK_API_KEY=sk-fdf7cc1c73504e628ec0119b7e11b8cc
  - DEEPSEEK_BASE_URL=https://api.deepseek.com
```

### 验证配置是否生效

1. **检查后端服务状态**：
   ```bash
   docker-compose -f docker-compose.dev.yml ps
   ```

2. **验证 API Key 是否加载**：
   ```bash
   docker-compose -f docker-compose.dev.yml exec backend python -c "from app.core.config import settings; print('DeepSeek API Key:', '已配置' if settings.DEEPSEEK_API_KEY else '❌ 未配置')"
   ```

3. **查看后端日志**：
   ```bash
   docker-compose -f docker-compose.dev.yml logs --tail=50 backend
   ```

## 📝 使用步骤

### 1. 打开 Agent 设计器

1. 登录系统
2. 点击导航栏的"Agent管理"
3. 选择一个 Agent，点击"设计"按钮

### 2. 配置 LLM 节点

1. 点击画布上的 LLM 节点（或添加新节点）
2. 在右侧配置面板中设置：
   - **提供商**: 选择 "DeepSeek"
   - **模型**: 选择 "DeepSeek Chat" 或 "DeepSeek Coder"
   - **提示词**: 输入提示词，例如：`请处理用户请求：{input}`
   - **温度**: 0.5-0.7（推荐）
   - **最大Token数**: 1500（根据需要调整）

3. 点击"保存配置"按钮

### 3. 测试节点

1. 在"节点测试"区域：
   - **测试输入**: 编辑 JSON 格式的测试数据
   - 默认输入示例：
     ```json
     {
       "input": "你好",
       "query": "你好"
     }
     ```

2. 点击"运行测试"按钮

3. 查看测试结果：
   - **测试输出**: 显示 LLM 返回的内容
   - **状态**: 显示成功/失败状态
   - **执行时间**: 显示耗时（毫秒）
   - **错误信息**: 如果失败，会显示具体错误

## 🎯 测试示例

### 示例 1：简单对话

**节点配置**：
- 提供商: DeepSeek
- 模型: DeepSeek Chat
- 提示词: `请回答用户的问题：{input}`

**测试输入**：
```json
{
  "input": "你好，介绍一下你自己"
}
```

**预期输出**：
DeepSeek 的回复内容

### 示例 2：文本处理

**节点配置**：
- 提供商: DeepSeek
- 模型: DeepSeek Chat
- 提示词: `请将以下文本翻译成英文：{input}`

**测试输入**：
```json
{
  "input": "你好，世界"
}
```

**预期输出**：
"Hello, World"

## ⚠️ 常见问题

### 1. 输出为 null

**可能原因**：
- API Key 未配置或配置错误
- 模型名称不匹配
- 网络连接问题
- API 返回空内容

**解决方法**：
1. 检查 `docker-compose.dev.yml` 中的 `DEEPSEEK_API_KEY` 配置
2. 确认模型名称是 `deepseek-chat` 或 `deepseek-coder`
3. 查看后端日志获取详细错误信息
4. 重启后端服务：
   ```bash
   docker-compose -f docker-compose.dev.yml restart backend
   ```

### 2. 显示错误信息

现在如果测试失败，会显示具体的错误信息，例如：
- `DeepSeek API Key未配置，请在环境变量中设置DEEPSEEK_API_KEY`
- `DeepSeek API调用失败: ...`
- `DeepSeek API返回的内容为空，请检查API配置和模型名称`

根据错误信息进行相应的修复。

### 3. 测试超时

如果测试时间过长：
1. 检查网络连接
2. 减少 `max_tokens` 的值
3. 检查 API 服务状态

## 🔄 重启服务

如果修改了配置，需要重启后端服务：

```bash
docker-compose -f docker-compose.dev.yml restart backend
```

## 📊 功能特点

1. **实时测试**：边编排边测试，无需保存即可验证节点功能
2. **输入编辑**：支持自定义 JSON 格式的测试输入
3. **输出查看**：实时查看节点输出结果
4. **错误提示**：清晰的错误信息，便于调试
5. **执行时间**：显示节点执行耗时

## 🎨 界面说明

- **左侧面板**：节点配置和测试区域
  - 节点配置表单
  - 测试输入编辑框
  - 运行测试按钮
  - 测试输出显示框

- **右侧面板**：Agent 预览和测试结果
  - Agent 信息展示
  - 节点测试结果（输入/输出）
  - 实时对话预览

## 💡 提示

1. **测试前保存配置**：建议先点击"保存配置"再测试
2. **输入格式**：确保测试输入是有效的 JSON 格式
3. **多次测试**：可以修改输入数据，多次测试验证不同场景
4. **查看日志**：如果遇到问题，查看后端日志获取详细信息