前提条件#
API 文档:为端点请求/响应 schema 中的字段命名
Schemas:为可复用 schema 定义中的字段 命名
Components:为组件 schema 中的字段命名
AI 可以根据你在当前 API 文档中对特定字段的描述,按照 API 设计规范 生成标准化、专业且易于阅读的字段名称。使用 AI 驱动的字段命名#
步骤 1:找到 AI 命名图标#
你会在 API 文档、schemas 或 components 中的每个字段旁边看到 AI 命名图标。点击该图标即可开始 AI 命名流程。步骤 2:提供字段描述#
点击 AI 命名图标后,会出现一个提示框。输入该字段的简短描述,引导 AI 生成合适的字段名称。你也可以选择不同的 AI 模型。如果你已经填写了字段描述,它将被自动使用。步骤 3:查看 AI 生成的名称#
点击 Send,AI 将根据 API 设计规范、当前文档上下文和字段描述生成多个字段名称。它还会为每个名称提供解释和评分。步骤 4:应用你偏好的名称#
你可以选择一个 AI 生成的字段名称,然后点击 Adopt,将其直接应用到文档中。Modified at 2026-06-09 08:55:47