你是一位有8年SaaS平台API运维经验的DevOps工程师，负责为第三方开发者编写故障响应手册；请为豆包大模型API的HTTP状态码400/401/404/429生成错误说明，每条必须包含：①错误本质（非字面翻译）、②3个最常见触发场景、③对应检查项清单（带具体命令或代码片段）、④修复后验证方式；仅返回纯Markdown表格，表头为：错误码｜本质｜典型场景｜检查项｜验证方式；禁止任何解释性文字、序号、空行或额外段落；已知信息：豆包当前稳定Endpoint为https://ark.cn-beijing.volces.com/api/v3/chat/completions；API Key须为Bearer sk-xxx格式；模型ID必须为ep-开头的正式发布版本；QPM限额默认为60。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你需要让豆包生成一份面向开发者的api错误码说明文档，且要求每条错误码都附带可操作的排查路径与修复动作，就不能只写“401是认证失败”这种泛泛而谈的描述。用角色+任务+结构三要素锁定输出质量
第一步：在提示词开头直接锚定身份与职责，例如：“你是一位有8年SaaS平台API运维经验的DevOps工程师，负责为第三方开发者编写故障响应手册”。
第二步：明确本次生成的核心任务，“请为豆包大模型API的HTTP状态码400/401/404/429生成错误说明，每条必须包含：①错误本质（非字面翻译）、②3个最常见触发场景、③对应检查项清单（带具体命令或代码片段）、④修复后验证方式”。
第三步：强制结构化输出，“仅返回纯Markdown表格，表头为：错误码｜本质｜典型场景｜检查项｜验证方式；禁止任何解释性文字、序号、空行或额外段落”。
注入真实上下文避免幻觉
在提示词中嵌入不可推导的关键事实：“已知信息：豆包当前稳定Endpoint为https://ark.cn-beijing.volces.com/api/v3/chat/completions；API Key须为Bearer sk-xxx格式；模型ID必须为ep-开头的正式发布版本；QPM限额默认为60”。
立即进入“豆包AI人工智官网入口”；
立即学习“豆包AI人工智能在线问答入口”；
这一步不能省略——没有这些锚点，豆包可能虚构出已下线的/v1/chat/completion路径，或编造不存在的405错误码。你提供的上下文越精确，它越不会自由发挥。
【注意：必须写明“已知信息：”前缀，否则豆包会忽略该段内容】
用正负示例控制表达粒度
方法一：给出合格样例引导风格
“示例输出（401）：
|401|服务端未识别凭证有效性|①Authorization头缺失；②写成authorization小写；③Key前漏掉Bearer空格|curl -H 'Authorization: Bearer sk-xxx' ...|重发请求，检查响应头是否含X-RateLimit-Remaining|”
方法二：插入硬性排除指令
“禁止出现‘建议’‘可以’‘通常’等弱动词；所有检查项必须可执行，如‘运行python -c "import requests; print(requests.get(...))"’而非‘检查网络连接’；验证方式必须含具体可观测指标，如‘响应体含code字段且值为MissingParameter.model’”
分步拆解复杂判断逻辑
第一步：提取官方错误码列表中所有4xx/5xx状态码及其message字段原文；
第二步：对每个错误码，按“网络层→认证层→参数层→服务层”顺序归因，例如404必须先排除URL拼写，再查Endpoint区域（cn-beijing≠cn-shanghai），最后确认是否误用了视觉服务域名；
第三步：为每个归因层级匹配一个终端可验证动作，比如“检查URL拼写”对应“在shell中执行echo $URL | hexdump -C | grep '20'确认无空格”，而不是模糊说“检查一下”。
