Agent Skills
返回列表
酷特海外营销邮件活动分页列表

酷特海外营销邮件活动分页列表

企业运营 更新于 2026.08.30

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-marketing-campaign-campaign-list。

技能介绍

要解决什么问题

在海外运营后台里,营销邮件活动往往数量多、筛选维度细。运营或自动化 agent 需要按条件分页拉取活动列表,而不是手工翻页或臆造活动 ID、状态与分页结果。本技能是平台营销域里的原子接口 skill,只负责 campaign_list 这一动作;若业务要「创建活动 → 发信 → 复盘」等多步链路,应由上层 agent 组合其它 skill 或聚合文档编排。

技能如何工作

正式环境固定为 GET https://www.kutetailor.com/api/marketing/campaign/selectCampaignList,对应路径 /campaign/selectCampaignList。执行器必须使用 frontmatter 中的 base_url,不得用用户输入覆盖。

tool 参数统一放在嵌套对象 params 里:最外层只放 params,不要用 params.xxx 这类点号顶层 key。Query 条件写入 params.query(类型为 ListCampaignRequest),Path / Body / 额外 Header 分别写入 params.path、params.body、params.headers。需登录时,用 params.accessToken 生成 Authorization: Bearer;若传入值已含 Bearer 则不要重复拼接。GET 的查询参数挂在 URL query,返回类型为 IPage 分页结构。

边界与注意点

这是查询类接口,仍受当前登录态、租户与用户权限约束。返回必须以接口响应为准,不要补造库存、价格、订单号、优惠金额或物流状态。若出现认证、权限、参数或业务错误,应把原始错误码与错误信息交给上层 agent 处理。

使用场景

  • 用户给出筛选条件后,由 agent 调用正式环境接口拉取营销邮件活动的分页列表,用于核对活动名称与状态。
  • 编排「先列活动再点详情」链路时,上层 agent 用本 skill 获取当前页的 campaign 记录与分页元数据。
  • 海外运营同学问「某时间段有哪些邮件活动」,agent 将条件写入 `params.query` 后执行 `campaign_list` 返回真实列表。
  • 对接报表或审计脚本前,需要按 `ListCampaignRequest` 批量翻页汇总活动清单,避免手工在后台逐页复制。

适合人员

  • 负责酷特海外运营后台、需要让 agent 按条件查询邮件活动分页数据的运营同学
  • 正在拼装 `platform-marketing-campaign` 聚合链路、需要原子 `campaign_list` 调用的后端或集成工程师
  • 为客服或运营写对话 bot,要在回答「有哪些营销活动」时直连 kutetailor 正式 API 的自动化作者
  • 做活动对账或巡检,要把多页活动列表拉全并交给下游 skill 做详情或状态比对的运维开发