Agent Skills
返回列表
海外问卷列表查询

海外问卷列表查询

企业运营 更新于 2026.08.29

将以下提示词粘贴到你的 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 结构。
  • 返回结果以接口响应为唯一事实来源,不补造任何业务字段。

调用步骤

  1. 组装 params.query,写入分页参数和关键词。
  2. 从当前登录态取 token 放入 params.accessToken。
  3. 执行 GET,按 IPage 解析问卷列表。
  4. 把关键返回字段交给后续 skill,或由上层 agent 继续编排。

适用边界与注意点

  • 这是查询类接口,仍需遵守当前登录态、租户与用户权限约束。
  • 只完成本接口动作;多步骤业务链路由上层 agent 按聚合 skill 或计划文档编排。
  • 遇到认证、权限、参数或业务错误时,把原始错误码和错误信息透传给上层 agent,不要吞掉、改写或猜测。

使用场景

  • 运营后台需要按关键词拉取当前租户下的问卷列表并分页展示。
  • 上层 Agent 在业务流程第一步调用该接口,拿到 IPage 结果后交给后续步骤。
  • 排查问卷模块时,核对 getQuestionnaire 的鉴权头与 query 参数是否符合契约。
  • 需要把接口返回的原始错误码透传给上游,而不是吞掉或改写错误信息。

适合人员

  • 负责海外运营平台接口联调的后端工程师,需要确认 questionnaire_list 的调用细节。
  • 编排多个原子 skill 的 Agent 开发者,要把查询结果交给后续 skill 继续处理。
  • 维护问卷模块的技术人员,在排查分页与关键词查询问题时核对接口行为。