qoder需基于标准openapi或postman collection格式文档生成sdk代码；提示词须含角色定义、输入约束、输出要求三段式结构；必须显式声明鉴权方式、环境参数及容错逻辑，否则生成代码不可运行。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要让Qoder根据已有接口文档自动生成调用代码，但提示词写得模糊或缺关键要素，结果生成的代码无法直接运行、参数名错乱、甚至漏掉鉴权逻辑。
明确输入源类型
先确认你手头的接口文档格式：是 Swagger JSON/YAML 文件？还是 Postman Collection v2.1 导出的 JSON？又或是纯 Markdown 描述？【Qoder 不支持直接解析网页截图、PDF 或 Word 文档】。如果是截图或 PDF，请先用工具（如 Swagger Editor、Postman 的 Import → Paste Raw Text）转成标准 OpenAPI 或 Collection 格式。
这一步必须做，否则后续所有提示词都无效。
构造基础提示词结构
用三段式写法，每段不可省略：
① 角色定义：你是一个 Python SDK 生成专家，熟悉 requests、httpx 和 Pydantic，输出代码需兼容 Python 3.9+；
② 输入约束：以附件形式提供 OpenAPI 3.0.3 YAML 文件，其中包含 /api/v1/users POST 接口，含 x-api-key header、body 为 application/json、schema 定义完整；
③ 输出要求：生成一个可直接 import 的模块，含 UsersApiClient 类、create_user 方法，参数自动映射到 Pydantic 模型，错误响应统一抛出 ApiError 异常，不写示例调用或 print 语句。
Qoder Linux版是由阿里推出的智能体自主开发工作台，支持开发者通过定义需求即可让Agent团队“自动驾驶”，自主完成代码执行、验证与交付的全流程。其全新的Quest独立视窗集成了任务管理与状态追踪能力，并支持跨项目多任务并行处理，显著提升开发效率。此外，Qoder还提供专家团模式与团队级知识引擎，适配复杂开发场景。
针对不同语言的关键词替换
方法一（Python）：在输出要求中加入“使用 typing.Union 而非 | 表示联合类型，因目标环境为 Python 3.9”；
方法二（TypeScript）：把“Pydantic 模型”换成“Zod schema + TypeScript interface”，并强调“所有字段启用 strict: true 验证”；
方法三（Java）：指定“使用 Lombok @Data + Jackson @JsonProperty，日期字段用 java.time.LocalDateTime，不要用 Date”。
注意：Java 方法里若没写 【必须用 javax.annotation.Nullable 标注可空字段】，生成的 DTO 会默认全非空，导致反序列化失败。
补全鉴权与环境适配细节
第一步：在输入约束中显式声明鉴权方式——例如“该 API 使用 Bearer Token，token 通过 Authorization: Bearer {token} 传入，token 来自 /auth/token 接口响应 body.token 字段”；
第二步：在输出要求中追加“UsersApiClient 初始化时必须接受 base_url 和 token 参数，base_url 示例为 https://api.example.com，不可硬编码”；
第三步：补充容错说明：“当 HTTP 状态码为 401 时，应清空当前 token 并抛出 AuthExpiredError；429 响应需解析 Retry-After 头并 sleep 后重试一次”。
