用途
该技能用于处理任何商品或购物相关问题,包括查找商品、以图搜图、解析 Instagram 或 Marketplace 购物链接、购买、比价,以及评估真实商品。其总体目标是帮用户省钱,在用户给定的约束条件下寻找高质量、低价的商品。
主要能力
技能提供三类主要商品搜索工具:
- Meta 商品目录搜索(meta-catalog-search):可快速搜索 Meta 商品目录,在时尚、家居装饰、美妆类目覆盖较好,其他类目覆盖一般。
- 浏览器商品搜索(browser.spawn_task):通过智能体浏览器在网络上进行较慢但彻底的搜索,覆盖全品类。除非用户明确要求 Facebook Marketplace 的商品,否则应始终调用,并与其他适用的搜索工具并行运行,尤其适用于家居用品。
- Facebook Marketplace 搜索(facebook-cli):可快速搜索 Facebook Marketplace 上的商品列表。
选定商品后,调用 shopping.resolve_results,传入商品搜索结果文件和按顺序选定的 ID,用于解析、规范化选择结果,返回可选的组件展示路径,并返回 product_citations 标记。该工具是唯一的产品解析与引用路径,本身不创建或展示 UI;如需购物组件,需另行调用 widget.create。
标记属于商品本身,而非组件。在整段对话中,任何提及商品名称的地方都应使用标记,包括搜索进行中的早期更新、对已展示商品的追问回答、比较或缩小范围、状态说明,以及后续任何再次提及该商品的回合。即使之前已用过该标记、或组件中已展示该商品,也应再次写入。标记在整段对话中持续有效,每次提及同一商品都应复用同一标记。只有未被成功解析的商品才可以不带标记地提及。
使用方式
技能会读取 ~/memory/shopping/PROFILE.md 作为用户的持久购物偏好,并在开始购物流程前应用相关偏好。若该文件不存在,则按现状继续。
某些约束决定商品是否正确,而不仅是排序,例如服装鞋类的穿着者性别与尺码、配件必须适配的确切设备或车辆、软件或游戏的平台。解析顺序为:用户本次请求或此前对话中的说明、~/memory/shopping/PROFILE.md、~/USER.md、muse.memory_search。存储的尺码仅在用户本人是穿着者且类目、尺码体系、受众、品牌和型号范围兼容时才可确定属性;不得将某品牌的鞋码套用到另一品牌。商品是给他人时,使用用户对该人的说明及其 ~/memory/people/ 页面。不得从用户名推断穿着者性别,也不得回退到默认值。
若浏览器购买所需的必需属性仍未知,应在一条消息中一并询问。其他请求若仍有未知属性,应每次只问一个属性,等待回答后再问下一个。对于已知的有限选择,可调用 muse.create_options。开放式问题用纯文本提问。不得在一条消息中堆叠两个问题或两个选项组件。不要先搜索再缩小范围。若用户无法回答或拒绝回答,不要猜测,也不要回退到用户自身的值,而应分别按每个可能的值搜索并标注结果。
适用场景
- 商品发现:理解请求、解析必需属性、收集上下文、执行搜索、审查结果、过滤并排序,最终通过购物结果组件展示。
- 找优惠:确定基准价格,研究优惠渠道,搜索低于基准价的商品列表及优惠码,并给出简洁建议。
- 以图搜图:若图片含多个可能商品且用户未指定,先询问;若已明确目标且必需属性已解析,先运行目录图片搜索;否则生成详细视觉描述并搜索,验证并排序精确匹配。
- 购买:在主智能体上运行购买流程,不得交给子智能体。根据资格标志选择路由,Meta 目录商品走 shopify-ucp 流程,否则走浏览器结账流程。
- 购物车搭建:购物车是商家自己的篮子,由商店持有、定价并应用折扣与库存。
- Instagram 链接购物:使用 instagram-cli 获取购物上下文,若有商品 ID 则直接获取详情并解析,否则执行商品发现流程。
限制
资料未提供该技能的具体收费、价格、平台支持范围或效果保证等信息。部分工具(如 browser.open)无法获取 Meta 自有链接(instagram.com、facebook.com、threads.com 等)。购买流程必须在主智能体上运行,子智能体无钱包和浏览器访问权限。