问卷公开编码查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-questionnaire-public-by-code 到你的 AI 助手。
技能介绍
解决什么问题
海外运营团队常需要按公开编码快速拉取问卷配置与内容。如果每次都要重新拼参数、处理认证和租户上下文,重复工作量会分散在多个调用里。本技能把一个平台接口动作封装成最小颗粒度单元:只要给定公开编码,就能用固定正式环境地址完成一次获取,并把关键返回字段交给后续环节。
技能如何工作
- 固定调用
GET https://www.kutetailor.com/api/marketing/marketing/questionnaire-info/public/getQuestionnaireByCode/{code},执行器不从用户输入覆盖base_url。 tool arguments统一放入嵌套params对象:Path 参数写params.path,Query 写params.query,JSON Body 写params.body,额外 Header 写params.headers。- 登录态接口使用
params.accessToken生成Authorization: Bearer;若传入值已含 Bearer,不重复拼接。 - GET/DELETE 把查询参数放 URL query;POST/PUT 默认发送 JSON body,若上层网关另有契约则以网关为准。
- 返回结果以接口响应为事实来源,不补造库存、价格、订单号、优惠金额或物流状态。
适用边界与注意点
- 只完成本接口动作
public_by_code;需要多步骤时,由上层 agent 按聚合 skill 或计划文档编排多个原子 skill。 - 仍需遵守当前登录态、租户和用户权限;认证、权限、参数或业务错误会原样传递错误码和信息。
{code}来自 Path 参数,必须由调用方提供;不要把它写成顶层点号 key,如params.code。
使用场景
- 运营同学拿到活动页上的公开编码,需要拉取问卷内容配置,投放前逐项核对题目。
- 上层 agent 编排问卷流程时,需要先按编码获取问卷详情,再把关键字段交给后续技能。
- 技术支持排查问卷打不开问题时,需要用编码直接请求接口,确认服务端返回内容。
- 新问卷上线后,内容团队需要按公开编码验证接口能否正确返回问卷配置。
适合人员
- 海外运营专员:经常需要按公开编码拉取问卷配置,核对后用于活动投放与日常维护。
- 上层 agent 开发者:要把该原子接口编排进完整问卷业务流程,并按规范传递参数。
- 技术支持工程师:需要用编码直接调用接口,排查认证、权限或返回内容异常。
- 后端集成工程师:需要按嵌套 params 规范对接固定正式环境地址,完成平台接口集成。