请将以下接口返回JSON中的每个字段,逐条解释其业务含义、可选值范围、是否必填、典型使用场景,不要输出任何JSON示例代码。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要让microsoft copilot在生成接口返回示例时,不堆砌json结构,而是把每个字段转化成带业务含义的中文说明,比如“status:响应状态码,取值为200(成功)、401(未登录)、500(服务异常)”,而不是只写"status: 200"。明确指令AI输出字段说明而非原始示例
在提示词开头直接限定输出格式:“请将以下接口返回JSON中的每个字段,逐条解释其业务含义、可选值范围、是否必填、典型使用场景,不要输出任何JSON示例代码。”
这一步必须前置——如果先放示例再提要求,Copilot大概率会优先模仿示例格式,忽略后续说明。
提供带风格锚点的参考样例
方法一:用对比式样例突出差异
给出一对正反例子,左边是Copilot容易默认输出的“坏样例”,右边是你想要的“好样例”,并在好样例旁加括号标注风格特征:
❌ bad:{"code": 0, "data": {"id": 123}}
✅ good:code:接口响应码,整型,0表示成功,非0表示失败(如-1=参数错误,-2=权限不足),前端需根据该值跳转不同错误页(【字段说明需含类型+取值逻辑+前端处理动作】)
方法二:用符号标记强化结构预期
在参考样例中强制使用固定分隔符和缩进,让Copilot捕捉排版节奏:
id:用户唯一标识符,字符串类型,长度6~32位,由后端UUID生成,不可为空
→ nickname:用户昵称,字符串类型,允许为空,前端展示时若为空则显示“匿名用户”
→ avatar_url:头像图片地址,字符串类型,HTTPS协议,若为空则返回默认头像CDN链接
使用 Microsoft markitdown 将 PDF、Word、PowerPoint、Excel、图片、音频、HTML 等多种格式转换为 Markdown,支持 OCR、音频等功能。
注意:箭头→在这里不是操作路径,而是Copilot识别“并列字段说明”的视觉线索,实测比用短横线或数字编号更稳定触发对应格式。
封住AI自由发挥的常见漏洞
第一步:禁止生成JSON块
在提示词末尾追加硬性约束:“输出内容中不得出现任何大括号{ }、方括号[ ]、冒号:、逗号, 或缩进空格——所有内容必须是纯中文自然语言描述。”
第二步:堵死“例如”“比如”类模糊表达
补充限制:“每个字段说明必须包含且仅包含以下四要素:字段名、数据类型、取值规则(含枚举或范围)、业务影响。不允许出现‘一般’‘通常’‘可能’等模糊副词。”
第三步:指定字段顺序
“按接口文档中字段声明顺序逐条说明,不得调整顺序,不得合并字段,不得省略注释为空的字段。”【省略空字段是Copilot高频错误,必须显式禁止】

















