PRODUCT REQUIREMENTS DOCUMENT

AI 智能商城导购平台

从商品经营、知识工程到 AI 导购与效果验收的完整产品需求文档。

PRD V1.0AI E-COMMERCERAG + AGENTVue + Spring Boot

1. 项目背景

传统商城能够展示商品，但用户仍需要自己理解参数、比较商品并判断是否适合自己。商品资料又分散在详情、参数、售后和运营文档中，直接交给大模型容易出现知识过期、回答无依据和动态价格库存不准确等问题。

本项目以商品为中心建立可维护的知识与业务闭环：资料进入知识库，经切片和向量化后参与检索；AI 根据意图决定使用知识库还是调用实时工具；每次运行都可追溯并可验收。

2. 产品目标

  1. 让用户用自然语言完成商品咨询和导购决策。
  2. 让 AI 回答有明确商品依据，减少无依据生成。
  3. 让价格、库存等动态信息通过工具实时查询。
  4. 让管理员维护商品、知识、模型、工具和验收用例。
  5. 让每次运行留下输入、输出、工具结果和执行步骤。

3. 用户与权限

USER / 用户端

完成购物决策

浏览商城、查看商品详情、使用 AI 导购、发起商品问答和查看结果。

ADMIN / 管理端

维护业务与 AI

维护商品、知识库、切片、Embedding、模型、工具和验收数据。

TRACE / 可追溯

定位每次运行

查看用户输入、模型输出、工具调用、工具结果、耗时和错误信息。

4. 信息架构

用户端

商城首页 → 分类 / 品牌筛选 → 商品列表 → 商品详情 → AI 导购 / 商品知识问答。

管理端

商城管理、AI 基础配置、AI 知识库、AI 导购与运营、Agent Step 执行步骤、AI 效果验收。

5. 核心业务流程

商品资料维护 → Markdown / 商品详情导入 → 资料清洗
→ 综合知识整理 → 按规则切片 → Embedding 向量化
→ 用户提问 → 意图识别 → RAG 检索或 Function Tool 调用
→ 生成有依据的回答 → 记录 Agent Step → 效果验收与复盘

6. 功能需求

P0 商品与知识底座

功能需求说明验收标准
商品管理维护名称、编号、分类、品牌、价格、库存、图片、卖点、参数和描述。新增、编辑、上下架和查询可用。
Markdown 导入识别商品名称、品牌、分类、价格、库存、卖点、标签、参数、描述和图片地址。上传后自动回填，管理员可修改后保存。
品牌同步导入资料中的新品牌不存在时，支持同步创建品牌。商品保存时品牌可正常关联。
知识切片按商品选择切片，避免重复切分已完成资料。记录商品、序号、标题、内容和状态。
Embedding为可用切片生成向量并记录模型、状态和更新时间。可检索切片有明确向量状态。

P0 AI 导购与商品问答

功能需求说明验收标准
AI 导购识别预算、场景、偏好、品类和约束条件。返回商品来自商城数据，并说明匹配依据。
商品问答问题必须绑定当前商品 productId。优先引用该商品综合资料，不串商品。
RAG 检索根据问题召回相关商品知识切片。结果包含商品和切片来源。
Function Tool价格库存、售后等动态信息通过工具查询。成功返回真实结果，失败明确提示。
范围兜底对天气、量子计算等非商城问题拒答。不编造商品信息，并说明服务范围。

P1 管理与可观测性

功能需求说明验收标准
Agent Step记录输入、输出、工具调用、结果、下一步动作和错误。可按一次运行查看完整链路。
AI 效果验收支持标准用例、关键词评分、人工通过和失败复盘。显示总用例、通过、失败、准确率和结果。

7. AI 工作流

  1. 接收问题并校验必要参数。
  2. 判断导购、商品知识、价格库存、售后或非商城问题。
  3. 商品知识问题进入 RAG 检索；价格库存问题调用 Function Tool。
  4. 导购问题结合商品筛选和知识依据生成推荐。
  5. 非商城问题进入范围兜底，并在执行步骤中记录原因。
回答约束：不凭空创造商品、价格、库存、功效和售后政策；动态数据优先来自工具；无法检索时说明信息不足，不伪造结论。

8. 数据对象

对象作用
Product商品基础资料、价格、库存、分类和品牌。
KnowledgeDocument商品综合知识资料及来源。
KnowledgeChunk切片序号、标题、内容、字数和处理状态。
AgentRun / AgentStep一次运行的整体记录与中间步骤。
AcceptanceCase验收维度、输入、预期、关键词、得分和状态。

9. 效果验收指标

以下为目标口径，用于后续持续评测，不代表所有指标已经达到生产标准。

维度指标目标
RAG相关切片召回准确率≥ 80%
回答商品事实一致性≥ 90%
导购约束条件命中率≥ 85%
工具价格库存调用成功率≥ 95%
兜底非商城问题拒答率100%
可观测性运行步骤完整率100%

10. 版本规划

V1.0 / 基础闭环

商城 + RAG + 工具

商品、知识资料、切片、Embedding、AI 导购、商品问答和价格库存工具。

V1.1 / 可观测验收

记录 + 评测

Agent Step、导购和问答记录、标准验收用例、自动评分和人工确认。

V2.0 / 生产化

稳定性与增长

多轮上下文、反馈闭环、回归测试、监控告警、限流和成本分析。