Agent Skills
返回列表
酷特海外运营问卷分享

酷特海外运营问卷分享

AI Agent 更新于 2026.08.30

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

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

技能介绍

要解决什么问题

在海外运营场景里,营销问卷往往需要生成可对外分享的链接或分享态数据,而不是只在后台列表里「看得到」。若 Agent 要帮运营同学完成「把某份问卷分享出去」这一步,必须调用酷特海外运营平台(Kutetailor 正式环境)的专用接口,而不是凭经验拼 URL 或臆造分享结果。

本技能是 最小颗粒度的原子 skill,只负责 share_questionnaire 这一动作:根据问卷 id 发起一次 GET,把接口真实返回交给上层编排。

技能如何工作

  • 固定端点:执行器使用 frontmatter 中的正式环境 base_url,调用路径为 /marketing/questionnaire-info/shareQuestionnaire/{id},不接受用户输入覆盖域名或环境。
  • 参数形态:tool 入参最外层仅允许 params 对象;路径参数写在 params.path.id,登录态通过 params.accessToken 生成 Authorization: Bearer(若已含 Bearer 则不重复拼接)。
  • 请求方式:share_questionnaire 为 GET,无 JSON Body;查询类接口仍受租户、用户与登录权限约束。
  • 返回与错误:以接口响应为唯一事实来源,不补造订单号、优惠或库存类字段;认证、权限、参数或业务错误时,应把原始错误码与信息回传给聚合 Agent 或后续 skill。

适用边界与注意点

  • 若用户需求包含「创建问卷 → 发布 → 多渠道分享 → 统计」等多步链路,本 skill 只完成分享接口调用;完整流程需参考聚合 skill platform-questionnaire 或由上层按计划文档串联多个原子 skill。
  • 与同类「问卷信息查询」接口不同,本接口语义是 分享,编排时勿与其它 questionnaire-info 动作混用参数模板。

使用场景

  • 海外运营对话中用户已给出问卷 `id`,Agent 需调用正式环境 GET 接口获取该问卷的分享返回(RS),不能自行构造分享链接。
  • 在 `platform-questionnaire` 多步编排里,前序 skill 已确定问卷编号,本步仅执行 `share_questionnaire` 并把关键字段交给后续统计或分发 skill。
  • 集成测试或联调时,验证带 `accessToken` 的 Bearer 鉴权下,指定 path `id` 能否正确命中 `/shareQuestionnaire/{id}` 端点。
  • 用户只说「分享这份问卷」且上下文已有问卷 ID 时,上层 Agent 用本 skill 完成单次接口调用,错误码与原文信息需透传以便重试或改权限。

适合人员

  • 负责 Kutetailor 海外问卷投放、需要在对话或自动化里按 ID 拉取官方分享结果的营销运营
  • 把酷特 `marketing/questionnaire-info` 接口拆成可编排原子 skill 的后端或企业集成工程师
  • 维护 `platform-questionnaire` 聚合文档、要在「选定问卷」之后插入分享步骤的 Agent 工作流设计者
  • 对接酷特正式环境且需遵守「不覆盖 base_url、params 嵌套」契约的 MCP/工具执行器维护者