酷特海外平台商品详情与库存价格
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-product-detail。
技能介绍
要解决什么问题
从海外运营平台的商品候选(browse 返回的 id、type、styleId)进入可下单页时,Agent 需要区分简定制与成品两条链路,并拿到 styleId、价格、尺码与库存等字段。本技能对接正式环境只读 API(根地址 https://www.kutetailor.com/api/product),不写购物车、不提交订单。
技能如何工作
调用时 tool arguments 最外层只能放 params,通过 params.action 选择动作:
custom_detail(type=1):GET/product/product/public/selectProductOrden,按商品id取简定制详情OrderProductVO(含styleId、category、fabricCode、工艺与面料列表等)。finish_detail(type=2):GET/product/product/public/selectFinishOrder,取成品详情OrderFinishInfoVO(含颜色/尺码库存列表)。product_stock:按id、color、size查成品库存;下单前应确认,库存为 0 不应进入提交。product_price:路径/product-price/{productId}/{currency}查指定币种价格。product_size/switch_position:尺寸标准与厘米/英寸部位切换。
C 站详情需同时传 source: C 与 originSign,不能仅传 ctoken。保存购物车/订单时用 styleId,不要把商品 id 当成 styleId。登录态建议传 params.accessToken(Bearer)。整理摘要后可交给 platform-cart-address 或 platform-style-order-full。
边界与注意
- 只读:不调用
saveStyleMyCart、saveStyleOrden、submitOrdenList等写接口。 - 不编造未返回的
styleId、价格或库存;业务错误原样反馈并提示缺参。 - 成品缺颜色/尺码或库存为 0 时,不应建议提交订单。
使用场景
- browse 返回商品候选后,根据 type=1 调 custom_detail,整理 styleId 与面料工艺再交给加购技能
- 用户指定成品颜色尺码时,用 product_stock 在提交订单前核对库存是否为 0
- 客服按候选 id 查 finish_detail,回答「这个款有哪些颜色尺码」
- 需要展示美元/欧元价时,用 productId 与 currency 调用 product_price 取零售价与税率
适合人员
- 对接酷特海外运营 API 的集成工程师,要把 browse 候选 id 串到详情与购物车技能
- 海外站运营/客服,需按商品 id 查成品库存或多币种价格后再回复买家
- 构建下单 Agent 的产品同学,要在简定制与成品两条链路里区分 action 与 styleId
- 量体/简定制流程维护者,需拉 product_size 或 switch_position 做尺寸标准与单位切换