Agent Requirement Analyzer#

飞书文档写入位置#

text

知识库: 7616288931050507220
节点: 效果评测/需求分析报告
wiki_node: Eq5MwsZEpiKlP7kXzPFc8Uptnye

核心功能#

分析 AI 智能体平台的需求文档，提取测试需求、功能点、交互场景、边界条件，并 识别需求中的待确认项（不明确、缺失、矛盾的地方）。

When to Run#

• 用户提供智能体平台的需求文档、PRD、用户故事
• 涉及智能体创建、配置、发布、对话测试等功能
• 用户要求"分析测试需求"或"提取测试点"
• 需要识别需求中的待确认项和缺失信息

Workflow#

1. 解析需求文档，识别智能体平台的核心功能模块
2. 按智能体生命周期提取测试需求
3. 识别需求中的待确认项（不明确、缺失、矛盾的地方）
4. 输出结构化需求分析报告（含待确认项清单）

待确认项识别指南#

在分析需求时，重点关注以下类型的待确认项：

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字符）P02知识库文件格式知识库绑定需求未列出支持的文件格式确认支持格式（PDF/DOCX/TXT等）P03版本号规则版本发布需求未说明版本号生成规则确认版本号格式（如v1.0.0）P04对话超时时间对话调用需求未明确API超时时间确认超时阈值（如30秒）P05并发用户限制性能需求需求未说明最大并发数确认并发上限（如100用户）P16数据保留期限监控运维需求未说明日志保留时间确认保留期限（如30天）P1

待确认项分类：

• 🔴 缺失信息：需求中完全未提及的关键信息
• 🟡 不明确：描述模糊，存在多种理解可能
• 🟠 矛盾：不同地方描述不一致
• 🔵 待决策：需要产品/业务方决策的事项

处理建议：

1. 将待确认项整理后发送给产品经理/需求方
2. 在需求评审会议上逐一确认
3. 确认后更新需求文档和测试用例
4. 未确认的需求点标记为风险，预留测试时间

7. 数据流分析

Rendering diagram...