Agent Skills
返回列表
海外运营平台海报按名称搜索

海外运营平台海报按名称搜索

企业运营 更新于 2026.08.30

将以下提示词粘贴到你的 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 聚合文档、需明确原子接口边界与返回字段的数据/平台工程师