海外平台按款色码查成品库存
将以下提示词粘贴到你的 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
- 海外运营负责库存与上架策略的同事,需依据接口真实返回值做款色码级决策