Files
Enterprise-Knowledge-Base/TEST_AGENT_CONFIG.md
T

334 lines
6.9 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.
# 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 中的常见问题部分