Kutesmart 款式标签获取
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-style-catalog-style-labels。
技能介绍
要解决的问题
在海外运营平台的款式目录维护流程中,款式标签是筛选、归类和展示款式的基础字段。若由业务脚本直接拼接 HTTP 请求,每个调用方都要重复处理鉴权、参数组织与错误透传,维护成本高且容易出错。这个 skill 把「获取款式标签」收敛成一个最小颗粒度的接口动作,只负责一次调用。
核心能力与调用流程
- 固定接口:
GET https://www.kutetailor.com/api/style/style-info/getStyleLable,正式环境地址写在 frontmatter 的base_url中,调用时不可被用户输入覆盖。 - 参数组织:
tool arguments统一使用嵌套的params对象,最外层不使用params.xxx这类点号顶层 key。当前接口的查询参数通过params.query传入,需要type和category两个值;params.path、params.body、params.headers分别对应路径参数、JSON 请求体和额外请求头。 - 鉴权:登录态接口用
params.accessToken生成Authorization: Bearer;若传入值已包含Bearer,不重复拼接。 - 返回处理:以上层 agent 拿到的接口响应为事实来源,skill 不补造库存、价格、订单号等接口未返回的字段;遇到认证、权限、参数或业务错误时,原始错误码和错误信息原样透传给上层。
适用边界
- 仅覆盖
style_labels这一个原子动作,多接口业务链路需由上层 agent 按聚合 skillplatform-style-catalog或计划文档编排。 - 返回结果依赖当前登录态、租户和用户权限,无权限时会收到接口侧返回的原始错误。
- 查询参数
type、category的具体取值以平台侧接口契约为准,skill 文档未做枚举。
使用场景
- 运营团队维护海外款式目录时,需调用该接口获取款式标签,为新款匹配对应分类标签
- Agent编排款式筛选链路时,需先调用此接口获取标签,作为后续款式查询的过滤维度
- 开发业务脚本更新款式标签时,可调用该接口拉取最新标签,填充到款式基础信息中
- 排查款式标签缺失问题时,可通过该接口获取当前标签返回结果,定位异常原因
适合人员
- Kutesmart海外运营平台运营专员,需要准确获取款式标签,完成款式目录的分类与展示维护
- 上层Agent开发工程师,需要可靠的原子接口获取标签,构建多步骤的款式业务编排链路
- 款式目录维护脚本开发者,需要稳定的接口调用方式,批量拉取款式标签更新到业务系统
- 平台接口问题排查工程师,需要原始接口返回结果,定位款式标签相关的异常问题