interaction_patterns.md
2.58 KB
Crawl: 淘宝客户端交互模式数据
信息来源
- taobao_client Agent 工具定义 (agent.md, tools.md)
- 官方 Knowhow (knowhow.md)
- Benchmark 评测数据 (benchmark_v1.md)
- Good/Bad Testdata 测试案例
交互模式分析
模式 1: 搜索-详情-加购流程
用户输入关键词
↓
search_products → 返回商品列表
↓
用户选择商品
↓
get_product_skus → 获取 SKU 变体
↓
用户选择规格
↓
add_to_cart → 加入购物车
↓
验证成功
成功率: 75-85% 失败点: SKU 选择遗漏 (25%)
模式 2: 旺旺聊天降级流程
用户请求旺旺聊天
↓
open_chat → 尝试打开旺旺
↓
检查结果
├─ 成功 → send_chat_message
└─ 失败 → 提示用户手动操作
成功率: 30-60% 失败点: 官方 API 不开放
模式 3: 页面交互流程
inspect_page → 诊断页面状态
↓
检查状态 (ready/loading/error)
├─ ready → 执行 click_element/input_text
├─ loading → wait 后重试
└─ error → 输出诊断信息
成功率: 80-90% 失败点: 页面加载超时
核心交互参数
必传参数
| 参数 | 说明 | 示例 |
|---|---|---|
| sourceApp | 调用来源 | "LemonAI" |
| keyword | 搜索关键词 | "iPhone 15" |
| itemId | 商品 ID | "1234567890" |
可选参数
| 参数 | 说明 | 示例 |
|---|---|---|
| page | 页码 | 1 |
| size | 每页数量 | 20 |
| sort | 排序方式 | "sales" |
| sku | SKU 规格数组 | ["颜色:蓝色", "内存:256G"] |
页面状态码
| 状态码 | 含义 | 处理方式 |
|---|---|---|
| ready | 可交互 | 执行操作 |
| loading | 加载中 | 等待 1-2 秒 |
| error | 异常 | 输出诊断信息 |
| unknown | 未知 | inspect_page 诊断 |
成功案例摘要
good_01_keyword_search (85分)
- ✅ 支持关键词、多条件筛选
- ✅ 返回完整字段 (title, price, pict_url, sales, shop)
- ✅ 支持分页和排序
good_02_item_detail (92分)
- ✅ 完整商品详情
- ✅ SKU 变体支持
- ✅ 价格优惠信息
good_03_cart_management (83分)
- ✅ 加购功能
- ✅ 数量修改
- ⚠️ 需先选 SKU
good_04_order_list (88分)
- ✅ 订单列表查询
- ✅ 状态筛选
- ✅ 时间范围
失败案例摘要
bad_01_wangwang_chat (55分)
- ❌ 旺旺 API 不对外开放
- ❌ 需要商家资质
- ❌ 第三方工具存在合规风险
- 💡 建议降级到手动操作
数据来源: taobao_client 知识猎取 (2026-03-28)