面料后台附件批量查询
将以下提示词粘贴到你的 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批量拉取附件清单并处理接口原始返回。
- 排查面料附件缺失或不一致的客服或运营支持,需要按附件编号批量查询返回结果并据此反馈处理。