Agent Requirement Analyzer
飞书文档写入位置
知识库: 7616288931050507220
节点: 效果评测/需求分析报告
wiki_node: Eq5MwsZEpiKlP7kXzPFc8Uptnye
核心功能
分析 AI 智能体平台的需求文档,提取测试需求、功能点、交互场景、边界条件,并识别需求中的待确认项(不明确、缺失、矛盾的地方)。
When to Run
- 用户提供智能体平台的需求文档、PRD、用户故事
- 涉及智能体创建、配置、发布、对话测试等功能
- 用户要求"分析测试需求"或"提取测试点"
- 需要识别需求中的待确认项和缺失信息
Workflow
- 解析需求文档,识别智能体平台的核心功能模块
- 按智能体生命周期提取测试需求
- 识别需求中的待确认项(不明确、缺失、矛盾的地方)
- 输出结构化需求分析报告(含待确认项清单)
待确认项识别指南
在分析需求时,重点关注以下类型的待确认项:
1. 缺失的关键信息
- 未明确的数值限制(长度、大小、数量等)
- 未定义的枚举值(状态、类型、选项等)
- 未说明的异常处理逻辑
- 未提及的权限控制规则
2. 不明确的描述
- 模糊的形容词("大量"、"快速"、"及时"等)
- 未量化的性能指标
- 未定义的业务规则
- 未说明的默认值
3. 矛盾的需求
- 不同章节描述不一致
- 功能与性能要求冲突
- 用户体验与技术实现矛盾
4. 待决策事项
- 需要产品方确认的功能范围
- 需要业务方确认的规则逻辑
- 需要技术方确认的实现方案
核心功能模块识别
模块 1:智能体创建与配置
| 子功能 | 需求描述 | 测试关注点 |
|---|
| -------- | ---------- | ----------- |
| 基本信息配置 | 名称、描述、头像设置 | 必填校验、字符限制、特殊字符、重复名称 |
| 角色设定 | 系统提示词、角色定义 | 长度限制、格式校验、多语言支持 |
| 模型选择 | 基础模型、嵌入模型选择 | 模型列表展示、默认值、切换生效 |
| 知识库绑定 | 上传文档、选择知识库 | 文件格式、大小限制、绑定/解绑 |
| 工具配置 | 插件、Skills 启用 | 工具列表、启用/禁用、参数配置 |
模块 2:智能体发布与版本管理
| 子功能 | 需求描述 | 测试关注点 |
|---|
| -------- | ---------- | ----------- |
| 版本发布 | 创建版本、版本号管理 | 版本号格式、自动递增、发布前校验 |
| 版本回滚 | 回滚到历史版本 | 回滚后配置恢复、运行状态验证 |
| 版本对比 | 对比不同版本差异 | 差异展示、字段对比 |
| 发布审核 | 审核流程(如有) | 提交审核、审核通过/驳回、通知 |
模块 3:智能体调用与对话
| 子功能 | 需求描述 | 测试关注点 |
|---|
| -------- | ---------- | ----------- |
| 对话接口 | API 调用、流式/非流式 | 请求格式、认证鉴权、超时处理 |
| 对话测试 | Web 端对话测试窗 | 消息发送、回复展示、多轮对话 |
| 上下文管理 | 对话历史、记忆长度 | 上下文截断、记忆持久化 |
| 多模态输入 | 图片、文件上传 | 格式支持、大小限制、内容识别 |
模块 4:智能体监控与运维
| 子功能 | 需求描述 | 测试关注点 |
|---|
| -------- | ---------- | ----------- |
| 调用统计 | 调用次数、Token 消耗 | 数据准确性、实时性、图表展示 |
| 日志查询 | 调用日志、错误日志 | 日志完整性、检索功能、导出 |
| 告警配置 | 异常告警、阈值设置 | 告警触发、通知方式、恢复通知 |
智能体类型识别
根据需求识别智能体类型,不同类型有不同测试重点:
| 智能体类型 | 特点 | 测试重点 |
|---|
| ----------- | ------ | ---------- |
| 对话助手 | 通用问答、聊天陪伴 | 多轮对话、意图识别、回复质量 |
| 任务执行型 | 调用工具、执行动作 | 工具调用准确性、参数解析、异常处理 |
| 知识问答型 | 基于知识库回答 | 知识检索准确性、引用来源、未知回答 |
| 代码生成型 | 生成代码、调试 | 代码质量、语言支持、执行安全 |
输出格式
需求分析报告
1. 项目概述
- 平台名称:{platform_name}
- 版本:{version}
- 核心能力:{core_capabilities}
2. 功能模块清单
| 模块 | 优先级 | 功能点数量 | 预估测试工作量 |
|---|
| ------ | -------- | ----------- | --------------- |
| 智能体创建与配置 | P0 | {count} | {days}人天 |
| 版本发布管理 | P0 | {count} | {days}人天 |
| 对话调用 | P0 | {count} | {days}人天 |
| 监控运维 | P1 | {count} | {days}人天 |
3. 需求点详细拆解
{按模块逐一列出需求点及测试关注点}
4. 交互场景分析
| 场景 | 触发条件 | 涉及模块 | 数据流转 | 测试要点 |
|---|
| ------ | ---------- | ---------- | ---------- | ---------- |
| 创建智能体 | 用户填写配置并保存 | 创建配置 | 前端→后端→数据库 | 各字段校验、保存成功、列表展示 |
| 发布智能体 | 点击发布按钮 | 版本管理 | 生成版本→更新状态 | 版本号生成、状态变更、调用生效 |
| 对话调用 | API 请求 | 调用接口 | 请求→模型调用→返回 | 响应格式、流式输出、错误处理 |
5. 边界条件与异常场景
| 功能 | 边界条件 | 异常场景 |
|---|
| ------ | ---------- | ---------- |
| 名称字段 | 长度 1-50 字符 | 空值、超长、特殊字符、emoji、重复 |
| 角色设定 | 长度 0-10000 字符 | 超长、格式错误、注入攻击 |
| 知识库上传 | 单文件≤10MB | 格式不支持、空文件、超大文件、并发上传 |
| 对话调用 | Token≤4096 | 超长上下文、并发请求、超时 |
6. 待确认项清单(关键!)
待确认项是指需求文档中不明确、缺失、矛盾或需要进一步澄清的地方。
| 序号 | 待确认项 | 所属模块 | 问题描述 | 建议确认内容 | 优先级 |
|---|
| ------ | --------- | --------- | --------- | ------------- | -------- |
| 1 | 角色设定长度限制 | 智能体创建 | 需求未明确角色设定最大长度 | 确认最大字符数(如10000字符) | P0 |
| 2 | 知识库文件格式 | 知识库绑定 | 需求未列出支持的文件格式 | 确认支持格式(PDF/DOCX/TXT等) | P0 |
| 3 | 版本号规则 | 版本发布 | 需求未说明版本号生成规则 | 确认版本号格式(如v1.0.0) | P0 |
| 4 | 对话超时时间 | 对话调用 | 需求未明确API超时时间 | 确认超时阈值(如30秒) | P0 |
| 5 | 并发用户限制 | 性能需求 | 需求未说明最大并发数 | 确认并发上限(如100用户) | P1 |
| 6 | 数据保留期限 | 监控运维 | 需求未说明日志保留时间 | 确认保留期限(如30天) | P1 |
待确认项分类:
- 🔴 缺失信息:需求中完全未提及的关键信息
- 🟡 不明确:描述模糊,存在多种理解可能
- 🟠 矛盾:不同地方描述不一致
- 🔵 待决策:需要产品/业务方决策的事项
处理建议:
- 将待确认项整理后发送给产品经理/需求方
- 在需求评审会议上逐一确认
- 确认后更新需求文档和测试用例
- 未确认的需求点标记为风险,预留测试时间
7. 数据流分析
graph LR
A[用户操作] --> B[前端]
B --> C[API 网关]
C --> D[智能体服务]
D --> E[模型服务]
D --> F[知识库服务]
D --> G[工具服务]
D --> H[数据库]
E --> D
F --> D
G --> D
D --> C
C --> B
B --> I[用户]