Agent Skills
返回列表
海外平台按款色码查成品库存

海外平台按款色码查成品库存

企业运营 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-product-detail-product-stock。

技能介绍

要解决什么问题

海外运营里,客服、运营或内部 agent 经常要在不打开后台的情况下确认:某个款(商品 ID)、某个颜色、某个尺码还有没有成品库存。多步流程(登录、进详情、筛 SKU)既慢,也容易和自动化编排脱节。

本技能对应酷特海外平台的一个原子动作:product_stock,用固定正式环境 GET 接口按三要素返回库存数值(BigDecimal),供上层 agent 与其它原子 skill 拼成完整链路。

技能如何工作

  • 固定端点:使用 frontmatter 中的正式地址 https://www.kutetailor.com/api/product/product/product/public/selectProductCountById,执行器不得用用户输入覆盖 base_url。
  • 查询参数:通过 params.query 传入 id(商品)、color、size。
  • 参数结构:tool arguments 最外层只放嵌套对象 params;Path / Query / Body / 额外 Header 分别写入 params.path、params.query、params.body、params.headers。
  • 登录态:若接口需鉴权,用 params.accessToken 生成 Authorization: Bearer;令牌已含 Bearer 时勿重复拼接。
  • 结果原则:以接口响应为唯一事实来源,不补造库存、价格或订单状态;认证、权限、参数或业务错误时,将原始错误码与信息交给上层 agent。

适用边界与注意点

  • 本 skill 只做单接口查询;若用户需求涉及价格、详情、下单等多步,需由聚合 skill(如 platform-product-detail)或计划文档编排多个原子 skill。
  • 属于查询类接口,仍受当前登录态、租户与用户权限约束。
  • 与文档中的原始 action 名称一致:product_stock。

使用场景

  • 客服接到海外站咨询时,需用商品 ID 加颜色、尺码当场核对该款是否还有成品可发
  • 编排商品详情链路时,agent 在展示尺码表前调用接口确认各颜色尺码库存是否为零
  • 运营核对促销款清单时,按 SKU 维度批量查询成品库存以决定是否下架或改预售
  • 内部工具对接 kutetailor 公开库存接口,把返回的 BigDecimal 写入自有预警或补货规则

适合人员

  • 负责酷特海外站 SKU 答疑的客服,需要在对话里快速确认某颜色尺码是否仍有成品
  • 搭建 platform-product-detail 聚合链路的 agent 开发,需要可复用的 product_stock 原子调用
  • 对接 kutetailor 商品公开接口的后端工程师,要按规范 params 结构传 id、color、size
  • 海外运营负责库存与上架策略的同事,需依据接口真实返回值做款色码级决策