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

酷特海外面料后台批量查附件

企业运营 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-fabric-admin-attachment-by-ids。

技能介绍

要解决什么问题

在海外运营平台的面料后台里,附件往往分散在多条业务记录上。运维或集成 agent 若只有一串附件 ID,却缺少统一的批量拉取方式,就只能反复调单条接口,或在对话里「猜」附件元数据——后者会直接污染下游库存、订单或展示逻辑。

本技能是 platform-fabric-admin 聚合能力里的原子接口封装,只负责动作 attachment_by_ids:按 ID 列表向正式环境查询附件详情,并把接口原样结果交给上层编排。

技能如何工作

  • 固定端点:执行器使用 frontmatter 中的正式环境 base_url,对应 GET /attachment/getAttachByIdList(完整地址为 https://www.kutetailor.com/api/fabric/attachment/getAttachByIdList),不接受用户输入覆盖域名或环境。
  • 参数约定:tool 参数统一放在嵌套对象 params 下;本动作为 GET,附件 ID 列表通过 params.query 中的 ids 传递。
  • 登录态:需登录的调用在 params.accessToken 中传 token;执行器生成 Authorization: Bearer …,若值已含 Bearer 则不再重复拼接。
  • 返回事实:以接口响应为唯一事实来源;认证、权限、参数或业务错误时,应把原始错误码与信息传给上层 agent,而不是本地补造字段。

需要「查附件 + 改状态 + 关联面料」等多步链路时,应由上层 agent 按聚合 skill 或计划文档组合多个原子 skill;本技能只完成本接口一步。

适用边界与注意点

  • 仅覆盖 批量查询附件 场景;不包含上传、删除或权限变更。
  • 仍受当前登录态、租户与用户权限约束;无 token 或权限不足时,应如实上报接口错误。
  • 最外层只放 params,不要使用 params.xxx 这类点号顶层 key;Path / Query / Body / 额外 Header 分别写入 params.path、params.query、params.body、params.headers(本接口以 Query 为主)。

使用场景

  • 面料 SKU 或工艺单导出里只有附件 ID,需要在回复用户前批量拉取文件名与访问信息
  • 编排 platform-fabric-admin 链路时,上游已拿到 id 列表,本步仅调用 getAttachByIdList 校验附件是否存在
  • 客服工单给出多条附件编号,需在正式环境核对对应附件详情再同步给业务方
  • 对账或审计脚本从业务库读出 attachment id 集合,由 agent 一次性查询平台侧附件元数据

适合人员

  • 负责酷特海外运营平台面料资料维护、常按 ID 核对附件是否齐全的后台运营
  • 对接 kutetailor 面料接口、在 agent 里封装登录态与 query 参数的集成开发
  • 编写 platform-fabric-admin 聚合 skill 或计划文档、需要原子 attachment_by_ids 步骤的 agent 作者
  • 处理面料相关客诉或内审、需用正式环境接口还原附件真实返回字段的业务支持