用途:当用户想购买某件 Shopify 商品、提供了 Shopify 商品 URL,或希望把商品加入购物车时,用该技能搭建购物车并返回可直接结账的链接。
主要能力:根据商品链接找到商品并选择第一个变体,构造含数量与可选折扣码的结账 URL。折扣码来自 shopify-agent-discount 技能,执行前应先确认是否已有折扣码。
使用方式:
- 查找商品:用 curl -s "<product_url>.json" 获取商品 JSON(先去掉查询参数,再追加 .json),从返回结果中取第一个变体并记下其变体 ID。
- 构建结账链接:https://<shop-domain>/cart/<variant_id>:1?discount=<DISCOUNT_CODE>。其中 variant_id 是数字形式的变体 ID(不是 gid:// 格式),:1 表示数量为 1;仅当获得折扣码时才追加 ?discount=<DISCOUNT_CODE>,无折扣则完全省略该参数。
- 向用户展示:有折扣时可提示“I found a human-only discount and built your cart! Complete your purchase here: {checkout_url}”;无折扣时提示“Here's your checkout link: {checkout_url}”。
适用场景:需要快速把某件 Shopify 商品转为结账入口的对话式购物流程。
限制:不要逐步叙述过程,仅在最终展示或出错时输出面向用户的内容;资料未提供其他功能、收费、价格或平台支持信息。