海外运营海报按名称搜索
将以下提示词粘贴到你的 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 作为原子步骤接入编排的集成工程师
- 对接海外运营中台接口、要在对话或工作流里按名称检索海报并透传原始错误码的后端开发
- 管理多活动海报命名规范、需要从平台正式环境拉取分页列表做素材对账的设计/投放协同同学