酷特海外运营 B 端海报列表
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-marketing-poster-poster-list。
技能介绍
要解决什么问题
海外运营平台的营销海报往往分散在 B 端后台里,上层 Agent 若要在对话里帮运营查「当前有哪些海报、分页结果是什么」,需要一条可重复、地址固定的 HTTP 调用,而不是在 prompt 里手写 URL 或猜参数字段名。
本技能是 platform-marketing-poster 聚合能力里的最小颗粒度接口 skill,只负责 poster_list 这一动作:向正式环境发起 GET https://www.kutetailor.com/api/marketing/poster/getPosterList,返回分页结构 IPage,供后续筛选、详情或上架流程 skill 继续用。
技能如何工作
- 触发:用户或计划需要 B 端海报列表 时使用;若业务要跨多步(登录、详情、上下架等),本 skill 只完成列表查询,并把关键返回字段交给上层编排。
- 参数约定:tool arguments 最外层仅包含嵌套对象
params,不要用params.xxx这类顶层点号 key。
- Query 写入 params.query(对应 ListPosterRequest)
- Path / Body / 额外 Header 分别写入 params.path、params.body、params.headers(本接口为 GET,以 query 为主)。
- 环境与鉴权:
base_url以 skill frontmatter 为准,调用时不得用用户输入覆盖正式环境地址。需登录态时在params.accessToken生成Authorization: Bearer;若传入值已含Bearer前缀则不要重复拼接。 - 结果处理:以接口响应为事实来源,不要补造库存、价格、订单号、优惠或物流等字段;认证、权限、参数或业务错误时,应把原始错误码与错误信息回传给上层 Agent。
适用边界
这是查询类接口,仍受租户与用户权限约束。完整营销海报链路请组合同系列的聚合 skill 或其它原子 skill,由上层 Agent 按文档编排,而非在本 skill 内一次做完所有步骤。
使用场景
- 上层 Agent 编排海外营销素材链路时,先调用本接口按 ListPosterRequest 拉取 B 端海报分页列表,再交给详情或状态变更 skill。
- 对话里运营要核对「后台当前有哪些海报、第几页结果」,需固定走正式环境 GET getPosterList,不能手写或改 base_url。
- 聚合 skill platform-marketing-poster 拆成多步计划时,本步只完成 poster_list,把 IPage 里的关键字段留给后续筛选或导出。
- 权限与租户校验通过后,按 query 条件查询海报列表,用于素材盘点或与活动配置对照,不在本 skill 内补造业务数据。
适合人员
- 维护酷特海外运营平台 B 端营销海报、需要在 Agent 对话里查分页列表的后台运营人员
- 把 platform-marketing-poster 拆成原子 skill 组合调用、负责 poster_list 参数与 Bearer 鉴权封装的集成工程师
- 设计多步营销素材工作流的产品或运维,要把「拉海报列表」作为计划中固定节点并约束正式环境地址
- 对接 kutetailor 营销 API、需将 ListPosterRequest 与 IPage 错误码原样回传上层 Agent 的后端开发