AI Agent / 系统课时

设计订单助手需求

设计订单助手需求

订单助手上线前最重要的不是先接模型,而是把“能帮用户做什么、能看哪些数据、什么时候必须拒绝”写成可执行约束。本文用一份最小需求清单,把用户目标、数据范围、工具、成功标准和安全边界一次定义清楚。

学习目标

  • 把“查询订单”拆成可验证的用户目标与成功标准
  • 明确助手可访问的数据范围、工具职责和最小权限
  • 为越权查询、敏感信息和高风险操作建立拒绝边界

从用户目标倒推最小能力

先把需求写成用户能感知的结果,而不是“做一个智能客服”。一个可交付的订单助手至少应回答:订单当前状态是什么、关键时间节点是什么、用户下一步能做什么。本期范围为状态查询。退款、改地址和取消订单由正式业务流程处理。

可以用三类典型问题校验范围:“我的订单 ORD-20260904-001 到哪一步了?”“预计什么时候送达?”以及“为什么还没有发货,我现在需要做什么?”这类问题优先使用只读订单事实。若没有可信的预计时间或延迟原因,只能说明该字段当前未提供。

成功标准必须可观察:合法用户能查到自己的订单;不存在或无权访问的订单不泄露内容;上游不可用时说明暂时无法查询,而不是编造订单状态。这样才能把“助手表现不错”转换成可验收条件。

划定数据范围与最小暴露

订单助手只应取得回答问题所需的字段。本项目仅读取订单号、当前状态、状态更新时间和可空的预计送达时间。姓名、手机号和完整地址不在输出契约中,也无需先脱敏再返回。

可以把数据分为三层:回答必需、可选辅助、禁止进入模型上下文。敏感字段优先在工具层裁剪或脱敏,而不是依靠提示词要求模型“不要输出”,因为原始数据一旦进入上下文、日志或后续工具链,就已经扩大了暴露面。

列出工具与职责边界

本期只需要一个只读的 query_order 工具:模型提供订单号,工具从可信会话上下文取得当前用户身份,调用订单服务,完成参数校验、订单归属校验、字段裁剪与脱敏,再把最小结果交给模型。模型负责理解问题和组织回答,不直接访问数据库,也不持有长期服务凭证。

订单助手需求边界图

这条边界还决定了后续扩展方式:如果未来增加取消订单,应新增独立的写工具、二次确认和权限策略,而不是让查询工具顺便接受一个 action 参数执行任意操作。

定义成功、失败与拒绝

真实上线不能只有“成功返回订单”一种结果。合法用户查询自己的有效订单时,可以返回状态、关键时间和下一步建议;订单不存在或当前用户无权访问时,对外统一说明无法查看该订单,避免通过不同错误文案枚举其他用户的订单。

订单服务超时、网络故障或服务端异常属于系统失败,应明确说明当前暂时无法查询并允许稍后重试。对于“查看别人的订单”“输出完整收货地址”“直接帮我取消订单”等超出权限或本期能力的请求,则进入拒绝路径,并给出查询本人订单或进入正式售后流程等安全替代方案。

场景 对用户的行为
查询自己的有效订单 返回最小必要信息和下一步建议
订单不存在或无权访问 统一说明无法查看,不泄露订单是否存在
订单服务异常 说明暂时无法查询,可稍后重试
请求退款、取消或修改地址 拒绝执行并引导到受控业务流程

形成可交付的需求清单

开发前至少确认这些问题都有确定答案:用户能问什么、允许访问哪些字段、工具输入输出是什么、身份从哪里取得、哪些情况必须拒绝、上游失败如何表现,以及什么结果算验收通过。如果其中任何一项仍依赖“让模型自己判断”,需求边界就还不够稳定。

固定本章项目的契约

从结构化请求 {"intent":"order_status","order_id":"ORD-20260904-001"} 开始。后续可以用模型把自然语言转成相同结构,应用仍检查动作和订单号,再使用独立登录态。例子统一使用虚构的 team-a 和 USER-001,状态从本地订单表读取。

验收输入 应观察到的行为
已登录用户查自己的订单 返回本次读取到的状态与更新时间,预计时间缺失时明确说明
订单号合法但不存在、属于其他用户或其他租户 对外统一返回不可查看,不提供订单字段
未登录或试图在请求体传入身份 拒绝,订单查询次数为零
订单库暂时不可读 返回稳定的故障状态,不沿用旧订单或猜测状态
输入要求取消或写入 进入不支持的意图分支,不调用任何业务写工具

第 02 课实现数据访问,第 03 课提供统一业务入口,第 04 课用合成数据执行验收,第 05、06 课再用同一实现部署和诊断。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

设计订单助手需求

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通