Agent Skills
返回列表
kutesmart 问卷详情

kutesmart 问卷详情

开发编程 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-questionnaire-questionnaire-detail

技能介绍

它解决什么问题

在海外运营平台的问卷模块里,“查看某个问卷的详情”看似一句简单诉求,落到代码里却是一串具体决策:请求打到哪里、questionnaireId 拼在 path 还是 query、登录态怎么带、拿到错误码要不要原样透传。如果每个调用方都自己写一遍 HTTP 客户端逻辑,维护成本会随接口数量线性增长。这个 skill 把单一接口动作 questionnaire_detail 封装成最小颗粒度的调用单元,让上层 agent 不必关心传输细节,只拿到结构化结果继续编排。

技能如何工作

核心只有一次请求:

  • 方法与地址:GET,正式环境固定为 https://www.kutetailor.com/api/marketing/marketing/questionnaire-info/getQuestionnaireDetails/{questionnaireId},base_url 写在 frontmatter 中,执行器不允许被用户输入覆盖。
  • 参数传递:所有 tool arguments 收进一个嵌套的 params 对象。questionnaireId 作为 path 变量放进 params.path,由执行器替换 URL 中的 {questionnaireId};query 放 params.query,body 放 params.body,额外 header 放 params.headers。最外层不会出现 params.xxx 这类点号 key。
  • 鉴权:登录态通过 params.accessToken 生成 Authorization: Bearer;若传入值已带 Bearer 前缀,不会重复拼接。
  • 结果处理:以接口响应为唯一事实来源,原样返回;出现认证、权限、参数或业务错误时,把原始错误码和错误信息透传给上层 agent。

适用边界

这是一个原子 skill:只完成这一次接口调用,不会自动续接其他步骤。如果业务链路需要先查列表再拉详情、再提交答卷,应由上层 agent 按聚合 skill platform-questionnaire 或计划文档编排多个原子 skill,并把关键返回字段逐个交给后续环节。此外它属于查询类接口,仍需遵守当前登录态、租户与用户权限约束,返回结果中不会补造任何接口未给出的库存、价格或订单类数据。

使用场景

  • 在运营后台开发问卷模块时,需按questionnaireId直接获取指定问卷的标题与选项数据
  • 当Agent需要查询某份问卷的详情且只调用该接口时,按params规范构造path参数发起GET请求
  • 排查问卷详情接口返回的认证或权限错误时,需透传原始错误码与信息给上层逻辑定位
  • 在构建问卷业务链路时,仅拉取单份问卷详情并传递给后续步骤继续处理

适合人员

  • 需要调用问卷详情接口的Agent开发者,诉求是统一封装params参数避免重复写传输逻辑
  • 对接海外运营平台接口的后端工程师,诉求是确保请求构造符合鉴权与URL拼接约定
  • 需要把问卷详情嵌入自动化工作流的集成者,诉求是用原子接口完成单一查询动作
  • 排查问卷接口权限或参数错误的技术支持,诉求是保留原始错误信息便于定位问题