跳至正文
← 全部技术洞察

TECHNICAL INSIGHTS / 技术洞察

AI Agent需求文档怎么写?从业务描述到可验收的任务清单

用任务描述代替功能口号

“支持智能问答、智能分析、自动执行”只描述能力名称,不能说明项目边界。需求应从使用者与目标出发,例如“售后人员输入故障描述后,系统从授权手册中查找依据,生成带引用的处理建议”。

随后写明触发条件、必要输入、期望输出与结束条件。对于多轮交互,注明哪些字段允许推断,哪些必须询问用户,哪些必须从业务系统获取,避免开发团队自行猜测。

每项任务需要一张说明卡

说明卡可包含任务编号、使用角色、业务步骤、数据来源、工具列表、权限、成功条件和异常分支。输出应区分自由文本、结构化草稿与正式业务操作,分别约定校验方式。

以工单助手为例,型号、问题描述和联系方式可能是必要字段;无法确认型号时应继续询问,不能随意补值。创建成功应返回正式工单编号,结果未知应提示核查,不能统一显示“提交完成”。

资料与权限要写到可执行程度

列出知识源、更新负责人、生效规则和允许访问人群。不要只写“对接知识库”,还要说明旧版本如何处理、引用能否打开,以及不同用户是否能够看到同一份资料。

工具接口需说明调用身份、参数来源、可用环境和业务错误。对于写入,明确确认节点、幂等要求、撤销或对账方式。权限控制由服务端落实,提示词只能辅助表达行为边界。

验收样本应与需求同步形成

每个任务准备正常、有歧义、缺字段、无答案、越权及接口失败样本,写明参考依据和允许行为。知识问答可以接受不同表达,但结论、条件和引用必须满足规则;不能只用完全相同的文本匹配评分。

性能与费用要求要说明并发、资料规模、任务长度、测试环境和统计口径。像“回答很快”“准确率高”这样的描述,应转化为待协商的指标,而不是在开发结束后才决定。

一张任务卡怎样关联验收

任务卡可以写成“售后人员生成工单草稿,必填产品编号和问题描述,未确认不得提交”。随后对应正常、缺编号、跨客户和超时用例,分别约定应展示草稿、询问、拒绝和待核查。这样业务规则、开发实现与测试使用同一编号关联。需求变化为自动提交时,需要重新确认授权与防重,而不是只删除确认按钮。

  • 输入来源和必填字段是否明确。
  • 预期输出是否区分草稿与正式记录。
  • 异常路径是否有可观察结果。
  • 变更是否同步修改验收样本。

管理范围与变化

需求文档还应列出明确排除项、客户配合事项、交付物和变更流程。新增一个系统接口,或将“生成建议”改为“自动提交”,可能影响架构、权限与测试,不应当作简单文案修改。

文档无需一开始就写得庞大,但要有版本与决策记录。业务人员能够确认任务,开发人员能够判断实现边界,测试人员能够据此编写用例,才算具备可执行的需求基础。

相关阅读:企业上线AI Agent前,需要准备哪些数据、接口和人员。