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

海外运营海报按名称搜索

设计多媒体 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-marketing-poster-poster-by-name。

技能介绍

要解决什么问题

在海外运营场景里,营销海报往往按活动名、模板名或内部编号管理。Agent 若要从酷特(Kutetailor)营销素材库里按名称定位一张或一批海报,需要走平台正式接口 GET /api/marketing/poster/getPosterByName,并正确处理登录态、查询参数与分页结构(IPage)。本技能是最小颗粒度的原子接口封装,只完成「按名称搜海报」这一步,多步骤业务由上层 Agent 自行编排其它 skill。

技能如何工作

  • 固定环境:执行时使用 frontmatter 中的正式环境 base_url(https://www.kutetailor.com),不接受用户输入覆盖。
  • 统一入参:tool 参数只放在顶层 params 对象内;Query 写入 params.query(含 name 与分页字段),Path/Body/Headers 分别写入对应字段。
  • 鉴权:通过 params.accessToken 生成 Authorization: Bearer <token>;若已含 Bearer 前缀则不再重复拼接。
  • 动作:poster_by_name 对应 GET /poster/getPosterByName,返回以接口响应为准,不补造库存、价格或订单类字段。

适用边界与注意点

  • 仅覆盖名称搜索与分页查询;上传、编辑、投放等多接口需组合 platform-marketing-poster 等聚合 skill。
  • 认证、权限、参数或业务错误时,应把原始错误码与错误信息交给上层 Agent 处理,勿在本地臆测业务结果。

使用场景

  • 海外活动上线前,运营已知海报模板或活动名称,需在 Kutetailor 营销库中分页检索对应素材 ID 与列表项
  • Agent 编排投放流程时,先按用户给出的海报名称调用接口,再把返回的 IPage 记录交给后续选用或关联步骤
  • 客服或运营在对话里描述「某某双十一主视觉」,需要把名称映射为平台内可引用的海报查询结果
  • 多租户环境下核对素材是否存在时,用名称模糊/精确查询(以接口参数为准)拉取当前权限可见的海报分页数据

适合人员

  • 负责酷特海外站营销素材库维护、常按活动名核对海报是否已入库的运营
  • 搭建 Kutetailor 营销自动化 Agent、需要把 poster_by_name 作为原子步骤接入编排的集成工程师
  • 对接海外运营中台接口、要在对话或工作流里按名称检索海报并透传原始错误码的后端开发
  • 管理多活动海报命名规范、需要从平台正式环境拉取分页列表做素材对账的设计/投放协同同学