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

精准控制Codeium接口调用示例的结构深度需要明确指令，通过特定符号和样例约束能有效避免嵌套层级失控。以下具体方法可确保输出符合预期格式。

用关键词锁定层级范围

在编写提示词时，建议直接在末尾添加明确的层级控制指令，例如要求"仅显示一级键名"或"用占位符表示嵌套对象"。相较于模糊的简化要求，这种具象描述能让Codeium更准确地理解需求。

实际操作非常简单，只需将相关指令附加在接口描述之后即可。

需特别注意：避免使用"简化"等含糊表述，否则可能导致Codeium错误地删减字段而非控制嵌套深度。

用符号标记显式分层边界

第一种方法是采用缩进符号强制约束：

GET /api/users
→ query: {page: number, size: number}
→ response: {data: [...], total: number, page_info: {...}}

当Codeium识别到{...}占位符时，通常会保持page_info等字段的未展开状态。

第二种方法是利用注释划定范围：

在代码块上方添加类似"// 层级限制：response仅保留顶层字段"的注释行。注意必须使用双斜杠并紧贴代码块，否则可能失效。

注释位置错开一行或用其他符号包裹会导致失效

通过响应体样例反向约束

第一步：准备符合目标层级的响应体片段示例。

第二步：在提示词中强调"严格遵循样例结构，不得增减嵌套层级"。

第三步：确保示例中关键字段使用{}或null占位，例如：

Codeium会将空对象和数组视为结构终点，不会继续展开。这种方法对RESTful接口特别有效，能避免生成不必要的嵌套字段。

通过以上三种方法的灵活运用，可以精确控制Codeium输出的接口示例结构，确保其符合开发文档的格式要求。