Eigenes Addon erstellen¶
Alles auf der Seite Addons ist ein Dienst, der der Plattform mitgeteilt hat, was er kann. Sie können ebenfalls einen schreiben — und ihn ohne unser Zutun mit Ihrer Instanz verbinden.
Wann es sich lohnt¶
Ein eigenes Addon ist sinnvoll, wenn eine einfache API-Integration nicht ausreicht:
- Ihr System, Ihre Regeln. Die Logik bleibt in Ihrem Code — eine ERP-Abfrage, ein Scoring-Modell, eine Preisberechnung — und die Person, die den Fluss entwirft, erhält dafür einen sauberen Knoten statt fünf Integrationsschritten.
- Wiederverwendbare Bausteine. Liefern Sie dasselbe Modul an jede Instanz aus, die Sie betreiben, und aktualisieren Sie es zentral.
- Ihr eigener Einstellungsbildschirm. Zugangsdaten, Zuordnungen oder Funktionsschalter, die die Kundin oder der Kunde selbst konfiguriert — in einer von Ihnen gestalteten Oberfläche, eingebettet in die Instanz-Administration.
- Daten, die Ihre Infrastruktur nicht verlassen dürfen. Das Addon läuft auf Ihren Servern, die Plattform ruft es lediglich auf.
Ein Addon ist ein gewöhnlicher HTTP-Dienst. Es beschreibt sich selbst in einem Manifest, und die Plattform ruft es auf, während der Bot mit der Kundin oder dem Kunden spricht.
Mit der Vorlage starten¶
Die Startvorlage ist öffentlich und MIT-lizenziert:
github.com/Daktela/daktela-ai-addon-template
Sie ist ein funktionsfähiges Addon mit Beispielmodulen, einer Beispielintegration, einer dynamischen Liste, einer optionalen Konfigurationsseite, Tests, Docker-Images und einem vollständigen Entwicklerhandbuch im Ordner docs/.
Sie lässt sich auf zwei Arten bauen:
basic |
full |
|
|---|---|---|
| Module, Integrationen, dynamische Listen | âś” | âś” |
| Eigene Konfigurationsseite (React) | — | ✔ |
| Benötigt Node.js zum Bauen | nein | ja |
Beginnen Sie mit basic, sofern die Kundin oder der Kunde nichts zu konfigurieren hat.
Klonen und starten — Python 3.13+ und uv genügen:
git clone https://github.com/Daktela/daktela-ai-addon-template.git
cd daktela-ai-addon-template
uv sync --all-extras
uv run uvicorn server.main:app --reload
Der Dienst läuft nun unter http://localhost:8000, und http://localhost:8000/manifest zeigt, was er anbietet.
Lieber gleich so starten, wie es ausgeliefert wird? docker compose -f docker/compose.yaml up --build addon baut und startet das vollständige Image auf Port 8000, addon-basic entsprechend das Image nur mit Modulen auf Port 8001. Der Zyklus aus Ändern und Neustarten ist langsamer als uvicorn --reload, aber es ist genau das Image, das Sie später ausrollen.
Warning
Während der Entwicklung kann ein Tunneldienst (ngrok, Cloudflare Tunnel, Tailscale Funnel und Ähnliche) Ihren lokalen Port unter einer öffentlichen URL bereitstellen, damit Ihre Instanz ihn erreicht. Das sind reine Entwicklungswerkzeuge. Ein produktives Addon muss auf einem Server mit stabiler öffentlicher URL laufen — Ihre Instanz ruft es bei jedem Gespräch auf, ein Notebook hinter einem Tunnel kommt dafür nicht infrage. Beide Docker-Images sind dafür vorbereitet; Einzelheiten in docs/13-deployment.md im Repository.
Das Addon in der Instanz registrieren¶
Ă–ffnen Sie Addons und klicken Sie auf Add Custom Addon.

Tragen Sie die Basis-URL des Addons ein und, falls es einen erwartet, einen Authentifizierungs-Header. Klicken Sie auf Test — die Plattform holt das Manifest und meldet, ob sie es lesen konnte, sodass Sie es vor dem Speichern wissen. Klicken Sie anschließend auf Save.

Info
Der Screenshot zeigt eine lokale Adresse, weil er bei der Entwicklung über einen Tunnel entstanden ist. Tragen Sie in der Produktion die echte öffentliche URL des Addons ein.
Das Addon hat jetzt eine Karte auf der Addons-Seite. Klicken Sie auf Activate. Ein Addon ohne Konfigurationsseite wird sofort aktiv; eines mit Konfigurationsseite möchte in der Regel zuerst konfiguriert werden.

Wann immer Sie das Manifest ändern — ein neues Modul, eine neue Eingabe, eine neue Version — klicken Sie auf Sync Addons, um die Änderung einzulesen.
Info
Die Administrationsoberfläche der Plattform ist in Englisch, Tschechisch und Slowakisch verfügbar. Die Bezeichnungen der Schaltflächen sind daher in Englisch angegeben.
PrĂĽfen, ob es funktioniert¶
Öffnen Sie Dialogs, bearbeiten Sie einen Fluss und suchen Sie Ihre Module in der Modulauswahl, gruppiert unter dem Namen aus Ihrem Manifest. Setzen Sie eines ein, verbinden Sie die Ausgangs-Ports und starten Sie über Test in der oberen Leiste ein Testgespräch.
Öffnen Sie dann die Interaktion unter Discussions und sehen Sie sich ihre Ereignisse an. Jede Modulausführung schreibt dort ein Ereignis mit der Quelle <Modul>::<Addon-Code>, der vom Modul zurückgegebenen Nachricht und der Dauer — daran unterscheiden Sie „das Addon wurde nie aufgerufen" von „das Addon wurde aufgerufen und hat das geantwortet".

Das Addon von einem LLM schreiben lassen¶
Die Vorlage ist darauf ausgelegt, zusammen mit Ihren Anforderungen an einen Coding-Assistenten (Claude Code, Cursor, Copilot und ähnliche) übergeben zu werden. Klonen Sie zuerst das Repository, öffnen Sie es im Assistenten und verwenden Sie Prompts in dieser Art.
1 — Das Grundgerüst für Ihre Domäne erzeugen
Ich habe die Daktela-AI-Addon-Vorlage geklont. Lies
README.mdunddocs/01-quickstart.md, um den Aufbau des Projekts zu verstehen, und passe es dann an unser Unternehmen an.Das Addon heißt <Name> und arbeitet mit <das zu integrierende System — z. B. unserem Lagersystem>. Setze die Identität des Addons in
server/identity.py(code, name, description, author, Icon, Farbe).Entferne die Beispielmodule, die ich nicht brauche, und halte das Projekt lauffähig und die Tests grün. Erkläre, was du geändert hast und wie ich den Dienst starte.
2 — Ein Modul hinzufügen, das Ihre API aufruft
FĂĽge nach dem Vorbild von
server/modules/catalog/exchange_rate.pyund der Anleitung indocs/07-calling-external-apis.mdein neues Modul <Modulname> hinzu.Es soll
GET https://api.example.com/orders/{order_id}mit einem Bearer-Token aufrufen, wobeiorder_idein Eingabeattribut ist, das im Fluss ausgefüllt wird.Gib ihm drei Ausgangs-Ports — Erfolg, nicht gefunden und Fehler — sowie ein Timeout-Attribut, das mit dem Timeout-Port verbunden ist. Schreibe den Bestellstatus in den Gesprächskontext, damit der nächste Knoten ihn verwenden kann, und schreibe ein Debug-Ereignis mit der Rohantwort. Ergänze Unit-Tests im Stil der vorhandenen.
3 — Eine Einstellungsseite für Zugangsdaten hinzufügen
Stelle dieses Addon auf das Profil
fullum und füge eine Konfigurationsseite hinzu, auf der eine Administratorin oder ein Administrator die API-Basis-URL und das API-Token einträgt — nachdocs/10-configuration-page.mdunddocs/11-persistence.md.Speichere die Werte über den vorhandenen Settings-Store, lies sie in meinen Modulen statt fest kodierter Konstanten, und sorge dafür, dass sich das Addon als nicht konfiguriert meldet, solange nicht beide Werte gefüllt sind.
4 — Produktionsreif machen
PrĂĽfe dieses Addon gegen
docs/13-deployment.md. Baue beide Docker-Images, kontrolliere, dass keine Secrets in den Build gelangt sind, und sage mir, was ich noch erledigen muss, bevor ich das unter einer öffentlichen URL für eine Kundin oder einen Kunden betreiben kann.
Tip
Verweisen Sie den Assistenten auf das Handbuch in der Vorlage, statt ihm die Plattform zu beschreiben. Der Ordner docs/ im Repository behandelt Module, Ausgangs-Ports, Integrationen, dynamische Listen, gestreamte Antworten, Persistenz, Tests und Deployment — und genau das hält den erzeugten Code auf Kurs.
Weiterlesen¶
- Das Entwicklerhandbuch in der Vorlage:
docs/im Repository - Addons-Ăśbersicht
- API-Integrationen — die einfachere Option, wenn Sie nur einen Endpunkt aufrufen müssen