海外营销活动日程安排查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-marketing-campaign-schedule-list。
技能介绍
解决什么问题
在海外运营平台上管理营销活动时,排期信息是藏在后端接口里的:一个活动覆盖哪些日期、什么时候开始、当前处于哪个阶段,都需要运营同学或上层 Agent 主动去问。没有稳定入口时,大家只能手写临时脚本调接口,参数格式、登录态、租户校验散落在各处,重复实现成本高,也容易因为鉴权拼接错误直接失败。
技能如何工作
kutesmart-海外运营平台营销活动-日程安排查询 只做一件事:调用 schedule_list 这个原子动作。
- 请求固定为
GET /marketing/campaign-schedule,正式环境地址写死在 frontmatter 的base_url,不接受调用方覆盖。 - tool arguments 统一使用嵌套的
params对象,最外层只有params,不会出现params.xxx这类点号顶层 key。 - 登录态由
params.accessToken生成Authorization: Bearer;如果传入值已经包含Bearer,不会重复拼接。 - Path 参数放
params.path,Query 参数放params.query,JSON Body 放params.body,额外 Header 放params.headers。 - 查询条件遵循
CampaignScheduleRequest,返回类型为List。
执行器按接口表选择 HTTP method 和 URL,{变量} 从 params.path 替换,GET/DELETE 的查询参数挂在 URL query 上。返回结果以接口响应为唯一事实来源,不会补造库存、价格、订单号、优惠金额或物流状态。
适用边界
- 这是最小颗粒度的接口 skill,只负责
schedule_list一个动作。业务流程需要多步接口串联时,要由上层 Agent 通过聚合 skill(platform-marketing-campaign)或计划文档编排。 - 接口返回的认证、权限、参数或业务错误码会原样透传给上层 Agent,由上层决定如何处理。
- 调用仍需遵守当前登录态、租户和用户权限,技能不会绕过鉴权。
- POST/PUT 默认发送 JSON body;若上层接口网关另有约定,以网关契约为准。
使用场景
- 运营需要确认某个海外营销活动在什么时间段投放,调用该 skill 查询日程安排。
- 上游 Agent 正在组合营销活动链路,先拉取全部活动排期后再决定后续聚合步骤。
- 排查营销日历时,开发需要按当前登录态和租户权限验证 schedule_list 接口返回。
- 上层业务要生成活动排期清单,由 Agent 调用该接口获取原始列表并交给后续流程处理。
适合人员
- 负责海外营销活动排期的运营工程师,需要按登录态查询具体活动的日程安排。
- 搭建 Agent 工作流的开发工程师,需要把 schedule_list 接入聚合业务流程并处理返回结果。
- 排查营销活动接口权限的研发或测试工程师,需要确认认证、租户和用户权限约束是否生效。