Zum Inhalt

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.

Die Addons-Seite mit hervorgehobener Schaltfläche zum Hinzufügen eines eigenen Addons

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.

Das Formular zum HinzufĂĽgen eines eigenen Addons mit erfolgreich geladenem Manifest

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.

Die Addon-Karte mit hervorgehobener Schaltfläche Activate

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 Ereignisfenster einer Interaktion mit einem von einem Addon-Modul geschriebenen Ereignis


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.md und docs/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.py und der Anleitung in docs/07-calling-external-apis.md ein neues Modul <Modulname> hinzu.

Es soll GET https://api.example.com/orders/{order_id} mit einem Bearer-Token aufrufen, wobei order_id ein 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 full um und füge eine Konfigurationsseite hinzu, auf der eine Administratorin oder ein Administrator die API-Basis-URL und das API-Token einträgt — nach docs/10-configuration-page.md und docs/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