众元AI学习空间

W04_周项目任务书

6分钟阅读

W04 周项目任务书｜商城内嵌单轮 AI 客服入口 v1

企业任务

商城已有商品展示和订单服务，但客户仍需要自己翻页面、猜关键词。产品团队决定在商城页面增加一个“咨询客服”入口：

  1. 用户用自然语言描述商品需求或提出查询；
  2. 模型识别意图和最小参数；
  3. 程序校验后读取 Commerce API；
  4. 商品事实和候选集合由程序决定；
  5. 模型基于这些事实组织一段可核对回答。

商城核心不改造成 LLM 系统。客服入口只是新的消费者，和前端、管理端一样通过稳定合同使用 Commerce API。

最终可演示旅程

主旅程：商品咨询

用户：500 元以内，想买适合通勤的耳机
→ 提取 PRODUCT_ASSISTANCE、数码音频、500.00、通勤
→ 程序过滤在售、品类和预算
→ 按 product_id 返回最多 3 个候选
→ 回答引用候选商品名、价格和匹配理由

失败旅程

  • 缺少品类、预算或用途：提示还需要什么，不猜。
  • 商品不存在或 API 不可用：说明当前无法核对，不编事实。
  • 模型提出未知工具或写操作：执行前阻断。
  • 用户试图改写 customer_id：不影响 Host 注入的模拟上下文。

次要边界旅程

订单只读查询用于练工具参数与 TrustedCustomerContext 一致性。它不是本周产品主叙事，也不代表完成真实登录鉴权。

学生交付

  1. Provider Adapter、独立 Replay 和错误分类；
  2. Prompt V1/V2 控制变量实验；
  3. CustomerIntent / PreferenceSlots 严格 Schema；
  4. 最多一次有限修复及完整失败轨迹；
  5. 以人民币元处理的商品硬筛选；
  6. list_products 主工具（无参数，返回后按品类与预算筛选），以及受限 get_order 边界练习；
  7. 商城客服壳的单轮联调；
  8. 固定评测、本人未见客服变式和 W05 交接；
  9. Learning 与 Portfolio 证据分开的状态表；
  10. performance_evidence.md：同案基线/候选、唯一修改、质量回归、更快但答错的回滚反例、费用口径与来源，并在 W05 交接中关联。

冻结业务规则

  • 只保留 is_active is true 的商品；
  • category 必须相等；
  • unit_price_yuan 小于等于 budget_max_yuan；
  • 按 product_id 升序；
  • 最多 3 个候选；
  • 价格、库存、在售状态和候选集合不由模型修改；
  • 无候选时继续澄清，不凭空生成商品。

完成定义

企业中常用 DoD，完整写法是 Definition of Done，可以理解为“做到什么程度才算完成”。

本周 DoD：

  • 正常商品咨询能返回可沿 product_id 核对的回答；
  • Prompt、Schema、筛选器、控制器、工具和 API 的职责可解释；
  • 坏结构、未知工具、写请求、模拟上下文不一致、Provider/API 故障都有明确终点；
  • Replay 能完成 Learning Gate（课堂学习验收要求）；
  • 真实模型和真实本地 API 分别记录 Passed/Pending/Failed；
  • 每人独立新增一条未见客服表达，先写期望和失败，再做最小修复；
  • 必须完成一次最小观测优化闭环，能解释接受或回滚；性能指标改善但事实、Schema 或工具边界退化时不得接受；
  • 不宣称真实鉴权、推荐算法、购买概率或转化提升。

AI 协作要求

允许让 AI：

  • 解释官方字段；
  • 生成一个函数或一个测试的候选；
  • 分析 ValidationError；
  • 提出 Prompt V2 的修改建议。

不允许：

  • 直接索取或粘贴完整周项目；
  • 不看 diff 就合并；
  • 用硬编码 Fixture 结果通过模型评测；
  • 删除失败测试；
  • 把 Replay 改名为真实请求；
  • 把 API Key 写进代码、提交或截图。

作品说明

只有真实 Portfolio Gate（作品集验收要求） 通过后，才可以按本人证据描述：

为电商商城实现单轮 AI 客服入口，使用可替换 Provider、结构化意图、确定性商品筛选和受控只读工具，把自然语言问题与商城商品事实连接起来。

仍为 Pending 时，应写成“完成 Replay/Fixture 机制验证，真实模型或真实 API 待补验”。

反向链接