创建您自己的扩展

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

最佳实践

命名

对命名没有要求。但以 autogen- 作为包名称前缀可以使其更容易被找到。

通用接口

在可能的情况下，扩展应该实现 autogen_core 包中提供的接口。这将为用户提供更一致的体验。

对 AutoGen 的依赖

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

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

类型的使用

AutoGen 采用类型提示来提供更好的开发体验。扩展应尽可能使用类型提示。

发现

为了方便用户找到您的扩展、示例、服务或包，您可以在 GitHub 仓库中添加 autogen 主题。

还有更具体的主题可用

• autogen-extension 用于扩展

• autogen-sample 用于示例

与 0.2 版本的变化

在 AutoGen 0.2 版本中，将第三方扩展和示例合并到主仓库是很常见的。我们非常感谢所有在 0.2 版本中为生态系统贡献了笔记本、模块和页面的用户。然而，我们普遍正在放弃这种模式，以提供更大的灵活性并减少维护负担。

有一个 autogen-ext 包用于第一方支持的扩展，但我们希望有选择地管理维护工作量。如果您想了解您的扩展是否适合添加到 autogen-ext，请提出问题，让我们讨论。否则，我们鼓励您将您的扩展发布为单独的包，并遵循 发现 下的指导，以便用户易于找到。