43 · API 演进（API Evolution）

我们力求避免破坏性变更。

由于 Embabel 构建在 Spring 的 POJO 支持之上，框架代码的依赖被局部化并最小化。

最核心的接口面是 Ai 与 PromptRunner 两个接口，我们将尽力避免破坏它们。

为了获得最大稳定性：

• 尽可能使用 embabel-agent 的最新稳定版，而不要用 snapshot —— snapshot 可能频繁变动；
• 避免使用 com.embabel.agent.experimental 包下的类型；
• 留意你所使用的 Embabel 模块所处的状态；
• 避免使用任何被标注 @ApiStatus.Experimental 或 @ApiStatus.Internal 的方法或类；
• 应用代码不应依赖 com.embabel.agent.spi 包下的任何类型 —— 该包仅用于提供运行时基础设施，可能在不通知的情况下变更。