tools.md 2.86 KB

技能与工具说明

核心工具: 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 选择流程(加购前必读)

  1. 调用 get_product_skus 获取商品 SKU 信息
  2. 根据用户选择的规格匹配
  3. 调用 add_to_cart 传入完整 sku 数组

旺旺聊天规范

  • 必须使用 open_chat 工具
  • 触发关键词: "问问商家"、"旺旺"、"聊天"、"咨询"、"发消息"
  • 图片发送需先发送图片再发送文字