Agent Skills
返回列表
酷特海外平台商品详情与库存价格

酷特海外平台商品详情与库存价格

企业运营 更新于 2026.08.30

将以下提示词粘贴到你的 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 做尺寸标准与单位切换