创建您自己的扩展

在 0.4 版本的新包结构中，创建并将您自己的扩展发布到 AutoGen 生态系统比以往任何时候都更容易。此页面详细介绍了一些最佳实践，以便您的扩展包能够与 AutoGen 生态系统良好集成。

最佳实践

命名

没有关于命名的要求。 但是以 autogen- 为包名添加前缀可以更容易找到它。

通用接口

尽可能地，扩展应该实现 autogen_core 包中提供的接口。这将允许用户获得更一致的体验。

依赖于 AutoGen

为了确保扩展能够与为其设计的 AutoGen 版本一起工作，建议在 pyproject.toml 的依赖项部分中使用适当的约束来指定 AutoGen 的版本。

[project]
# ...
dependencies = [
    "autogen-core>=0.4,<0.5"
]

类型的使用

AutoGen 拥抱类型提示的使用，以提供更好的开发体验。 扩展应尽可能使用类型提示。

发现

为了让用户更容易找到您的扩展、示例、服务或包，您可以添加主题 autogen 到 GitHub 存储库。

还有更具体的主题可用

• autogen-extension 用于扩展

• autogen-sample 用于示例

从 0.2 版本的更改

在 AutoGen 0.2 中，将第三方扩展和示例合并到主存储库中是很常见的。 我们非常感谢所有为 0.2 版本的生态系统笔记本、模块和页面做出贡献的用户。 但是，总的来说，我们正在放弃这种模式，以允许更大的灵活性并减少维护负担。

有用于第一方支持的扩展的 autogen-ext 包，但是我们希望有选择性地管理维护负载。 如果您想看看将您的扩展添加到 autogen-ext 是否有意义，请打开一个 issue 并进行讨论。 否则，我们鼓励您将您的扩展作为单独的包发布，并遵循发现下的指导，以便用户轻松找到。