海外运营平台海报按名称搜索
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-marketing-poster-poster-by-name。
技能介绍
要解决什么问题
在海外运营场景里,营销海报往往按活动名、主题或内部编号命名。运营或 Agent 需要按名称定位素材,而不是翻完整目录或依赖人工导出。本技能只覆盖平台侧的一个原子动作:poster_by_name——用名称(及分页)查询海报列表,把接口原样结果交给上层编排。
技能如何工作
执行器固定走正式环境 GET /poster/getPosterByName(完整基址见 skill frontmatter 的 base_url,不可被用户输入覆盖)。调用参数统一放在嵌套对象 params 里:
- Query:
name与分页字段写入params.query - 鉴权:登录态通过
params.accessToken生成Authorization: Bearer …;若已含Bearer前缀则不再重复拼接 - 其它:Path 用
params.path,Body 用params.body,额外 Header 用params.headers
成功时返回分页结构 IPage(具体字段以接口响应为准)。若出现认证、权限、参数或业务错误,应把原始错误码与错误信息向上传递,由聚合 skill 或 Agent 决定重试、换条件或走其它接口。
适用边界与注意点
这是最小颗粒度接口 skill,不包含上传、编辑、下单等步骤;完整链路需组合 platform-marketing-poster 等聚合能力或其它原子 skill。返回内容必须以接口为准,不要补造库存、价格、订单号等字段。查询类接口仍受租户与用户权限约束,名称模糊或分页不当可能导致空页,需在上层做交互与兜底。
使用场景
- 用户给出活动或主题名称,Agent 需调用 `poster_by_name` 在酷特海外运营平台查对应海报分页列表。
- 编排 `platform-marketing-poster` 时,先按名称定位素材 ID 或记录,再交给下载、详情等后续原子 skill。
- 运营核对「某次大促海报是否已入库」时,用名称关键词查询并对比接口返回的分页结果。
- 接口返回权限或参数错误时,上层需根据原始错误码决定是否换 token、改分页或调整搜索词。
适合人员
- 负责对接 kutetailor 营销海报接口、需在 Agent 里封装按名查询的后端集成工程师
- 维护酷特海外运营自动化流程、要把 `poster_by_name` 编入多步计划的 Agent 编排开发者
- 管理海外站点素材库、需按活动名或内部命名快速核对海报是否在平台的运营同事
- 构建企业运营类 skill 聚合文档、需明确原子接口边界与返回字段的数据/平台工程师