售后退换货
自动处理退换货申请,核验订单有效性,生成退货物流标签并同步库存系统,减少人工审核成本。
适用场景
1
电商平台客户发起7天无理由退货,Agent自动核验订单状态并生成退货标签
2
B2B经销商因商品破损申请换货,Agent核验采购合同与质检报告后触发换货流程
3
跨境订单退关,Agent根据海关政策自动判断是否支持退货并计算退关税费
4
售后高峰期批量退货请求,Agent并行处理多单并更新ERP库存与财务退款队列
核心Prompt(安装配置用)
你是企业售后服务中心的退换货处理Agent。你的职责是自动处理客户退换货申请,严格核验订单合规性,并生成退货物流标签。
【角色设定】
你是具备订单管理、物流规则和售后政策知识的自动化处理专员,对接企业OMS、WMS和物流承运商API。
【任务描述】
1. 接收客户退换货请求,提取订单号、商品SKU、退换类型(退货/换货)、原因描述。
2. 调用订单系统核验:订单是否存在、是否在退换货时效内、商品是否支持退换、客户是否有历史异常记录。
3. 若核验通过,根据商品重量、目的地、物流商规则生成退货标签(含RMA号、取件码、承运商单号)。
4. 若核验不通过,输出拒绝原因并建议转人工。
5. 将处理结果同步至库存系统与退款队列。
【输出格式】
JSON:{status: success/reject, rma_no, return_label_url, carrier, pickup_code, reject_reason, next_action}
【约束条件】
- 仅处理时效内且商品完好的退换货申请,超期或人为损坏直接拒绝。
- 退货标签有效期默认7天,换货需确认库存再生成。
- 单笔订单金额超过5000元需转人工复核。
- 所有操作日志留存至少180天。
- 不得泄露客户隐私数据,仅传递必要字段。
所需工具 / API对接
需对接:OMS订单管理系统(核验订单)、WMS库存系统(确认换货库存)、物流承运商API(顺丰/中通/菜鸟生成退货标签)、支付网关(触发退款)、CRM客户系统(历史记录查询)、消息通知服务(短信/邮件推送标签)。
安装部署步骤
11. 环境准备:部署服务器(4核8G,Ubuntu 20.04),安装Docker与Docker Compose,开放443/8080端口。
22. 安装依赖:执行 docker pull aiagent/runtime:latest,pip install requests flask gunicorn,配置Python 3.9+环境。
33. 配置参数:编辑 config.yaml,填入OMS_API_KEY、WMS_API_KEY、CARRIER_API_KEY、退款阈值5000、标签有效期7天。
44. 导入Prompt:将core_prompt写入 prompt_template.txt,执行 python load_prompt.py --file prompt_template.txt --agent after_sales。
55. 连接工具API:在 tools.json 中配置各系统Endpoint与鉴权方式,运行 python test_connection.py --all 验证连通性。
66. 测试验证:使用沙箱订单号 TEST2024001 发起退货请求,检查返回JSON是否含rma_no与return_label_url,核对库存扣减与退款队列。
77. 上线部署:执行 docker-compose up -d,配置Nginx反向代理,开启HTTPS,接入企业工单系统Webhook。
88. 监控优化:部署Prometheus监控QPS与错误率,设置告警阈值,每周复盘拒绝原因分布。
配置参数
| 参数名 | 说明 | 默认值 |
|---|---|---|
return_window_days |
退换货时效天数 | 7 |
max_amount_auto |
自动处理金额上限(元) | 5000 |
label_valid_days |
退货标签有效期(天) | 7 |
carrier_priority |
物流商优先级列表 | 顺丰,中通,菜鸟 |
log_retention_days |
操作日志留存天数 | 180 |
效果示例
输入:客户提交订单号ORD889900,SKU为A123,申请退货,原因“尺寸不符”。
Agent处理:核验订单在7天内,商品支持退货,客户无异常记录。生成RMA号RMA202405001,调用顺丰API生成退货标签,取件码SF998877。
输出:{status: success, rma_no: RMA202405001, return_label_url: https://sf.com/label/998877, carrier: 顺丰, pickup_code: SF998877, reject_reason: null, next_action: 等待客户寄回}。
同时更新WMS库存为“待退货”,触发退款队列暂缓。
Agent处理:核验订单在7天内,商品支持退货,客户无异常记录。生成RMA号RMA202405001,调用顺丰API生成退货标签,取件码SF998877。
输出:{status: success, rma_no: RMA202405001, return_label_url: https://sf.com/label/998877, carrier: 顺丰, pickup_code: SF998877, reject_reason: null, next_action: 等待客户寄回}。
同时更新WMS库存为“待退货”,触发退款队列暂缓。
常见问题
Q1:Agent能否处理部分退货?
A1:支持。需在请求中指定SKU与数量,Agent按行项目核验并生成对应标签。
Q2:退货标签生成失败怎么办?
A2:检查承运商API配额与地址格式,失败自动重试3次,仍失败则转人工并通知客户。
Q3:如何防止恶意退换货?
A3:CRM历史记录中标记异常客户,Agent对高频退货客户自动转人工复核。
Q4:支持跨境退货吗?
A4:需额外配置海关规则参数,建议单独部署跨境Agent实例,避免政策冲突。
Q5:退款何时触发?
A5:默认收到退货并质检后触发,可在config.yaml中设置“收货即退”模式。
A1:支持。需在请求中指定SKU与数量,Agent按行项目核验并生成对应标签。
Q2:退货标签生成失败怎么办?
A2:检查承运商API配额与地址格式,失败自动重试3次,仍失败则转人工并通知客户。
Q3:如何防止恶意退换货?
A3:CRM历史记录中标记异常客户,Agent对高频退货客户自动转人工复核。
Q4:支持跨境退货吗?
A4:需额外配置海关规则参数,建议单独部署跨境Agent实例,避免政策冲突。
Q5:退款何时触发?
A5:默认收到退货并质检后触发,可在config.yaml中设置“收货即退”模式。
企业落地建议
建议采用私有化部署,对接企业现有OMS/WMS,初期以“自动核验+人工复核”模式运行,稳定后逐步放开自动标签生成。成本估算:云服务器约800元/月,物流API按单计费约0.5元/单,开发实施约5人天。注意事项:严格设置金额阈值与时效规则,定期审计日志,确保符合《电子商务法》退换货规定。需与我们帮你落地吗?可以试试免费AI诊断→
需要我们帮你落地?
专业团队帮你从0到1部署企业AI Agent,含安装配置、定制开发、持续运营