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