Microsoft Copilot把接口返回示例写成字段说明提示词怎么给AI一段参考风格

先说一个真实痛点：当你想让AI（比如Microsoft Copilot）把接口返回的JSON字段解释清楚，而不是丢给你一串示例代码时，往往会发现它固执得像块石头——你说“解释字段”，它回手一个JSON结构，气得你只想拍桌子。

问题的关键出在提示词上。AI普遍存在一个“示例优先”的本能：你给它的输入里只要出现过一段JSON，它就觉得该模仿这个格式继续输出。所以，想要让Copilot老老实实地输出“字段说明”而非“接口示例”，你需要一整套反制策略，从“指令前置”到“风格锚定”，再到“漏洞封堵”，一个都不能少。

明确指令AI输出字段说明而非原始示例

第一个动作：从一开始就把方向定死。在提示词的第一行直接告诉Copilot：“请将以下接口返回JSON中的每个字段，逐条解释其业务含义、可选值范围、是否必填、典型使用场景，不要输出任何JSON示例代码。”

这一步必须前置。如果你把一个JSON示例先甩给AI，再在底下补一句“解释一下”，它大概率会无视后面的要求——因为AI的注意力天然倾向于模仿它之前见过的格式。先立规矩，再给素材，顺序决定了结果的走向。

提供带风格锚点的参考样例

光说“要输出字段说明”远远不够，AI需要一个活生生的模板来理解你到底要什么。这有两种经过检验的有效套路。

方法一：用对比式样例突出差异

给出一对正反例子，左边是AI容易默认产出的“坏样例”，右边是你想要的“好样例”，并在好样例旁用括号标注风格特征。这种对比的冲击力很强，AI能直观地明白两种输出的天壤之别。

❌ bad：{"code": 0, "data": {"id": 123}}
✅ good：code：接口响应码，整型，0表示成功，非0表示失败（如-1=参数错误，-2=权限不足），前端需根据该值跳转不同错误页（【字段说明需含类型+取值逻辑+前端处理动作】）

方法二：用符号标记强化结构预期

另一种思路：在参考样例中强制使用固定分隔符和缩进，让AI捕捉到一种排版“节奏”。实测下来，箭头符号→的效果比短横线或数字编号更稳定——它像是一个并列字段的视觉分界线，AI能清晰地看出每个字段说明都是同一层级的内容。

id：用户唯一标识符，字符串类型，长度6～32位，由后端UUID生成，不可为空
→ nickname：用户昵称，字符串类型，允许为空，前端展示时若为空则显示“匿名用户”
→ a vatar_url：头像图片地址，字符串类型，HTTPS协议，若为空则返回默认头像CDN链接

封住AI自由发挥的常见漏洞

正面引导做好了，还得防着AI自己发挥出一些“出人意料”的花样。有三类漏洞是高频出现的，必须提前堵死。

第一步：禁止生成JSON块。在提示词末尾追加一条硬性约束：“输出内容中不得出现任何大括号、方括号、冒号、逗号或缩进空格——所有内容必须是纯中文自然语言描述。” 这样一来，AI就算想偷懒丢给你一个JSON块，也会触发格式冲突，被迫转向纯文字说明。

第二步：堵死“例如”“比如”类模糊表达。AI特别喜欢用“例如”来回避精准说明，一个“常见取值有例如0和1”几乎等于什么都没说。需要补充限制：“每个字段说明必须包含且仅包含以下四要素：字段名、数据类型、取值规则（含枚举或范围）、业务影响。不允许出现‘一般’‘通常’‘可能’等模糊副词。”

第三步：指定字段顺序。AI有一个高频错误：自动省略注释为空或看似不重要的字段。你必须显式要求“按接口文档中字段声明顺序逐条说明，不得调整顺序，不得合并字段，不得省略注释为空的字段”。这里的关键字是“省略空字段”——没有这一条，你会发现AI直接跳过了你所有没写注释的字段，而剩下的字段顺序也可能被重新排序。

综上，这三大类指令构成了一个完整的提示词框架：先定目标，再给样板，最后堵漏洞。每一步都有明确的逻辑和目标，你只需要按这个结构填上实际字段内容即可。从实际效果来看，这套策略能让Copilot一次性输出你想要的纯字段说明，而不是又交出一段JSON示例来糊弄你。