酷特海外运营 3D 工艺查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-3d-product-config-show-product-three-craft。
技能介绍
要解决什么问题
在海外运营平台的 3D 产品配置 流程里,设计稿或配置单往往已经落库为「3D 工艺」记录。上层 agent 或运营脚本需要按品类拉取这些已保存的工艺数据,才能做展示、比对或继续编排后续接口(例如其它 product-three 动作)。本技能是最小颗粒度的原子 skill,只覆盖平台 action show_product_three_craft,不负责整条业务链路。
技能如何工作
执行器向正式环境发起固定地址的 GET 请求:
https://www.kutetailor.com/api/product/product/product-three/showProductThreeCraft
- base_url 写在 skill frontmatter,调用时不得用用户输入覆盖。
- 工具参数统一放在嵌套对象
params内;最外层只放params,不要用params.xxx这类点号顶层 key。 - 本接口为 Query 参数:
category(见接口表)。查询类参数写入params.query。 - 需登录态时,用
params.accessToken生成Authorization: Bearer <token>;若传入值已含Bearer前缀,不要重复拼接。 - 额外 Header 写入
params.headers。
返回以接口 RS 响应为唯一事实来源;认证、权限、参数或业务错误时,应把原始错误码与错误信息交给上层 agent 处理。
适用边界与注意点
- 若用户需求涉及多步接口(创建、保存、发布等),本 skill 只完成本接口调用,关键字段需由聚合 skill
platform-3d-product-config或计划文档编排其它原子 skill。 - 仍受当前登录态、租户与用户权限约束;不要根据返回内容补造库存、价格、订单号等字段。
使用场景
- 海外站运营 agent 在核对某品类已落库的 3D 工艺列表时,按 `category` 调用本接口拉取 RS 数据
- 聚合 skill 编排产品配置链路时,在保存/展示步骤前需要先读取用户已保存的 3D 工艺配置
- 内部工具按品类批量巡检 kutetailor 正式环境里是否存在对应 3D 工艺记录,用于对账或发布前校验
- 客服或技术支持脚本根据用户提供的品类,查询平台上该品类下当前保存的 3D 工艺返回给工单系统
适合人员
- 对接酷特海外运营平台 API 的后端工程师,需要在 agent 里封装 `show_product_three_craft` 查询动作
- 维护 `platform-3d-product-config` 聚合 skill 的集成同学,要拆出查询已保存 3D 工艺这一原子步骤
- 海外定制业务运营,要在对话式工具里按品类核对客户已保存的 3D 工艺是否与后台一致
- 为 kutetailor 正式环境写巡检或对账脚本的平台 SRE,需固定地址 GET 且透传认证错误码