酷特海外平台简定制商品详情
将以下提示词粘贴到你的 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 执行器维护者