Agent Skills
返回列表
海外运营平台问卷作答结果获取

海外运营平台问卷作答结果获取

企业运营 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-questionnaire-answer-list。

技能介绍

解决什么问题

在海外运营平台的实际业务中,获取问卷作答结果往往是数据收集链路的最后一步。如果直接在业务代码中硬编码接口调用,很容易遇到几个典型问题:正式环境地址被随意覆盖、认证令牌重复拼接、以及查询参数与路径参数混淆。当问卷系统需要与上游的问卷发布、下游的数据分析模块联动时,这种松散的调用方式会导致维护成本急剧上升。

这个技能将“获取作答结果”这一动作拆解为最小颗粒度的原子操作,确保每一次请求都符合平台的接口契约。

工作原理

该技能封装了一个核心动作:answer_list。当上层 Agent 需要拉取作答数据时,技能会向固定地址发起 GET 请求:

  • GET https://www.kutetailor.com/api/marketing/marketing/questionnaire-info/getAnswer

为了应对复杂的网关约定,技能采用了统一嵌套的 params 对象来组织参数,而不是平铺在顶层:

  • 认证信息:通过 params.accessToken 注入。如果该值已经包含 Bearer,技能会自动识别并避免重复拼接,直接生成标准的 Authorization Header。
  • 路径与查询:URL 中的变量写入 params.path,而分页、筛选等查询条件则统一放入 params.query。
  • 请求体与额外头:对于 POST 或 PUT 请求,JSON Body 会写入 params.body,额外的自定义 Header 则放入 params.headers。

执行时,技能会严格按照 frontmatter 中配置的 base_url 发起调用,拒绝任何来自用户输入的环境地址覆盖。返回结果遵循 IPage 结构,包含了作答数据的分页信息。

适用边界与注意点

虽然这个技能可以完美处理单次接口调用,但它不负责完整的业务编排。如果你需要从“创建问卷”到“获取结果”再到“生成报表”,需要由上层 Agent 结合其他原子技能(如问卷创建、数据导出)来组成完整的计划。

此外,在调用时仍需注意:

  • 必须遵守当前登录态、租户和用户权限,技能不会绕过鉴权逻辑。
  • 以接口响应为唯一事实来源,严禁补造库存、价格或订单状态。
  • 如果接口返回认证失败、权限不足或参数错误,技能会将原始错误码和错误信息原封不动地传递给上层 Agent,以便进行后续的异常处理。

使用场景

  • 当业务系统需要分页拉取问卷作答结果时,通过统一参数结构调用answer_list接口
  • 需要处理分页和筛选参数时,通过params.query传递分页大小和筛选条件
  • 认证令牌需要避免重复拼接时,技能自动识别Bearer并直接生成Authorization头
  • 接口返回认证、权限、参数或业务错误时,原始错误码和信息透传给上层Agent

适合人员

  • 后端工程师:在业务系统中集成问卷数据查询功能,确保请求参数符合平台规范
  • 数据工程师:构建问卷数据管道时,需要可靠获取分页数据并处理接口返回结构
  • 系统集成人员:对接海外运营平台时,需要维护认证逻辑和接口地址的固定配置
  • 自动化开发工程师:设计自动化流程时,需要处理接口调用异常并将错误信息传递给后续步骤