酷特海外商城首页与分类浏览
将以下提示词粘贴到你的 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 的全栈或自动化测试工程师