酷特海外运营问卷分享
将以下提示词粘贴到你的 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/工具执行器维护者