Codeium接口调用示例提示词：输出层级控制技巧

Codeium接口调用指南：若需强制按指定层级输出，关键在于提示词必须明确锚定结构深度，而非依赖模糊表述。

举例说明：若希望Codeium生成的JSON响应仅保留两层结构，切勿使用“稍微简化一下”这类指令，直接声明“响应体JSON保持扁平化，嵌套对象用{...}占位”。Codeium对具象指令的解析准确度，远高于“简洁一点”这类泛化描述。

用关键词锁定层级范围

在提示词末尾明确写入层级控制指令是关键操作。例如“仅输出一级键名，不递归展开value”，或“嵌套对象采用{...}占位”。Codeium会优先匹配此类清晰描述，而非你脑中的“大概意思”。

实操极为简单：只需将层级指令直接附加在接口描述之后。但需警惕，若提示词中混用“简化”“精简”“不要太深”这类模糊表述，Codeium很可能忽略层级要求，转而削减字段数量——结果将偏离预期。

用符号标记显式分层边界

方法一：用缩进符号强制约束
在提示词中插入带层级标识的模板，效果立竿见影。例如：

GET /api/users

→ query: {page: number, size: number}

→ response: {data: [...], total: number, page_info: {...}}

方法二：用注释框定范围
添加类似// 层级限制：response仅保留顶层字段，子对象不展开的注释行。注意，注释必须紧贴代码块上方，且仅限双斜杠格式（Codeium对Markdown注释支持不稳定）。
【注释位置错开一行或用其他符号包裹会导致失效】实际操作中极易踩坑，务必校验。

通过响应体样例反向约束

此策略对RESTful接口尤其有效，核心逻辑是“用样例说话”。

第一步：提供符合目标层级的响应体片段作为示例。
第二步：在提示词中强调“严格按以下样例结构生成，不得增加或减少嵌套层级”。
第三步：确保样例中关键嵌套字段用{}或null代替实际值。例如：
{"id": 123, "name": "test", "profile": {}, "tags": []}
Codeium会将{}和[]识别为结构终点，不再向下推导。只要样例中profile是空对象，它绝不会生成profile: {"avatar": "...", "bio": "..."}这类二级展开。

从市场实践来看，该方法对控制嵌套深度的成功率极高，尤其处理多层级JSON时，能有效防止Codeium过度展开字段。

来源：互联网