💡 为什么你需要 Apifox AI 来优化数据模型？

在 API 开发和文档编写过程中，数据模型优化往往是一项重复且耗时的工作。为每个字段添加清晰的中文名、描述，以及准确的 Mock 规则生成，是保障文档质量的关键，但手动操作效率低下。

Apifox 推出强大的 AI 修改数据模型功能，彻底改变了这一现状。它允许开发者通过简单的对话或快捷操作，让 AI 助手自动补全和优化模型信息。无论你是资深开发者还是项目经理，掌握这项功能都能让你在接口文档管理上实现质的飞跃。

本文将为您提供一份完整的操作指南，从Apifox AI 功能启用到实际应用，手把手教您如何用 AI 高效完善数据模型。

Apifox AI 功能启用：开始高效工作的第一步

在使用 AI 助手对数据模型进行优化之前，您必须确保 Apifox 中的 AI 功能已正确开启。这是使用一切 AI 服务的必要前提。

启用 AI 功能的必备条件

要顺利开启并使用 Apifox AI 服务，请遵循以下两个关键步骤：

1. 检查版本要求：
   • 请确保您的 Apifox 客户端版本必须 $\ge \mathrm{2.7.37}$。如果版本过低，请及时更新。
2. 配置 AI 模型（获取 API Key）：
   • AI 功能免费提供，但不内置 AI 模型。 您需要自行添加 AI 模型，并配置对应的 API Key。
   • 这个步骤确保了 AI 助手能够调用您配置的外部 AI 服务来处理数据和生成内容。
   • 提示：请参考 Apifox 官方文档的“配置 AI 供应商”部分，获取详细的配置教程。

关键提醒： 正确的 Apifox AI 功能启用是实现后续所有数据模型优化操作的基础。

AI 修改数据模型工作流：从识别到应用的完整步骤

一旦 AI 功能启用，您就可以随时随地在数据模型相关区域调用 AI 助手。AI 辅助修改工作流非常直观且高效。

如何找到 AI 功能入口？

AI 功能的入口被巧妙地集成在数据模型界面中，方便用户随时调用：

• 位置： 在接口文档或数据模型页面中。
• 操作： 将鼠标悬停在数据模型相关的区域（如字段行或整个模型结构）上。
• 标识： 您将看到一个明显的 AI 功能按钮，点击即可启动 AI 助手弹窗。

使用 AI 助手进行聊天式修改和快捷生成

点击 AI 按钮后，会打开一个带有左右两侧内容的弹窗：

1. 左侧： 展示当前选中的数据模型内容。
2. 右侧： 为 AI 助手的聊天界面。

两种高效操作模式：

• 聊天式修改： 您可以像与人交流一样，以自然语言向 AI 提出修改需求，例如：“请为所有字段添加中文描述”或“将所有的 price 字段的 Mock 规则设置为 100 到 500 之间的随机数”。AI 将根据您的指令进行数据模型优化。
• 快捷生成： 弹窗内也提供了一些常用修改需求的快捷按钮（如“一键添加中文名”、“生成 Mock 规则”）。点击即可立即让 AI 生成相应内容，极大地提高了效率。
  • 这对于快速实现Mock 规则生成和基础信息完善尤其有效。

应用与确认：将 AI 成果写入数据模型的关键

AI 生成的内容并不意味着立即生效，您必须经过“确认”这一关键步骤，才能确保改动被正式写入项目。

如何调整和应用 AI 生成的内容？

在 AI 助手弹窗中，您拥有完全的控制权：

1. 内容调整： 如果您对 AI 生成的中文名、描述或 Mock 规则不完全满意，可以直接在弹窗界面中进行修改和调整。
2. 确认应用： 确认所有内容都符合您的要求后，请点击右下角的 “应用”按钮。
   • 效果： 只有点击“应用”后，AI 所做的全部改动才会正式写入您的数据模型中。
   • 提示：这相当于一个“保存”操作，确保了数据修改的安全性。

通过以上步骤，您不仅完成了对数据模型的完善，还通过 AI 实现了高效、准确的数据模型优化，为后续的接口联调和开发奠定了坚实的基础。

结语：拥抱 AI 效率新时代

Apifox AI 修改数据模型功能是 API 开发者提高工作效率、实现数据模型优化的强大工具。它将原本繁琐的手动录入工作，转变为高效、智能的 AI 辅助操作，无论是添加中文名、描述，还是进行复杂的 Mock 规则生成，都能轻松应对。

现在，您已经掌握了从Apifox AI 功能启用到最终应用的全部步骤。不要让重复劳动拖慢您的开发进度！

立即检查您的 Apifox 版本（$\ge \mathrm{2.7.37}$），配置好 AI API Key，开始体验 Apifox AI 带来的效率革命吧！点击下面的链接，访问官方文档了解更多 AI 供应商配置细节，让您的 API 开发文档更加完善、专业！