Agent Skills
返回列表
酷特海外平台简定制商品详情

酷特海外平台简定制商品详情

企业运营 更新于 2026.08.30

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

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

技能介绍

要解决什么问题

在酷特(Kutetailor)海外运营场景里,简定制商品往往和普通 SKU 走不同详情链路:下单页既要展示可选项与定制项,也要带上库存、价格等可下单字段。若让上层 Agent 自己拼 URL、猜 Query 名或改写 base_url,很容易打到错误环境或漏传 id,返回的 OrderProductVO 也无法和后续下单、购物车 skill 对齐。

本 skill 只做一件事:按规范调用正式环境的 custom_detail(GET /product/product/public/selectProductOrden),把接口原样结果交给编排层。

技能如何工作

  • 固定端点:执行器使用 frontmatter 中的正式环境 base_url,不接受用户输入覆盖。
  • 参数形态:tool arguments 最外层仅含嵌套 params;Query 写入 params.query(本接口需传商品 id);需登录时在 params.accessToken 中传 token,由 skill 生成 Authorization: Bearer(已含 Bearer 则不重复拼接)。
  • 返回语义:响应类型为 OrderProductVO,字段以接口为准;skill 不会补造库存、价格、订单号或物流状态。
  • 编排定位:属于聚合 skill platform-product-detail 下的原子 action;完整「浏览 → 详情 → 下单」需由上层 Agent 组合多个原子 skill 或按计划文档串联。

适用边界与注意点

  • 仅覆盖简定制商品详情 / 下单页详情这一查询步骤;多接口业务流程本 skill 只完成本步并把关键字段交给后续 skill。
  • 查询类接口仍受登录态、租户与用户权限约束;若返回认证、权限、参数或业务错误,应把原始错误码与错误信息向上传递,便于 Agent 重试或改参。
  • 若用户需求与本 action 无关(例如非简定制详情、或其它商品列表接口),应选用同系列其它原子 skill,而非在本接口上硬改路径。

使用场景

  • 上层 Agent 编排下单链路时,已拿到商品 id,需拉取简定制详情页所需的库存与价格字段
  • 客服或运营 Bot 根据用户提供的 SKU/商品 id,查询 Kutetailor 正式环境下单页展示数据
  • 实现 platform-product-detail 聚合 skill 时,作为 custom_detail 步骤单独调用并透传 OrderProductVO
  • 联调海外运营平台时,验证 selectProductOrden 对指定 id 的返回是否与前台下单页一致

适合人员

  • 负责把酷特/Kutetailor 海外接口接入 Agent 工作流的后端或集成工程师
  • 维护 platform-product-detail 聚合文档、需要按 action 拆分原子 skill 的 Agent 方案设计人员
  • 海外运营侧需要自动化查询「简定制商品详情+库存价格」而非手工打开后台的运营支持同事
  • 在对话式下单场景中,必须按规范传 params.query.id 且不能改 base_url 的 Skill 执行器维护者