酷特海外运营海报图片素材搜索
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-marketing-poster-picture-by-name。
技能介绍
要解决什么问题
在海外运营里做营销海报时,设计或运营往往要先在平台素材库里按名称检索图片,再进入选图、排版或下发流程。若由 Agent 自动编排整条链路,其中「按关键词查图」这一步应是一个可复用的原子动作,而不是在对话里手写 URL 或猜参数格式。
本技能对应酷特海外运营平台的最小粒度接口:picture_by_name,固定走正式环境 GET /api/marketing/poster/getPictureByName,用 Query 里的 name 与分页条件返回 IPage 结构的素材列表。
技能如何工作
- 单一职责:只完成「搜索图片素材」这一次 HTTP 调用;若用户还要上传、绑定海报、下单等,需由上层 Agent 串联
platform-marketing-poster聚合技能或其它原子 skill。 - 参数约定:
tool arguments最外层仅包含嵌套对象params;Path 进params.path,Query 进params.query,Body 进params.body,额外 Header 进params.headers。 - 鉴权:登录态通过
params.accessToken生成Authorization: Bearer …;若值已带Bearer前缀则不再重复拼接。 - 环境与事实来源:
base_url以 skill frontmatter 中的正式地址为准,不得用用户输入覆盖;返回字段以接口响应为准,不补造库存、价格或订单类信息;认证、权限、参数或业务错误时,应把原始错误码与信息交给上层处理。
适用边界与注意点
这是查询类接口,仍受当前租户与用户权限约束。GET 的查询参数应放在 URL query(经 params.query 传入)。需要多步业务时,本 skill 只交出本次检索结果中的关键字段,后续步骤由计划或其它 skill 承接。
使用场景
- 海外站活动海报编排时,Agent 需先按活动或产品关键词调用接口分页查出可用图片素材。
- 用户只说素材名称、未给资源 ID 时,由本技能走 GET getPictureByName 返回 IPage 列表供后续选图。
- 组装 platform-marketing-poster 链路时,把「按名称搜图」拆成独立一步,避免与其它上传或绑定接口混调。
- 运营在对话里要核对某套海报图是否在平台库中存在,用 name 查询并依据接口原始结果答复。
适合人员
- 负责酷特海外营销素材库维护、常按名称核对海报图是否在库内的运营
- 搭建 Kutetailor 营销海报自动化链路、需接入 picture_by_name 原子接口的 Agent 集成工程师
- 用对话式工具帮业务选海外海报底图、必须先查平台分页结果再推荐的设计支持人员
- 维护 platform-marketing-poster 聚合文档、要把搜图步骤与上传绑定步骤分开编排的技能作者