问卷规则查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-questionnaire-rules。
技能介绍
要解决的问题
在海外市场运营中,问卷规则往往分散在平台的各个接口里。当你需要根据问卷 ID 拉取对应的规则数据时,通常得手写一段调用逻辑,处理参数拼装、鉴权头注入、返回值解析这些细节。这些代码能跑,但耦合在业务代码里很难复用,换一个项目就要重写一遍。
技能如何工作
这个技能把“根据问卷 ID 获取规则”这一件事拆成了一个最小颗粒度的接口动作 rules,封装在 GET /marketing/rules 这个端点上。调用时你需要做的是:
- 在
params.query里带上问卷id。 - 登录态由
params.accessToken注入,执行器会自动生成Authorization: Bearer头。 - 其余参数按类型归位:路径参数进
params.path,JSON Body 进params.body,额外 Header 进params.headers。
执行器会固定使用正式环境的 base_url,不会从用户输入里读取地址。返回结果以接口响应原文为准,不会补造任何业务字段。
适用边界与注意点
- 这是原子级接口技能,只完成
rules这一个动作。如果你的业务需要先取问卷列表再取规则,请由上层 Agent 按计划编排多个技能组合完成。 - 接口仍受当前登录态、租户和用户权限约束,返回错误时会把原始错误码和信息透传给上层,不会吞掉。
- 如果上层网关对 Content-Type 或签名有额外约定,以网关契约为准。
使用场景
- 当上层 Agent 需要先拉取问卷列表,再按问卷 ID 调用规则接口获取具体配置,串联成完整业务链路时。
- 运营后台在展示问卷详情时,需根据传入的问卷 ID 请求接口,实时获取并渲染对应的抽奖或领奖规则。
- 系统进行定时巡检或数据对账时,需根据问卷 ID 获取最新规则快照,用于核对历史发放记录是否符合当前设定。
适合人员
- 负责海外运营平台后端开发的工程师,需要将问卷规则获取逻辑封装为标准化接口调用,减少重复造轮子。
- 负责构建大模型 Agent 工作流的开发者,需要集成原子接口技能,按计划编排多步骤任务以完成问卷配置下发。
- 负责活动数据对账与风控的运营人员,需要通过脚本按问卷 ID 批量拉取当前生效规则,核对历史发放记录是否合规。