Agent Skills
返回列表
酷特海外商城首页与分类浏览

酷特海外商城首页与分类浏览

开发编程 更新于 2026.08.30

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

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

技能介绍

要解决什么问题

在海外运营商城里,首页瀑布流、分类页列表和「按标签/类目筛一筛」往往都落在同一个公开查询接口上。Agent 若自己拼 URL、乱改正式环境域名,或把分页参数摊平成顶层 tool 字段,很容易和网关契约不一致,返回结果也没法交给下游做加购、详情跳转。

技能如何工作

本 skill 是 最小颗粒度 的原子能力,只负责 product_home 这一动:对固定正式环境地址发起 GET /product/product/public/selectProductHome,查询参数统一放在 params.query 里。

典型 query 包括:

  • 分页:pageNum、pageSize
  • 场景类型:type(区分首页/分类等用法)
  • 轻量过滤(可选):sort、category、labels、productCategory、label、userId

返回以接口真实响应为准(分页结构 IPage),由上层 agent 解析商品 ID、标题、封面等字段,再编排详情、购物车等其它原子 skill。若需登录态,通过 params.accessToken 生成 Authorization: Bearer,且 不得 用用户输入覆盖 frontmatter 中的 base_url。

适用边界

  • 只完成 一次 首页/分类/轻量过滤查询;完整「浏览 → 详情 → 下单」需组合 platform-product-browse 等聚合 skill 或其它接口 skill。
  • 认证、权限、参数或业务错误应原样上抛,不要 根据想象补库存、价格或订单状态。

使用场景

  • 海外商城 Agent 需要按 pageNum、pageSize 拉取首页商品 IPage,再交给详情 skill 做跳转
  • 运营脚本要在指定 category 或 productCategory 下分页列出分类页商品,核对上架与标签
  • 用户说「只看某 label 下的款」时,Agent 用 labels、label 等 query 做轻量过滤后展示列表
  • 编排 platform-product-browse 时,先调用 product_home 拿到商品 ID 列表,再串联加购或详情接口

适合人员

  • 对接 kutetailor 公开商品接口、要把首页/分类查询封装成原子 tool 的后端集成工程师
  • 维护 platform-product-browse 聚合 skill、需按文档编排 product_home 与后续接口的 Agent 维护者
  • 海外运营里用对话机器人按类目或标签查在售款、只依赖列表接口不落地的客服/运营自动化搭建者
  • 在正式环境固定 base_url 前提下,为海外商城做商品浏览 POC 的全栈或自动化测试工程师