技能介绍

要解决什么问题

在海外运营场景里，问卷往往通过公开编码对外投放：用户或客服只有 code，需要查到对应问卷的配置与内容，才能继续展示、校验或对接下游流程。若把 HTTP 细节、环境地址和参数形状都交给对话层临时拼，容易搞错 Path、覆盖正式环境 base_url，或在多步链路里重复实现同一 GET。

本技能是 platform-questionnaire 聚合能力下的原子接口，只负责动作 public_by_code：用编码向酷特海外运营平台拉取问卷信息。

技能如何工作

固定正式环境：请求走 frontmatter 中的 https://www.kutetailor.com/api/marketing，对应路径 GET /marketing/questionnaire-info/public/getQuestionnaireByCode/{code}，执行器不接受用户输入覆盖 base_url。
参数约定：tool 参数统一放在嵌套对象 params 里；Path 中的 {code} 写入 params.path，Query / Body / 额外 Header 分别用 params.query、params.body、params.headers。
返回与错误：以接口响应为准，不补造库存、订单号等业务字段；认证、权限、参数或业务错误时，把原始错误码和信息交给上层 Agent 处理。

需要「创建问卷 → 发布 → 统计」等多步时，由上层按聚合 skill 或计划文档编排多个原子 skill；本技能只完成公开编码获取问卷这一步，并把关键返回字段交给后续步骤。

适用边界

触发条件：用户明确需要按公开编码查询问卷。
若需求包含多个接口步骤，本 skill 仅调用本接口，不替代完整业务链路。
虽为公开路径，仍须遵守当前登录态、租户与用户权限；需要 Bearer 时使用 params.accessToken（值已含 Bearer 则不再重复拼接）。

截图预览

使用场景

客服收到用户提供的问卷公开编码，需要核对正式环境里该问卷的标题、题目结构与是否仍可访问。
上层 Agent 编排「先按编码拉问卷、再校验答案或跳转下一步」时，只需调用本技能完成 GET 查询并传递返回字段。
海外投放落地页只带了 `code` 参数，运营要在上线前确认接口返回的问卷配置与活动页一致。
联调或排查「编码无效」类问题时，用固定正式环境地址单次调用，对照原始错误码与业务报错信息。

适合人员

负责酷特海外问卷投放的运营，经常只有活动链接里的公开编码，需要查正式环境问卷详情再改页或回传业务系统。
在 Agent 里拼装 platform-questionnaire 链路的集成工程师，要把 public_by_code 做成不可被用户改 base_url 的原子步骤。
处理海外用户「打不开的问卷」工单的客服主管，需用编码调用接口确认是编码错误、权限还是问卷已下线。
对接 kutetailor.com 营销模块的后端开发，在自动化脚本里按 Path 参数 `code` 拉取 RS 结构供下游渲染。