Files
Enterprise-Knowledge-Base/TEST_AGENT_CONFIG.md
T

6.9 KiB
Raw Blame History

Agent 配置功能测试指南

快速测试步骤

准备工作

  1. 确保数据库已迁移

    # 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. 启动后端服务

    cd /Users/wizard/code/go/src/git.woa.com/wxg-prc/WeKnora
    go run cmd/server/main.go
    
  3. 启动前端服务

    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
  • 查看响应内容确认配置已保存

数据库验证:

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. 完成场景 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 错误

原因: 后端路由未正确注册

排查:

# 检查后端日志,确认路由是否注册
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

解决:

  1. 清除浏览器缓存
  2. 强制刷新(Ctrl+Shift+R)
  3. 重新构建前端

问题 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. [改进建议]

### 总体评价

[整体功能评价]

下一步

完成测试后,如果一切正常,可以:

  1. 提交代码到版本控制
  2. 创建 Pull Request
  3. 通知团队进行 Code Review
  4. 部署到测试环境
  5. 准备发布说明

注意事项:

  • 测试过程中请记录所有错误和警告信息
  • 截图保存关键步骤和结果
  • 如有问题,请查看 AGENT_CONFIG_DEPLOYMENT.md 中的常见问题部分