酷特海外运营平台 · 问卷详情
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-questionnaire-questionnaire-detail。
技能介绍
要解决什么问题
在海外运营场景里,客服、营销或运营 Agent 经常需要先看清一份问卷长什么样:题目结构、配置项、状态字段等,才能决定下一步是展示给用户、做校验还是串联下单/发券流程。若让大模型直接「猜」问卷内容,容易和平台真实数据不一致。
本技能只做一件事:按 questionnaireId 调用酷特海外运营平台正式环境的问卷详情接口,把接口返回当作事实来源交给上层逻辑。
技能如何工作
- 动作:
questionnaire_detail,对应GET /marketing/questionnaire-info/getQuestionnaireDetails/{questionnaireId}。 - 参数约定:
tool arguments最外层仅使用嵌套的params;路径变量写在params.path.questionnaireId(或按网关要求的 path 结构),查询写在params.query,额外头写在params.headers。 - 环境与鉴权:
base_url固定在技能 frontmatter(正式域www.kutetailor.com),不得用用户输入覆盖。需登录态时通过params.accessToken生成Authorization: Bearer …;若已含Bearer前缀则不再重复拼接。 - 编排定位:属于
platform-questionnaire聚合能力下的最小粒度接口 skill;多步业务(列表 → 详情 → 提交等)由上层 Agent 按聚合 skill 或计划文档组合多个原子 skill。
适用边界与注意点
- 本技能只完成单次详情查询;列表、创建、提交等需使用同系列其它 action/skill。
- 返回字段必须以接口响应为准,不要补造库存、价格、订单号或业务状态。
- 若返回认证、权限、参数或业务错误,应把原始错误码与错误信息透传给上层 Agent 处理,而不是在本地改写结论。
使用场景
- 营销 Agent 已从列表接口拿到 questionnaireId,需要拉取题目与配置字段后再生成对用户的话术
- 客服机器人收到「这份海外问卷具体内容」的追问,需按 ID 查询平台真实详情再逐条解释
- 编排「列表→详情→提交」链路时,本步只负责详情 GET,把 RS 交给后续校验或展示 skill
- 运营复盘时要核对某次活动问卷在平台上的实际结构与状态,避免用缓存或截图里的过期信息
适合人员
- 对接酷特 kutetailor 营销问卷接口、要在 Agent 里封装 questionnaire_detail 的后端或集成工程师
- 海外运营平台的客服/营销自动化负责人,需要让助手只依据正式环境问卷详情回答用户
- 维护 platform-questionnaire 聚合 skill、用多个原子接口拼装完整问卷业务链路的 Agent 开发者
- 活动运营同学,在已有问卷 ID 的前提下要核对线上问卷题目与配置是否与活动方案一致