Agent Skills
返回列表
面料后台附件批量查询

面料后台附件批量查询

开发编程 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-fabric-admin-attachment-by-ids 技能到 AI 助手中。

技能介绍

解决的核心问题

在海外运营平台面料后台维护场景中,运营人员或上层系统常需根据一批附件ID批量获取附件信息。手动逐个调用接口查询不仅效率低下,还易因参数遗漏或认证错误导致数据不一致。

技能工作方式

本技能聚焦单个接口动作 attachment_by_ids,核心能力是通过固定正式环境地址 GET https://www.kutetailor.com/api/fabric/attachment/getAttachByIdList,以 params.query.ids 为参数批量查询附件。执行时需遵循以下关键步骤:

  • 严格使用frontmatter中的 base_url,禁止从用户输入覆盖;
  • 参数统一嵌套在 params 对象内,如 params.query.ids,不使用点号顶层key;
  • 登录态通过 params.accessToken 生成 Authorization: Bearer,若传入值已含Bearer则不重复拼接;
  • 查询参数通过 params.query 传递,返回结果以接口响应为事实来源,不补造附件信息。

适用边界与注意点

本技能为最小颗粒度接口技能,仅完成单个接口调用。若用户需求涉及多步骤业务链路(如“查询附件后更新关联商品”),需由上层agent按聚合skill或计划文档编排其他原子技能。此外,调用需遵守当前登录态、租户及用户权限,若接口返回认证、权限或业务错误,需将原始错误码和信息完整传递给上层agent,由其决定后续处理方式。

使用场景

  • 海外运营平台面料后台维护时,运营人员已获得一批附件ID,需要一次性查询这些附件的基本信息用于核对内容。
  • 上层 Agent 在处理面料资料上传后的回填流程,需要先通过批量查询接口取回附件元数据,再交给后续步骤保存关联。
  • 客服或运营排查面料详情时,手上只有多个附件编号,需要按 ID 批量确认附件是否存在、获取返回结果后再定位问题。
  • 数据同步脚本迁移面料后台数据时,需要用附件ID批量拉取附件清单,避免逐条查询造成重复请求和响应不一致。

适合人员

  • 海外运营平台面料后台运营人员,需要根据一批附件ID批量核对附件内容,减少逐条查询和人工整理。
  • 负责面料资料上传和回填的 Agent 开发者,需要把批量查询附件的接口动作嵌入更大的业务编排流程。
  • 维护面料数据同步脚本的研发工程师,需要通过附件ID批量拉取附件清单并处理接口原始返回。
  • 排查面料附件缺失或不一致的客服或运营支持,需要按附件编号批量查询返回结果并据此反馈处理。