美妆电商购物助手,支持商品搜索、加购下单、订单管理;当用户需要购买美妆产品、查询订单或管理收货地址时使用
触发时机:用户首次使用或需要下单时
执行步骤:
scripts/auth/send_sms.py <手机号> 发送验证码scripts/auth/sms_login.py <手机号> <验证码> 完成登录测试环境:验证码固定为 111111
执行方式:调用脚本
python scripts/goods/search.py --keyword "洗面奶" --page 1 --size 10 --sort PRICE_ASC
参数说明:
--keyword:搜索关键词--page:页码,默认1--size:每页数量,默认10--sort:排序方式(PRICE_ASC/PRICE_DESC/SALE_DESC)返回信息:商品列表包含 goodsId、skuId、goodsName、price、thumbnail、storeName 等
执行方式:调用脚本
python scripts/goods/detail.py <goodsId> <skuId>
返回信息:包含商品详细规格、SKU列表、价格、库存等
加购:python scripts/cart/add.py <skuId> <数量> BUY_NOW|CART
查看:python scripts/cart/list.py
数量:python scripts/cart/count.py
立即购买(单个商品):
add_to_cart:加购(way=BUY_NOW)set_address:设置收货地址preview_order:预览订单确认价格create_order:创建订单获取 trade_sn购物车结算(多个商品):
cart_list:查看购物车set_address:设置收货地址preview_order:预览订单create_order:创建订单订单列表:python scripts/order/list.py --status UNPAID --page 1
订单详情:python scripts/order/detail.py <orderSn>
取消订单:python scripts/order/cancel.py <orderSn> <原因>
物流查询:python scripts/order/logistics.py <orderSn>
地址列表:python scripts/address/list.py
默认地址:python scripts/address/default.py
解析地址:python scripts/address/resolve.py <省> <市> <区> [街道]
新增地址:python scripts/address/add.py <姓名> <手机> <地址ID路径> <地址名路径> <详细地址> [是否默认]
设为默认:python scripts/address/set_default.py <addressId>
| 脚本 | 功能 |
|---|---|
| scripts/auth/send_sms.py | 发送短信验证码 |
| scripts/auth/sms_login.py | 短信登录 |
| 脚本 | 功能 |
|---|---|
| scripts/goods/search.py | 搜索商品 |
| scripts/goods/detail.py | 商品详情 |
| 脚本 | 功能 |
|---|---|
| scripts/cart/add.py | 加购物车/立即购买 |
| scripts/cart/list.py | 查看购物车 |
| scripts/cart/count.py | 购物车数量 |
| 脚本 | 功能 |
|---|---|
| scripts/address/list.py | 地址列表 |
| scripts/address/default.py | 默认地址 |
| scripts/address/resolve.py | 解析地址 |
| scripts/address/add.py | 新增地址 |
| scripts/address/set_default.py | 设为默认 |
用户:我想买一款洗面奶
智能体:
1. 调用搜索脚本查找洗面奶
2. 展示商品列表(图片+价格+店铺)
3. 询问用户选择哪款商品
4. 用户确认后,调用商品详情脚本展示规格
用户:就选第一款
智能体:
1. 检查是否已登录
2. 未登录:发送验证码让用户登录
3. 登录成功后:
- 调用加购(BUY_NOW)
- 设置收货地址
- 预览订单
- 创建订单,获取 trade_sn
4. 返回支付链接给用户:
- APP支付:`https://app-buyer.filtalgo.com/pages/mine/payment/payOrder?trade_sn={trade_sn}`
- H5支付:`https://buyer.filtalgo.com/payment/cashier?paymentScene=TRADE&orderSn={trade_sn}`
用户:查看我的订单
智能体:
1. 调用订单列表脚本
2. 展示订单列表(包含订单号、状态、金额、时间)
3. 询问用户需要什么操作(查看详情/取消/查物流)
用户:添加一个新地址
智能体:
1. 询问收货人信息(姓名、手机、省市区、详细地址)
2. 用户提供后:
- 调用解析地址脚本获取 ID 路径
- 调用新增地址脚本
3. 确认添加成功
type=RECEIVEhttps://buyer.filtalgo.com/goodsDetail?goodsId={goodsId}&skuId={skuId}https://app-buyer.filtalgo.com/pages/goods/product/detail?goodsId={goodsId}&skuId={skuId}