酷特海外运营问卷列表查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-questionnaire-questionnaire-list。
技能介绍
要解决什么问题
海外运营侧经常需要核对问卷配置是否上线、按关键词筛一批活动问卷,或在编排「创建 → 发布 → 统计」链路前先拉一份列表做对照。手工拼 GET 请求、记正式环境域名和鉴权头,既容易写错 query,也不利于 agent 在多步流程里复用同一份调用约定。
本技能是酷特海外运营平台上的最小颗粒度接口 skill,只负责一个动作:questionnaire_list——查询营销问卷列表。多接口业务由上层 agent 按聚合 skill 或计划文档串联其它原子 skill,本技能只完成本接口并把关键返回字段交给后续步骤。
如何工作
- 固定走正式环境:
GEThttps://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 复现「查不到问卷」类列表权限问题。