海外问卷列表查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-questionnaire-questionnaire-list。
技能介绍
要解决的问题
海外运营平台的问卷列表藏在 /marketing/questionnaire-info/getQuestionnaire 接口后面。工程师写自动化脚本或上层 Agent 时,往往要在「调哪个地址、参数放哪一层、分页和关键词怎么传」上反复试错,还容易把鉴权头拼错。这个技能把动作收敛成一个最小颗粒度的原子操作,调用方只需关心查询条件和返回结果。
核心能力
- 固定调用正式环境地址
GET https://www.kutetailor.com/api/marketing/marketing/questionnaire-info/getQuestionnaire,不接受用户输入覆盖base_url。 - tool arguments 统一使用嵌套
params对象,最外层只有params,没有params.xxx这类点号顶层 key。 - 登录态通过
params.accessToken生成Authorization: Bearer;传入值已含 Bearer 时不重复拼接。 - GET 请求的分页与关键词写入 query,返回
IPage结构。 - 返回结果以接口响应为唯一事实来源,不补造任何业务字段。
调用步骤
- 组装
params.query,写入分页参数和关键词。 - 从当前登录态取 token 放入
params.accessToken。 - 执行
GET,按IPage解析问卷列表。 - 把关键返回字段交给后续 skill,或由上层 agent 继续编排。
适用边界与注意点
- 这是查询类接口,仍需遵守当前登录态、租户与用户权限约束。
- 只完成本接口动作;多步骤业务链路由上层 agent 按聚合 skill 或计划文档编排。
- 遇到认证、权限、参数或业务错误时,把原始错误码和错误信息透传给上层 agent,不要吞掉、改写或猜测。
使用场景
- 运营后台需要按关键词拉取当前租户下的问卷列表并分页展示。
- 上层 Agent 在业务流程第一步调用该接口,拿到 IPage 结果后交给后续步骤。
- 排查问卷模块时,核对 getQuestionnaire 的鉴权头与 query 参数是否符合契约。
- 需要把接口返回的原始错误码透传给上游,而不是吞掉或改写错误信息。
适合人员
- 负责海外运营平台接口联调的后端工程师,需要确认 questionnaire_list 的调用细节。
- 编排多个原子 skill 的 Agent 开发者,要把查询结果交给后续 skill 继续处理。
- 维护问卷模块的技术人员,在排查分页与关键词查询问题时核对接口行为。