请按以下结构输出:【1. 接口地址】→【2. 请求方法】→【3. 请求头(含鉴权字段)】→【4. 请求体示例(JSON格式,字段名加注释)】→【5. 响应成功示例】→【6. 常见错误码及含义】→【7. 特别注意项(必须包含签名生成步骤、超时阈值、重试策略)】。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要让Copilot生成一份接口对接说明文档,但每次输出都漏掉签名算法、超时时间、重试机制等关键字段,导致开发同事反复追问细节。
明确告诉Copilot你要什么格式
在提示词开头就写清输出结构,例如:“请按以下结构输出:【1. 接口地址】→【2. 请求方法】→【3. 请求头(含鉴权字段)】→【4. 请求体示例(JSON格式,字段名加注释)】→【5. 响应成功示例】→【6. 常见错误码及含义】→【7. 特别注意项(必须包含签名生成步骤、超时阈值、重试策略)】”。
这一步不能省——Copilot不会自动补全你没提的结构,它只响应你明示的内容。
用占位符锁定关键信息位置
在请求体或响应体示例中,对不可省略的字段使用大写占位符,比如:"timestamp": "UNIX_TIMESTAMP_MS", "sign": "SHA256(app_key+app_secret+timestamp+nonce)", "timeout_ms": 3000。
占位符本身不是真实值,但它强制Copilot保留该字段并标注计算逻辑,避免被简化为“其他参数”一笔带过。
【签名字段必须带计算公式,否则Copilot会默认写成“sign: string”】
给Copilot喂一个最小但完整的样例
方法一:直接粘贴一段你已确认无误的旧接口说明(哪怕只有3行),并在前面加一句:“以下为标准格式参考,请严格按此风格和字段粒度生成新接口说明:”。
Outlook 日历 / Microsoft 365 日历 SECURE API CLI。当用户需要列出、搜索或读取 Outlook / Microsoft 365 日历事件,以及创建……
方法二:用表格形式给出字段清单,例如:| 字段名 | 类型 | 必填 | 说明 | 示例 |
|--------|------|------|------|------|
| nonce | string | 是 | 随机字符串,防重放 | “a1b2c3d4” |
| sign | string | 是 | SHA256(app_key+app_secret+timestamp+nonce) | “e8f7...” |。
Copilot对表格理解极强,比纯文字描述更能锚定字段层级和约束条件。
禁止模糊表述,替换所有“相关”“某些”“一般”
第一步:删掉提示词里所有“相关参数”“部分字段需签名”“一般建议设置超时”这类表达。
第二步:替换成确定性指令,例如:“所有请求必须携带 nonce 字段,长度为8~32位小写字母+数字组合,服务端校验重复请求将直接拒绝”。
第三步:对超时时间写死数值,“HTTP连接超时设为1500ms,读取超时设为2500ms,超出即断开并返回504”。
Copilot不处理概率性语言,它只会把“一般”当成可选项跳过。

















