Erweiterungen verwalten

Was ist eine Erweiterung?#

Eine Erweiterung ist eine fertige Fachanwendung, zum Beispiel für Sitzungsprotokolle oder ein Dokumentenarchiv. Sie läuft vollständig auf deinem Server und nutzt automatisch alles, was die Plattform bietet:

• den Firmen-Login, damit sich niemand ein neues Passwort merken muss,
• die lokalen Sprachmodelle über die KI-Zentrale,
• eine eigene Adresse, zum Beispiel protocol.ki.firma.ch, mit verschlüsselter Verbindung,
• den Chat, in dem sie als Werkzeug zur Verfügung steht,
• das Backup, in dem ihre Daten automatisch enthalten sind,
• dein Branding mit Firmenname und Logo.

Alle verfügbaren Erweiterungen und ihre Preise findest du im Katalog. Fehlt dir etwas, kannst du auch eine eigene Erweiterung bauen.

Verfügbare Erweiterungen anzeigen#

aictl extension catalog

Der Befehl zeigt alle Erweiterungen, die deine Lizenz freischaltet, und ob sie bereits installiert sind.

Eine Erweiterung installieren#

sudo aictl extension install protocol

Die Installation führt dich Schritt für Schritt durch:

1. Lizenz und Freischaltung werden geprüft.
2. Die Erweiterung wird heruntergeladen und auf Echtheit geprüft.
3. Du siehst, was eingerichtet wird, und bestätigst.
4. Falls nötig, wirst du nach Zugangsdaten gefragt, zum Beispiel einem Zugangsschlüssel.
5. Du wählst die empfohlenen Sprachmodelle und auf welchem Rechner sie laufen sollen.
6. Die Erweiterung wird eingerichtet und gestartet.

Am Ende siehst du die Adresse, unter der die Erweiterung erreichbar ist.

Installierte Erweiterungen anzeigen#

aictl extension ls

Du siehst die installierte und die neueste verfügbare Version jeder Erweiterung.

Erweiterungen aktualisieren#

Alle Erweiterungen auf den neuesten Stand bringen:

sudo aictl extension update

Oder nur eine bestimmte:

sudo aictl extension update archive

Gibt es mit einer neuen Version Probleme, kannst du jederzeit auf eine frühere zurückwechseln:

sudo aictl extension install archive --version <version>

Zugangsdaten verwalten#

Manche Erweiterungen brauchen Zugangsdaten, zum Beispiel einen Schlüssel für einen externen Dienst. Diese werden bei der Installation abgefragt. Ändern kannst du sie so:

sudo aictl secret set <NAME>
sudo aictl apply

Die Eingabe ist verdeckt, und der Wert wird geschützt auf dem Server gespeichert. aictl secret ls zeigt nur die Namen, niemals die Werte.

Eine Erweiterung entfernen#

sudo aictl extension remove protocol

Die Erweiterung wird angehalten und ist nicht mehr erreichbar. Deine Daten bleiben erhalten, sodass du sie später wieder installieren kannst.

Sollen auch alle Daten gelöscht werden:

sudo aictl extension remove protocol --purge

Achtung: --purge löscht alle Daten der Erweiterung endgültig, zum Beispiel alle Protokolle oder Dokumente. Erstelle vorher ein Backup.

Eine neue Erweiterung kaufen#

Schreib an [email protected]. Wir schalten die Erweiterung auf deiner bestehenden Lizenz frei, ein neuer Schlüssel ist nicht nötig. Danach holst du die Freischaltung mit sudo aictl license renew ab und installierst die Erweiterung wie oben beschrieben.

Eine eigene Erweiterung bauen#

Du bist nicht auf den Katalog beschränkt. Deine IT oder ein Dienstleister deiner Wahl kann eine eigene Erweiterung für deine Firma entwickeln, zum Beispiel für einen internen Ablauf oder die Anbindung einer Branchensoftware. Sie bekommt dieselben Bausteine wie jede andere Erweiterung: Firmen-Login, Sprachmodelle, eigene Adresse, Chat und Backup.

So läuft es ab:

1. Entwickeln: Eine Erweiterung besteht aus gewöhnlichen Containern und einer Beschreibungsdatei, dem Manifest. Wie das genau geht, steht in der Entwicklerdokumentation.
2. Einreichen: Schick uns das fertige Paket an [email protected]. Wir prüfen und signieren es, denn die Plattform installiert nur signierte Pakete.
3. Installieren: Wir schalten die Erweiterung ausschliesslich auf deiner Lizenz frei. Sie erscheint nicht im öffentlichen Katalog. Danach installierst du sie wie jede andere mit sudo aictl extension install <name>.

Möchtest du deine Erweiterung auch anderen Firmen anbieten, kannst du sie als Drittentwickler im öffentlichen Katalog veröffentlichen. Dann steht sie allen Kunden zur Verfügung.

Die Entwicklerdokumentation findest du nach dem Login im Kundenportal.

Wichtig: Für selbst gebaute Erweiterungen bist du verantwortlich, sie sind nicht Teil des regulären Supports. Lies vorher das Kapitel zu Risiken und Verantwortung in der Entwicklerdokumentation.