在使用 Codeium 生成接口调用示例代码时，为了确保输出真正符合实际业务需求，必须让模型清晰了解目标用户群体（例如：前端新手、测试工程师、运维值班人员）以及具体应用场景（例如：接口联调、自动化测试、文档编写）。否则，生成的代码往往参数写死、缺少错误处理机制，甚至与项目技术栈不匹配。本教程将手把手教你如何在提示词中精准指定人群与场景，让 Codeium 输出可直接用于生产的高质量示例。
为何必须明确人群与场景？
若不指定人群和场景，Codeium 默认输出“通用”示例，比如 Java 后端开发常给出 RestTemplate 调用，但若面向前端开发者，更希望看到 fetch + async/await；若面向测试人员，则期望看到 pytest 框架结构。此外，场景中的约束条件（如是否需要模拟登录、是否跳过快照）直接影响代码的健壮性。因此，在提示词中明确角色与上下文，是生成精准代码的第一步。
第一步：在提示词开头明确声明人群与场景
- 用一句话点明身份和上下文：
例如：“你是一位有三年经验的 Java 后端工程师，正在给新来的前端同事写一个供联调使用的 /user/profile 接口调用示例”。 - 具体化人群：避免使用“开发者”“相关人员”等模糊词，直接写 “iOS 客户端同学”“运维值班人员”“负责灰度发布的 SRE”。人群越具体，Codeium 越倾向于使用该角色的惯用技术栈和协作方式——比如给前端用 fetch+async/await，给运维用 curl + -H + -X 并附带超时参数。
- 场景带动作动词和约束条件：不要只说“用于测试”，而要写 “用于每日构建流水线中的自动化冒烟测试，要求 100% 返回 JSON 且不依赖登录态”。这能触发 Codeium 生成带 mock token、无鉴权头、断言 status=200 的代码。
小提示：如果接口版本有明确依赖，也可以在人群声明中带上技术栈版本，例如“Angular 17 前端工程师”或“Python 3.11 + requests 库”。
第二步：用括号嵌入式补充关键限制
在接口描述后紧跟括号说明，格式统一为：
（面向【人群】，用于【场景】）
示例：
POST /api/v2/orders/create（面向 Flutter 开发同学，用于本地模拟下单流程，需跳过风控校验）
注意：括号必须紧贴接口路径，中间不能换行或空行，否则 Codeium 可能忽略。
如果场景涉及权限或环境差异，括号里要体现。例如：
GET /metrics/health（面向 SRE 值班同学，用于 K8s readiness probe，仅检查 HTTP 200，不解析响应体）
第三步：选用两种高效方法
方法一：用角色指令前置强化（推荐给复杂接口）
在提示词第一行写：
“Act as a [人群] who needs to [场景动作] with this API:”
示例：
“Act as a junior Python backend intern who needs to write a retryable call to POST /v1/notifications/send for a cron job that runs every 5 minutes”
这样 Codeium 会自动加入 requests.Session、指数退避、日志埋点等符合该角色认知的惯用写法。
方法二：在示例要求中绑定输出格式与人群习惯
在提示词末尾追加一句：
“请按[人群]日常协作方式输出：”
- 给前端：输出 JavaScript + 注释说明每个参数如何从 Vue 组件 data 里取值；
- 给测试：输出 Pytest 函数 +
pytest.mark.parametrize参数表格； - 给文档工程师：输出 Markdown 代码块 + 每行右侧用
标注（例如）。
常见问题（FAQ）
Q1：如果我同时要给多个角色写示例怎么办？
可以分多次生成，每次只指定一个角色。或者在同一提示词中按顺序分别写明：
先给 iOS 同学写一个 fetch 版本，再给后端同学写一个 Go 版本。 但建议分开提示，避免模型混淆。
Q2：场景里包含多个约束条件，括号里写不下怎么办？
可以拆分成两行：第一行是接口括号描述，第二行用“注意”补充。例如：
POST /api/v2/payments (面向支付团队，用于联调环境)
注意：必须添加签名头 X-Sign，超时设为 5s，失败后重试1次。
Q3：Codeium 生成了代码但不符合预期，如何调整？
检查提示词中是否遗漏了人群或场景的动作动词。例如“用于测试”太宽泛，改为“用于冒烟测试，不依赖外部服务”后效果会明显改善。另外，在末尾添加 请输出带超时和错误处理的完整代码。 也能提升质量。
总结
通过声明身份+具体化人群+带动作的场景，配合括号嵌入式限制和两种结构化方法，你可以让 Codeium 每次生成的接口调用示例代码都贴近真实协作环境，大幅减少后续修改成本。记住：细节越精确，代码越实用。