你是一位后端api错误文案设计师,专为生产环境设计三层错误输出,严格区分【开发层】【用户层】【协议层】,禁止跨层混用术语;【开发层】含错误码、异常类名、触发条件、关键变量值;【用户层】禁用技术名词,≤28字,中性带引导;【协议层】仅返回code(整数)、message(用户层文案)、details(开发层摘要,不含堆栈)。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要让Copilot生成的错误信息文案既能让开发人员快速定位问题,又不向终端用户暴露敏感细节或技术栈信息,同时还要在不同场景下自动匹配输出层级——比如日志里要带堆栈和上下文,前端弹窗里只显示友好提示,API响应中则需结构化code+message+details三段式字段。
用角色+输出约束锁定基础层级
在提示词开头明确设定角色与输出边界:你是一位后端API错误文案设计师,专为生产环境设计三层错误输出。所有响应必须严格区分【开发层】【用户层】【协议层】,且禁止跨层混用术语或信息。
紧接着写明硬性约束:【开发层】必须含错误码、完整异常类名、触发条件、关键变量值;【用户层】禁用任何技术名词,字数≤28字,语气中性带引导;【协议层】必须返回JSON,字段仅允许code(整数)、message(用户层文案)、details(开发层摘要,不含堆栈)。
这一步漏掉“禁用任何技术名词”会导致Copilot在用户层写出“HTTP 400 Bad Request”这类无效文案。
注入上下文锚点触发自动分层
方法一:在提示中嵌入调用位置标识
在待生成错误文案的代码片段上方添加注释行:# 调用位置:用户注册接口 POST /api/v1/register → 前端弹窗展示 → 日志级别 ERROR → OpenAPI规范要求code=4001。Copilot会据此自动将输出导向【用户层】+【协议层】组合,跳过【开发层】。
微软 Outlook 邮箱和日历管理工具(支持世纪互联版 Office 365)。用于查看、发送、搜索邮件,管理日历日程,创建会议,查询忙闲状态。注意:此功能仅支持世纪互联(21Vianet)版 Microsoft 365,使用 login.chinacloudapi.cn。
方法二:用分隔符强制分段生成
在提示末尾插入三段式分隔标记:
---DEV---
---USER---
---PROTO---
然后粘贴原始报错日志(含堆栈)。Copilot会把内容分别填入对应分隔符下方,且【USER】段不会出现“NullPointerException”或“line 42”字样。
通过负向示例封堵常见越界行为
第一步:列出三个Copilot高频越界错误
① 用户层文案含“500 Internal Server Error”
② 协议层details字段塞进完整堆栈trace
③ 开发层描述里写“请检查数据库连接”,但当前错误实际是Redis超时
第二步:在提示末尾加一句否定指令
禁止生成任何与上述三条示例语义相同或近似的文案,尤其不得用“检查XX”句式替代具体根因分析。
第三步:提供正向对照样本
错误场景:邮箱格式校验失败
✅ 开发层:code=4002,EmailValidationException,输入值“test@”,@后缺少域名,regex /^[^\s@]+@[^\s@]+\.[^\s@]+$/ 不匹配
✅ 用户层:请输入正确的邮箱地址
✅ 协议层:{"code":4002,"message":"请输入正确的邮箱地址","details":"邮箱格式不合法:'test@'缺少域名部分"}










