创建你自己的扩展#
随着0.4版本中新的包结构,创建并发布你自己的AutoGen生态系统扩展比以往任何时候都更加容易。本页面详细介绍了一些最佳实践,以确保你的扩展包能够良好地融入AutoGen生态系统。
最佳实践#
命名#
命名没有要求。但在包名前加上autogen-
可以更容易找到它。
通用接口#
尽可能的情况下,扩展应该实现来自autogen_core
包提供的接口。这将为用户提供更一致的体验。
依赖AutoGen#
为了确保扩展程序与其设计的AutoGen版本兼容,建议在pyproject.toml
的依赖项部分指定AutoGen版本,并设置适当的约束条件。
[project]
# ...
dependencies = [
"autogen-core>=0.4,<0.5"
]
使用 typing#
AutoGen 提倡使用类型提示以提供更好的开发体验。扩展应尽可能使用类型提示。
探索#
为了让用户更容易找到你的扩展、示例、服务或包,你可以在GitHub仓库中添加主题 autogen
。
更多具体主题也可用:
autogen-extension
用于扩展autogen-sample
用于示例
0.2版本的变化#
在AutoGen 0.2版本中,通常会将第三方扩展和示例合并到主库中。我们非常感谢所有为生态系统笔记本、模块和页面做出贡献的0.2版本用户。然而,总的来说,我们正在远离这种模式,以便提供更多的灵活性并减少维护负担。
我们有第一个官方支持的扩展包autogen-ext
,但我们希望有选择性地管理维护负担。如果您想了解您的扩展是否适合添加到autogen-ext
,请提出一个问题并让我们讨论。否则,我们鼓励您将您的扩展发布为独立的包,并遵循discovery下的指南,以方便用户找到。