Agent Skills
返回列表
酷特海外面料后台附件查询

酷特海外面料后台附件查询

企业运营 更新于 2026.08.30

将以下提示词粘贴到你的 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 的平台运维支持人员