做一个 AI 导购或智能客服，客户需要提供哪些资料和接口？

Question

Accepted Answer

结论：AI 导购或智能客服上线前，客户至少要提供四类资料——商品、交易与售后规则、真实对话、品牌及合规口径；以及七类接口——商品、实时价格、库存、订单、物流、会员和工单。资料不完整时先做只读 FAQ，不开放报价、下单或售后动作。

演示型客服只需几份商品介绍，生产系统却要回答“现在多少钱、有没有货、我的订单在哪、能不能退”。这些答案会随用户、时间和渠道变化，不能写进提示词或静态知识库，必须从权威业务系统实时查询。哪些内容用文档、哪些用接口，是启动前最重要的边界。

资料清单与用途

资料	必备字段或内容	用于什么	负责人
商品主数据	SKU、名称、规格、属性、适用人群、图片与上下架状态	检索、比较和推荐	商品运营
价格与促销规则	渠道价、会员价、有效期、叠加与排除条件	防止错报价格与优惠	电商 / 财务
交易与售后政策	运费、发货、退换、保修、发票和异常处理	回答政策并判断转人工	客服负责人
历史对话	脱敏后的高频、投诉、失败和转人工对话	建评测集与真实话术	客服质检
品牌与合规口径	语气、禁用承诺、敏感品类、竞品规则	限制夸大和不当表达	品牌 / 法务

每份资料标记版本、所有者、生效日期和适用渠道。同一活动在 App、门店和小程序规则不同，不能合并成一个答案。过期促销、旧退货政策和未经批准的优秀客服话术应从默认知识库中排除。

接口	最低能力	只读还是写入	上线前必须测试
商品、价格、库存	按 SKU 和渠道查询实时状态	只读	无货、下架、价格过期和接口超时
订单与物流	经身份校验查询本人订单和轨迹	只读	越权查询、拆单、退款中和无物流
会员	等级、权益和必要画像	只读为主	最小字段、授权和过期身份
购物车 / 下单	生成草稿、加购或跳转结算	写入	幂等、价格二次确认和失败回滚
售后工单	创建、补充、转人工和查询状态	写入	重复建单、附件、分派和 SLA

API 文档应包含鉴权、字段字典、错误码、限流、超时、幂等、测试环境和负责人。若暂时没有接口，可用定期商品导出做 FAQ 和推荐原型，但必须展示数据更新时间，不能假装实时。订单和会员数据必须在用户身份校验后查询，模型不能自行判断用户是谁。

首期范围	需要的资料与接口	风险	建议
FAQ 客服	有效资料、历史问题、转人工	不能回答个人订单和实时状态	资料未齐时先做
导购助手	商品、价格、库存、品牌规则	错价、无货推荐、夸大宣传	接口稳定后开放
可执行客服 Agent	订单、会员、购物车和工单写接口	越权、重复操作、错误售后	逐个动作加确认与额度

评测集覆盖高频、模糊需求、商品不可售、促销冲突、超范围咨询、投诉、越权和提示词注入。统计事实正确率、推荐可售率、价格库存一致率、有效引用、转人工准确率、工具成功率、重复写入、P95 延迟和转化指标。转化提升不能以隐藏限制或误导用户为代价。

滚水科技会先与商品、客服、IT 和法务共同确认资料及接口缺口，再设计“检索商品—校验价格库存—解释推荐—加购或转人工”的受控流程。交付包括资料后台、客服入口、接口日志、人工工作台和评测报告；不在实时接口缺失时承诺全自动导购。

涉及医疗、保健、金融等受监管商品时，还需由客户法务确认具体广告、推荐和披露要求。