Agent Testcase Generator#

飞书文档写入位置#

text

知识库: 7616288931050507220
节点: 效果评测/测试用例
wiki_node: FZXtwQd70iFCD3kifibcdBbpnId

⚠️ 强制要求：所有测试用例必须使用标准格式，包含14个必填字段！

When to Run#

• 测试点整理完成后
• 用户提供功能模块或测试点清单
• 需要编写详细测试用例

⚠️ 强制格式要求#

必须包含的14个字段#

1. ✅ 用例标识（编号、名称、模块、需求、优先级、类型、设计人、日期）
2. ✅ 测试目的
3. ✅ 前置条件
4. ✅ 测试数据（输入数据、预置数据）
5. ✅ 执行步骤
6. ✅ 预期结果
7. ✅ 预期结果验证点
8. ✅ 实际结果（执行时填写）
9. ✅ 边界条件
10. ✅ 异常场景
11. ✅ 关联用例
12. ✅ 自动化标记
13. ✅ 数据准备
14. ✅ 执行历史

格式规范#

• 使用 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 作为分隔线
• 使用 📋 作为段落标记
• 预期结果必须可验证、可量化
• 必须包含验证点详细说明

禁止事项#

• ❌ 缺少任何必填字段
• ❌ 预期结果模糊（如"正常显示"）
• ❌ 缺少验证点
• ❌ 使用不可验证的描述

Workflow#

1. 接收测试点清单或功能模块
2. 为每个测试点设计详细的测试步骤
3. 区分功能测试用例和 API 测试用例
4. 设计测试数据（输入数据、预期结果数据）
5. 标记可自动化测试的用例
6. 识别需要数据准备的用例
7. 输出结构化测试用例（含14个必填字段）

测试用例设计规范#

测试用例要素（14个必填）#

要素说明示例用例编号唯一标识TC-CREATE-001用例名称简明描述测试内容创建智能体 - 正常流程所属模块功能模块智能体管理所属需求关联需求IDREQ-001优先级P0/P1/P2P0用例类型功能/接口/UI/性能/安全功能测试目的为什么要测试验证创建功能正确性前置条件执行前必须满足的条件用户已登录、有权限测试数据具体输入数据名称="测试助手"、模型="deepseek-chat"执行步骤可执行的操作步骤1.进入页面 2.输入数据 3.点击按钮预期结果期望的结果（可验证）1.提示成功 2.页面跳转 3.数据正确验证点详细验证点检查点1、检查点2、检查点3边界条件边界值情况最小值、最大值、空值异常场景相关异常名称为空、重复、超长自动化标记是否可自动化✅ 可自动化 / ❌ 手工测试数据准备是否需要预置数据需要预置用户账号

预期结果 vs 实际结果#

预期结果（Expected Result）

• 定义：执行测试步骤后，系统应该产生的正确行为或输出

• 特点：

  • 在测试用例设计时确定
  • 基于需求文档定义
  • 必须可验证、可量化
  • 作为判断测试通过/失败的标准

• 示例：

  • ✅ 页面显示"创建成功"提示
  • ✅ 数据库新增一条记录，name="测试助手"
  • ✅ API返回状态码201，body包含agent_id字段

实际结果（Actual Result）

• 定义：执行测试步骤后，系统实际产生的行为或输出

• 特点：

  • 在测试执行时记录
  • 与预期结果对比判断通过/失败
  • 失败时需要详细记录，便于缺陷定位

• 示例：

  • ✅ 与预期一致：页面显示"创建成功"（测试通过）
  • ❌ 与预期不符：页面显示"系统错误"（测试失败）

结果对比示例

用例预期结果实际结果（通过）实际结果（失败）创建智能体1.提示"创建成功"

2.跳转到列表页1.✅ 提示"创建成功"

2.✅ 跳转到列表页1.❌ 提示"系统错误"

2.❌ 停留在创建页名称为空校验提示"名称不能为空"✅ 提示"名称不能为空"❌ 创建成功，无提示API创建成功返回201，包含agent_id✅ 返回201，agent_id=12345❌ 返回500，body为空

输出格式#

智能体平台测试用例（标准格式）#

模块 1：智能体创建与配置

功能测试用例

text

【测试用例】
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 用例标识
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
用例编号：    TC-CREATE-001
用例名称：    创建智能体-正常流程
所属模块：    智能体管理
所属需求：    REQ-001
优先级：      P0
用例类型：    功能
设计人：      [设计人]
设计日期：    [YYYY-MM-DD]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 测试目的
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
验证智能体创建功能在正常输入下的正确性，确保用户能够成功创建智能体
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 前置条件
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- 用户已登录系统
- 用户有创建智能体的权限
- 网络连接正常
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 测试数据
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
输入数据：
- 名称：测试助手
- 描述：这是一个测试智能体
- 模型：deepseek-chat

预置数据：
- 用户账号已存在
- 模型列表已加载
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 执行步骤
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
1. 进入智能体创建页面
2. 在名称输入框输入"测试助手"
3. 在描述输入框输入"这是一个测试智能体"
4. 在模型选择下拉框选择"deepseek-chat"
5. 点击"创建"按钮
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 预期结果
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- 预期1：页面显示"创建成功"提示
- 预期2：页面自动跳转到智能体列表页
- 预期3：智能体列表中显示新创建的"测试助手"
- 预期4：数据库中新增一条智能体记录，name="测试助手"
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 预期结果验证点
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
验证点1：页面提示验证
- 验证内容：页面显示"创建成功"
- 验证方式：页面元素检查
- 预期值：提示文本等于"创建成功"

验证点2：页面跳转验证
- 验证内容：页面URL变化
- 验证方式：URL检查
- 预期值：URL包含"/agents/list"

验证点3：列表数据验证
- 验证内容：列表显示新智能体
- 验证方式：列表元素检查
- 预期值：列表第一项name="测试助手"

验证点4：数据库验证
- 验证内容：数据库记录
- 验证方式：数据库查询
- 预期值：存在记录，name="测试助手", status="active"
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 实际结果（执行时填写）
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[执行时填写]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 边界条件
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- 名称长度：1-50字符
- 描述长度：0-200字符
- 必填字段：名称、模型
- 选填字段：描述
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 异常场景
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- 异常1：名称为空 → 预期：提示"名称不能为空"
- 异常2：名称重复 → 预期：提示"名称已存在"
- 异常3：名称超长 → 预期：提示"名称长度不能超过50"
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 关联用例
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- 前置用例：TC-LOGIN-001（用户登录）
- 后置用例：TC-CREATE-002（名称为空校验）
- 相关用例：TC-EDIT-001（编辑智能体）
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 自动化标记
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
是否可自动化：  ✅ 是
自动化工具：    Playwright
自动化优先级：  P0
自动化状态：    已完成
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 数据准备
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- [ ] 测试账号准备
- [ ] 测试数据准备
- [ ] 预置数据准备
- [ ] 环境配置准备
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 执行历史
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
| 执行日期 | 执行人 | 执行结果 | 缺陷ID | 备注 |
|----------|--------|----------|--------|------|
| | | | | |
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 备注
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
无
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

API 测试用例

text

【测试用例】
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 用例标识
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
用例编号：    TC-API-001
用例名称：    创建智能体接口-正常请求
所属模块：    智能体管理-API
所属需求：    REQ-API-001
优先级：      P0
用例类型：    接口
设计人：      [设计人]
设计日期：    [YYYY-MM-DD]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 测试目的
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
验证创建智能体接口在正常请求参数下的正确性
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 前置条件
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- 用户已登录，获取有效token
- 用户有创建智能体的权限
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 测试数据
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
请求方法：POST
请求URL：/api/v1/agent
请求头：
- Content-Type: application/json
- Authorization: Bearer {token}

请求体：
{
  "name": "测试助手",
  "description": "这是一个测试智能体",
  "model": "deepseek-chat"
}
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 执行步骤
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
1. 构造请求参数
2. 发送POST请求
3. 接收响应结果
4. 验证响应状态码
5. 验证响应体内容
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 预期结果
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- 预期1：HTTP状态码为201
- 预期2：响应体包含agent_id字段
- 预期3：响应体name字段等于"测试助手"
- 预期4：响应体status字段等于"active"
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 预期结果验证点
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
验证点1：状态码验证
- 验证内容：HTTP状态码
- 验证方式：response.status_code
- 预期值：201

验证点2：响应体字段验证
- 验证内容：agent_id字段存在
- 验证方式：response.json()
- 预期值：agent_id不为空

验证点3：响应体数据验证
- 验证内容：name字段值
- 验证方式：response.json()
- 预期值：name="测试助手"
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 实际结果（执行时填写）
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[执行时填写]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 边界条件
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- 请求体大小：最大10KB
- 字段长度：name最大50字符
- 必填字段：name、model
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 异常场景
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- 异常1：缺少name字段 → 预期：返回400，错误信息"name不能为空"
- 异常2：无效token → 预期：返回401，错误信息"未授权"
- 异常3：重复名称 → 预期：返回409，错误信息"名称已存在"
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 关联用例
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- 前置用例：TC-API-AUTH-001（获取token）
- 后置用例：TC-API-002（缺少必填参数）
- 相关用例：TC-API-GET-001（获取智能体列表）
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 自动化标记
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
是否可自动化：  ✅ 是
自动化工具：    pytest + requests
自动化优先级：  P0
自动化状态：    已完成
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 数据准备
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- [ ] 测试账号准备
- [ ] 获取有效token
- [ ] 预置数据准备
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 执行历史
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
| 执行日期 | 执行人 | 执行结果 | 缺陷ID | 备注 |
|----------|--------|----------|--------|------|
| | | | |