Agent Skills
返回列表
酷特海外运营问卷列表查询

酷特海外运营问卷列表查询

企业运营 更新于 2026.08.30

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

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

技能介绍

要解决什么问题

海外运营侧经常需要核对问卷配置是否上线、按关键词筛一批活动问卷,或在编排「创建 → 发布 → 统计」链路前先拉一份列表做对照。手工拼 GET 请求、记正式环境域名和鉴权头,既容易写错 query,也不利于 agent 在多步流程里复用同一份调用约定。

本技能是酷特海外运营平台上的最小颗粒度接口 skill,只负责一个动作:questionnaire_list——查询营销问卷列表。多接口业务由上层 agent 按聚合 skill 或计划文档串联其它原子 skill,本技能只完成本接口并把关键返回字段交给后续步骤。

如何工作

  • 固定走正式环境:GET https://www.kutetailor.com/api/marketing/marketing/questionnaire-info/getQuestionnaire(base_url 来自 skill frontmatter,不接受用户输入覆盖)。
  • 工具参数统一放在嵌套的 params 对象里:最外层只放 params,不要用 params.xxx 这类点号顶层 key。
  • 列表查询条件写在 params.query(分页、关键词等,以网关契约为准);登录态用 params.accessToken 生成 Authorization: Bearer <token>,若值已含 Bearer 则不再重复拼接。
  • 成功时以接口返回的 IPage 结构为事实来源;认证、权限、参数或业务错误时,把原始错误码与错误信息向上传递,不要补造问卷 ID、状态或统计数字。

适用边界与注意点

  • 仅覆盖「查询问卷列表」;创建、编辑、发布、答卷明细等需组合 platform-questionnaire 或其它原子 skill。
  • 仍受当前登录态、租户与用户权限约束;无权限时以接口错误为准,不要猜测可见范围。
  • 返回字段解释与下一步动作(例如点进某条问卷详情)由上层 agent 根据业务目标决定,本 skill 不替你做跨接口编排。

使用场景

  • 海外营销活动上线前,需要按分页拉取正式环境问卷列表,核对标题与状态是否与运营台账一致。
  • 用户给出活动关键词时,通过 query 条件查询问卷列表,选出目标条目再交给详情或统计类 skill。
  • Agent 编排「列表 → 单条详情 → 后续动作」时,本步只调用 getQuestionnaire 并向下游传递 IPage 关键字段。
  • 权限或租户切换后,用同一 accessToken 规范重试列表接口,以接口返回判断可见问卷范围。

适合人员

  • 负责酷特海外站营销问卷配置与上线的运营,需要快速列出正式环境问卷做核对。
  • 正在拼装 platform-questionnaire 业务链路的 Agent 开发者,需要稳定的 questionnaire_list 原子调用约定。
  • 对接 kutetailor 营销接口的后端工程师,要把分页与关键词查询封装进自动化或内部工具。
  • 海外运营平台技术支持,需根据客户提供的 accessToken 复现「查不到问卷」类列表权限问题。