334 lines
6.9 KiB
Markdown
334 lines
6.9 KiB
Markdown
# Agent 配置功能测试指南
|
||
|
||
## 快速测试步骤
|
||
|
||
### 准备工作
|
||
|
||
1. **确保数据库已迁移**
|
||
|
||
```bash
|
||
# MySQL
|
||
mysql -h localhost -u root -p weknora < migrations/mysql/02-add-agent-support.sql
|
||
|
||
# 或 PostgreSQL
|
||
psql -h localhost -U postgres -d weknora -f migrations/paradedb/02-add-agent-support.sql
|
||
```
|
||
|
||
2. **启动后端服务**
|
||
|
||
```bash
|
||
cd /Users/wizard/code/go/src/git.woa.com/wxg-prc/WeKnora
|
||
go run cmd/server/main.go
|
||
```
|
||
|
||
3. **启动前端服务**
|
||
|
||
```bash
|
||
cd /Users/wizard/code/go/src/git.woa.com/wxg-prc/WeKnora/frontend
|
||
npm run dev
|
||
```
|
||
|
||
### 测试场景
|
||
|
||
#### 场景 1:Agent 配置保存到后台
|
||
|
||
**步骤:**
|
||
|
||
1. 打开浏览器访问:`http://localhost:5173`(或前端服务地址)
|
||
2. 导航到 **设置** 页面
|
||
3. 在 **Agent 智能问答模式** 区域:
|
||
- 打开 Agent 模式开关
|
||
- 设置最大推理步数为 `8`
|
||
- 调整温度参数为 `0.8`
|
||
- 选择允许的工具
|
||
4. 点击 **保存配置** 按钮
|
||
5. 验证提示"配置保存成功"
|
||
|
||
**验证:**
|
||
|
||
- 打开浏览器开发者工具(F12)
|
||
- 查看 Network 标签,找到 `PUT /api/v1/tenants/1/agent-config` 请求
|
||
- 验证请求状态为 200
|
||
- 查看响应内容确认配置已保存
|
||
|
||
**数据库验证:**
|
||
|
||
```sql
|
||
SELECT agent_config FROM tenants WHERE id = 1;
|
||
```
|
||
|
||
预期输出类似:
|
||
```json
|
||
{
|
||
"enabled": true,
|
||
"max_iterations": 8,
|
||
"temperature": 0.8,
|
||
"allowed_tools": ["knowledge_search", "multi_kb_search", "list_knowledge_bases"],
|
||
...
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
#### 场景 2:刷新页面后配置保持
|
||
|
||
**步骤:**
|
||
|
||
1. 完成场景 1 的配置保存
|
||
2. 刷新浏览器页面(F5)
|
||
3. 再次进入 **设置** 页面
|
||
|
||
**验证:**
|
||
|
||
- Agent 模式开关保持启用状态
|
||
- 最大推理步数显示为 `8`
|
||
- 温度参数显示为 `0.8`
|
||
- 工具选择保持不变
|
||
|
||
---
|
||
|
||
#### 场景 3:快速切换按钮功能
|
||
|
||
**步骤:**
|
||
|
||
1. 导航到对话页面(选择任意知识库和会话)
|
||
2. 观察输入框左下角的机器人图标 🤖
|
||
3. 点击机器人图标
|
||
|
||
**验证:**
|
||
|
||
- **初始状态(禁用):**
|
||
- 图标灰色,半透明
|
||
- 悬停时背景变浅蓝色
|
||
|
||
- **点击后(启用):**
|
||
- 图标变为彩色
|
||
- 有呼吸动画效果
|
||
- 显示提示"Agent 智能模式已启用"
|
||
- 页面顶部出现 "Agent 智能模式" 指示器(绿色标签)
|
||
|
||
- **再次点击(禁用):**
|
||
- 图标变回灰色
|
||
- 显示提示"Agent 智能模式已禁用"
|
||
- 顶部指示器消失
|
||
|
||
---
|
||
|
||
#### 场景 4:Agent 模式对话测试
|
||
|
||
**步骤:**
|
||
|
||
1. 在对话页面,确保 Agent 模式已启用(机器人图标彩色)
|
||
2. 输入一个复杂问题,例如:
|
||
```
|
||
请对比文档 A 和文档 B 的核心观点,并给出详细分析
|
||
```
|
||
3. 发送消息
|
||
|
||
**验证:**
|
||
|
||
- 能看到 Agent 的思考过程(thinking steps)
|
||
- 显示工具调用过程(tool calls)
|
||
- 最终给出综合答案
|
||
- 请求 URL 为 `/api/v1/agent-chat/:session_id`(而非 `/api/v1/knowledge-chat`)
|
||
|
||
**对比测试:**
|
||
|
||
1. 禁用 Agent 模式(点击机器人图标)
|
||
2. 发送相同的问题
|
||
3. 验证使用普通 QA 模式(直接返回答案,无思考步骤)
|
||
4. 请求 URL 为 `/api/v1/knowledge-chat/:session_id`
|
||
|
||
---
|
||
|
||
#### 场景 5:UI 样式验证
|
||
|
||
**设置页面样式:**
|
||
|
||
- ✅ 页面标题左侧有绿色竖线装饰
|
||
- ✅ 配置区域使用浅绿色渐变背景
|
||
- ✅ Agent 配置区域有绿色左边框
|
||
- ✅ 主按钮使用绿色渐变 (#07c05f → #00a651)
|
||
- ✅ 按钮悬停时有上浮动画效果
|
||
- ✅ 表单输入框聚焦时有绿色边框和阴影
|
||
|
||
**输入框样式:**
|
||
|
||
- ✅ 机器人图标位于左下角
|
||
- ✅ 禁用时灰色半透明
|
||
- ✅ 启用时彩色有动画
|
||
- ✅ 悬停时有缩放效果
|
||
|
||
---
|
||
|
||
## 常见问题排查
|
||
|
||
### 问题 1:保存配置时出现 404 错误
|
||
|
||
**原因:** 后端路由未正确注册
|
||
|
||
**排查:**
|
||
```bash
|
||
# 检查后端日志,确认路由是否注册
|
||
curl -X GET http://localhost:8080/api/v1/tenants/1/agent-config
|
||
```
|
||
|
||
**解决:** 重新编译并启动后端服务
|
||
|
||
---
|
||
|
||
### 问题 2:刷新后配置丢失
|
||
|
||
**原因:** 可能只保存到 localStorage,未保存到后端
|
||
|
||
**排查:**
|
||
```sql
|
||
-- 查询数据库
|
||
SELECT agent_config FROM tenants WHERE id = 1;
|
||
```
|
||
|
||
**解决:** 确保 `onSubmit` 方法中调用了 `updateAgentConfig` API
|
||
|
||
---
|
||
|
||
### 问题 3:快速切换按钮不显示
|
||
|
||
**原因:** 前端代码未更新或缓存问题
|
||
|
||
**排查:**
|
||
```bash
|
||
# 检查 Input-field.vue 是否包含切换按钮代码
|
||
grep -n "answers-input-agent" frontend/src/components/Input-field.vue
|
||
```
|
||
|
||
**解决:**
|
||
1. 清除浏览器缓存
|
||
2. 强制刷新(Ctrl+Shift+R)
|
||
3. 重新构建前端
|
||
|
||
---
|
||
|
||
### 问题 4:Agent 模式不生效
|
||
|
||
**原因:** Session 创建时未传递 Agent 配置
|
||
|
||
**排查:**
|
||
```javascript
|
||
// 浏览器控制台
|
||
console.log(useSettingsStore().isAgentEnabled)
|
||
```
|
||
|
||
**解决:** 确保 `chat/index.vue` 中正确读取 `isAgentEnabled` 状态
|
||
|
||
---
|
||
|
||
## 性能测试
|
||
|
||
### 配置保存性能
|
||
|
||
```bash
|
||
# 测试 API 响应时间
|
||
time curl -X PUT http://localhost:8080/api/v1/tenants/1/agent-config \
|
||
-H "Content-Type: application/json" \
|
||
-d '{
|
||
"enabled": true,
|
||
"max_iterations": 5,
|
||
"temperature": 0.7,
|
||
"allowed_tools": ["knowledge_search"]
|
||
}'
|
||
```
|
||
|
||
预期响应时间:< 100ms
|
||
|
||
---
|
||
|
||
### 配置读取性能
|
||
|
||
```bash
|
||
# 测试 API 响应时间
|
||
time curl -X GET http://localhost:8080/api/v1/tenants/1/agent-config
|
||
```
|
||
|
||
预期响应时间:< 50ms
|
||
|
||
---
|
||
|
||
## 浏览器兼容性测试
|
||
|
||
- ✅ Chrome/Edge (最新版)
|
||
- ✅ Firefox (最新版)
|
||
- ✅ Safari (最新版)
|
||
|
||
---
|
||
|
||
## 测试完成清单
|
||
|
||
- [ ] 场景 1:Agent 配置保存到后台
|
||
- [ ] 场景 2:刷新页面后配置保持
|
||
- [ ] 场景 3:快速切换按钮功能
|
||
- [ ] 场景 4:Agent 模式对话测试
|
||
- [ ] 场景 5:UI 样式验证
|
||
- [ ] 数据库迁移成功
|
||
- [ ] 后端 API 正常响应
|
||
- [ ] 前端页面正常显示
|
||
- [ ] 浏览器控制台无错误
|
||
- [ ] 所有配置正确保存和加载
|
||
|
||
---
|
||
|
||
## 测试报告模板
|
||
|
||
```markdown
|
||
## Agent 配置功能测试报告
|
||
|
||
**测试日期:** YYYY-MM-DD
|
||
**测试人员:** [姓名]
|
||
**环境:** [开发/测试/生产]
|
||
|
||
### 测试结果
|
||
|
||
| 场景 | 状态 | 备注 |
|
||
|------|------|------|
|
||
| Agent 配置保存 | ✅ / ❌ | |
|
||
| 配置持久化 | ✅ / ❌ | |
|
||
| 快速切换按钮 | ✅ / ❌ | |
|
||
| Agent 模式对话 | ✅ / ❌ | |
|
||
| UI 样式 | ✅ / ❌ | |
|
||
|
||
### 发现的问题
|
||
|
||
1. [问题描述]
|
||
- **严重程度:** 高/中/低
|
||
- **重现步骤:** ...
|
||
- **预期结果:** ...
|
||
- **实际结果:** ...
|
||
|
||
### 建议改进
|
||
|
||
1. [改进建议]
|
||
|
||
### 总体评价
|
||
|
||
[整体功能评价]
|
||
```
|
||
|
||
---
|
||
|
||
## 下一步
|
||
|
||
完成测试后,如果一切正常,可以:
|
||
|
||
1. 提交代码到版本控制
|
||
2. 创建 Pull Request
|
||
3. 通知团队进行 Code Review
|
||
4. 部署到测试环境
|
||
5. 准备发布说明
|
||
|
||
---
|
||
|
||
**注意事项:**
|
||
- 测试过程中请记录所有错误和警告信息
|
||
- 截图保存关键步骤和结果
|
||
- 如有问题,请查看 AGENT_CONFIG_DEPLOYMENT.md 中的常见问题部分
|
||
|