Erstellen Ihrer eigenen Erweiterung#

Mit der neuen Paketstruktur in Version 0.4 ist es einfacher als je zuvor, Ihre eigene Erweiterung für das AutoGen-Ökosystem zu erstellen und zu veröffentlichen. Diese Seite beschreibt einige Best Practices, damit sich Ihr Erweiterungspaket gut in das AutoGen-Ökosystem integriert.

Best Practices#

Benennung#

Es gibt keine zwingende Vorgabe zur Benennung. Das Präfixen des Paketnamens mit autogen- erleichtert jedoch das Finden.

Gemeinsame Schnittstellen#

Wo immer möglich, sollten Erweiterungen die bereitgestellten Schnittstellen aus dem Paket autogen_core implementieren. Dies ermöglicht eine konsistentere Benutzererfahrung.

Abhängigkeit von AutoGen#

Um sicherzustellen, dass die Erweiterung mit der Version von AutoGen funktioniert, für die sie entwickelt wurde, wird empfohlen, die Version von AutoGen im Abschnitt "dependency" der Datei pyproject.toml mit angemessenen Einschränkungen anzugeben.

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

Verwendung von Typen#

AutoGen setzt auf die Verwendung von Typ-Hints, um eine bessere Entwicklungserfahrung zu bieten. Erweiterungen sollten nach Möglichkeit Typ-Hints verwenden.

Entdeckung#

Um es Benutzern zu erleichtern, Ihre Erweiterung, Ihr Beispiel, Ihren Dienst oder Ihr Paket zu finden, können Sie das Thema Thema hinzufügen autogen zu Ihrem GitHub-Repository.

Spezifischere Themen sind ebenfalls verfügbar

Änderungen seit Version 0.2#

In AutoGen 0.2 war es üblich, 3rd-Party-Erweiterungen und Beispiele in das Haupt-Repository zu integrieren. Wir sind sehr dankbar für alle Benutzer, die in Version 0.2 zu den Ökosystem-Notebooks, Modulen und Seiten beigetragen haben. Im Allgemeinen bewegen wir uns jedoch von diesem Modell weg, um mehr Flexibilität zu ermöglichen und den Wartungsaufwand zu reduzieren.

Es gibt das Paket autogen-ext für offiziell unterstützte Erweiterungen, aber wir möchten selektiv sein, um den Wartungsaufwand zu bewältigen. Wenn Sie sehen möchten, ob Ihre Erweiterung sinnvoll ist, um sie zu autogen-ext hinzuzufügen, öffnen Sie bitte ein Issue und lassen Sie uns darüber sprechen. Andernfalls ermutigen wir Sie, Ihre Erweiterung als separates Paket zu veröffentlichen und die Anweisungen unter Entdeckung zu befolgen, um es Benutzern leicht zu machen, sie zu finden.