技能与工具说明
核心工具: taobao-native CLI
通过 taobao-native 命令调用淘宝桌面客户端的所有功能。
调用格式
taobao-native <工具名> --args '<JSON 参数>'
重要: 所有调用必须传入 sourceApp 参数标识调用来源,如 "LemonAI"。
工具分类
1. 启动工具
| 工具 |
用途 |
示例 |
| launch |
启动淘宝桌面版 |
taobao-native launch |
2. 导航工具
| 工具 |
用途 |
关键参数 |
| list_available_pages |
获取所有可用页面 |
- |
| navigate |
导航到预设页面 |
page |
| navigate_to_url |
打开淘宝 URL |
url |
| close_page |
关闭当前页面 |
- |
3. 页面读取工具
| 工具 |
用途 |
关键参数 |
| get_current_tab |
获取当前标签页 |
- |
| read_page_content |
读取页面文本 |
scope?, maxLength?, offset? |
| scroll_page |
滚动页面 |
direction, selector?, amount? |
| inspect_page |
诊断页面状态 |
- |
4. 页面交互工具
| 工具 |
用途 |
关键参数 |
| scan_page_elements |
扫描可交互元素 |
filter?, scope? |
| click_element |
点击元素 |
index 或 text |
| input_text |
输入文本 |
text, submit? |
| trigger_keyboard_event |
触发键盘事件 |
key, eventType? |
| trigger_key_sequence |
触发按键序列 |
text 或 sequence |
5. 搜索与商品工具
| 工具 |
用途 |
关键参数 |
| search_products |
搜索商品 |
keyword, type? |
| image_search |
以图搜图 |
imagePath |
| get_product_skus |
获取商品 SKU |
itemId? |
| add_to_cart |
加入购物车 |
itemId?, sku? |
| get_browse_history |
获取浏览历史 |
type |
| submit_product_rating |
提交商品评价 |
多种参数 |
6. 旺旺聊天工具
| 工具 |
用途 |
关键参数 |
| open_chat |
打开旺旺聊天 |
source, message, imagePath? |
| send_chat_message |
发送消息 |
message, imagePath?, shopName? |
必读规范
输出文件使用
大结果(搜索结果、页面内容)必须使用 -o 参数输出到文件:
taobao-native search_products --args '{"keyword":"iPhone","sourceApp":"LemonAI"}' -o result.json
错误处理规则
当 taobao-native 命令不可用时:
- Windows: 检查 APPDATA 中的安装路径,使用完整路径调用
- macOS: 使用
open -a /Applications/淘宝桌面版.app 尝试打开
- 最终方案: 提示用户需要重启 Agent
SKU 选择流程(加购前必读)
- 调用
get_product_skus 获取商品 SKU 信息
- 根据用户选择的规格匹配
- 调用
add_to_cart 传入完整 sku 数组
旺旺聊天规范
- 必须使用
open_chat 工具
- 触发关键词: "问问商家"、"旺旺"、"聊天"、"咨询"、"发消息"
- 图片发送需先发送图片再发送文字