酷特海外面料后台附件查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-fabric-admin-attachment-by-id。
技能介绍
要解决什么问题
在酷特海外运营平台的面料后台里,附件往往挂在具体业务对象上。Agent 或运维脚本若要在「查面料、改资料、对账」等链路里拿到某条附件的元数据或下载信息,需要走平台统一的登录态与权限体系,而不是在对话里臆造文件名、URL 或库存状态。
本 skill 是 platform-fabric-admin 聚合能力里的最小颗粒度接口封装,只负责 attachment_by_id 这一动作:按附件 ID 向正式环境发起一次 GET 查询。
技能如何工作
- 固定调用正式环境:
GET https://www.kutetailor.com/api/fabric/attachment/getAttachById,base_url 写在 frontmatter,不允许被用户输入覆盖。 - 工具参数统一放在嵌套对象
params里:Query 用params.query(本接口需传id);Path 用params.path;Body 用params.body;额外 Header 用params.headers。 - 需要登录态时,用
params.accessToken生成Authorization: Bearer …;若传入值已含Bearer前缀则不再重复拼接。 - 执行器按表选择 HTTP 方法与 URL,以接口原始响应为事实来源;认证、权限、参数或业务错误时,把错误码与错误信息原样交给上层 Agent。
适用边界与注意点
- 若用户需求涉及多步(先列表、再详情、再改状态),本 skill 只完成「按 ID 查附件」;完整业务链路应由上层 Agent 按聚合 skill 或计划文档编排多个原子 skill。
- 最外层 tool arguments 只放
params,不要使用params.xxx这类点号顶层 key。 - 查询类接口仍受当前租户、用户权限约束;返回内容不得用于补造订单号、价格、物流状态等未在响应中出现的字段。
使用场景
- 上层 Agent 编排面料维护链路时,已持有附件 `id`,需调用正式环境接口拉取该附件的接口返回字段供下一步 skill 使用。
- 海外运营同事在核对某条面料资料时,只需按附件 ID 做一次 GET 查询,确认平台侧附件信息而非在对话里猜测文件名或链接。
- 集成 `platform-fabric-admin` 聚合能力时,将 `attachment_by_id` 作为单步动作嵌入「查详情→改资料」等多接口计划中的查询环节。
- 运维或脚本在排错登录态、租户权限问题时,用固定 base_url 与 `params.query.id` 复现「按 ID 查附件」的原始响应与错误码。
适合人员
- 负责对接酷特 `kutetailor.com` 面料 API、需要把「按 ID 查附件」封装成可编排原子能力的后端或集成工程师
- 维护海外运营平台面料后台资料、常通过 Agent 按已知附件 ID 核对平台返回内容的运营或商品资料同事
- 编写或维护 `platform-fabric-admin` 聚合 skill 文档、需在计划里显式挂载 `attachment_by_id` 的 Agent 技能作者
- 在正式环境排查附件相关工单、需要原样传递认证与业务错误码给上层 Agent 的平台运维支持人员