KI-Modelle der App
Den Modellen, die die Skripte der App nutzen, Namen geben, für jede Verwendung den Standard wählen und Modelle wechseln, ohne den Code anzufassen.
Skripte nennen weder Anbieter noch Modelle. Sie nutzen einen Alias: einen
kurzen Namen wie texto oder vectores, den die Einstellungen der App mit
einem zugelassenen Modell eines Anbieters verbinden. Ändert man das Modell
eines Alias, ändern sich alle Skripte, die ihn nutzen, ohne den Code
anzufassen.
Die KI-Schritte der Workflows und der APIs verwenden dieselben Aliase.
In der Beispiel-App Gestão de Clientes verweist der Alias texto auf ein
Textmodell des Anbieters local, und der Alias vectores auf ein
Embedding-Modell desselben Anbieters.
Hinweis
Aliase gehören zum Design der App: Sie ändern sich in der Arbeitsversion, bleiben im Verlauf und gehen ins Paket, wenn die App exportiert wird. Anbieter und Zugangsdaten gehören zum Mandanten und gehen nicht mit.
Wo sie sich befinden
Öffnen Sie die Einstellungen der App und wählen Sie KI-Modelle in der Gruppe Künstliche Intelligenz. Konten mit Developer-Profil sehen die Aliase; nur Konten mit dem Administratorprofil der App ändern sie.

Einen Alias anlegen
- Klicken Sie auf Neuer Alias.
- Geben Sie den Namen ein: Kleinbuchstaben, Ziffern, Bindestriche und
Unterstriche, beginnend mit einem Buchstaben. Diesen Namen schreiben die
Skripte in
model=. - Wählen Sie die Verwendung: Text, Embeddings, Bilder, Transkription oder Sprache.
- Wählen Sie den Anbieter. Es erscheinen nur aktive Anbieter mit zugelassenen Modellen für diese Verwendung.
- Wählen Sie das Modell unter denen, die der Anbieter für diese Verwendung zulässt.
- Bei einem Text-Alias können Sie die Maximale Länge der Antwort (Tokens) angeben. Leer gilt der Wert der Plattform.
- Schalten Sie Standard für diese Verwendung ein, wenn dieser Alias gelten soll, sobald ein Skript kein Modell angibt. Pro Verwendung gibt es nur einen Standard: Wer einen einschaltet, nimmt dem vorherigen die Markierung.
- Klicken Sie in der Kopfzeile auf Speichern.
Das Modell eines Alias wechseln
- Klicken Sie im Menü ⋮ des Alias auf Bearbeiten.
- Wählen Sie einen anderen Anbieter oder ein anderes Modell.
- Klicken Sie auf Speichern.
Da Aliase in der Version der App liegen, geschieht die Änderung in der Arbeitsversion. Wer die App benutzt, bekommt das neue Modell, sobald diese Version veröffentlicht wird.
Einen Alias löschen
Klicken Sie im Menü ⋮ des Alias auf Entfernen und bestätigen Sie über der Liste. Die Skripte, die diesen Alias nutzen, schlagen fehl, bis Sie einen anderen wählen.
Aus einem anderen Mandanten importierte Apps
Eine exportierte App nimmt die Aliase mit dem Namen des jeweiligen Anbieters mit. Gibt es in diesem Mandanten keinen Anbieter mit diesem Namen, zeigt der Alias Anbieter fehlt. Bearbeiten Sie ihn und wählen Sie einen Anbieter dieses Mandanten.
Gibt es den Anbieter, ist das Modell des Alias dort aber nicht freigegeben, zeigt der Alias Modell nicht freigegeben. Wählen Sie ein anderes Modell, oder bitten Sie den Administrator, es beim Anbieter freizugeben.
Fehlersuche
Wenn ein Modell schlecht antwortet, hilft es zu sehen, was genau an das Modell ging. Schalten Sie unter der Liste der Aliase im Abschnitt Fehlersuche die Option Anfragen und Antworten in den Logs speichern ein. Ab dann schreibt jeder Aufruf eines Skripts die Anfrage (die Anweisung, die Nachrichten und die Dateinamen) und die Antwort in die Logs der Ausführung, jeweils bis zu 4000 Zeichen.
Achtung
Der Text der Anfragen enthält oft personenbezogene Daten und bleibt in den Logs der Ausführungen, mit deren Aufbewahrungsdauer. Schalten Sie die Fehlersuche nur ein, solange Sie sie brauchen.
Wie die Aliase gehört die Fehlersuche zum Entwurf der App: Sie ändert sich in der Arbeitsversion und gilt in der veröffentlichten Version erst, nachdem Sie diese veröffentlicht haben.
Häufige Fragen
Die Schaltfläche Neuer Alias erscheint nicht. Dieser Mandant hat noch keine KI-Anbieter. Ein Administrator fügt sie unter Einstellungen > Künstliche Intelligenz > Anbieter hinzu (siehe KI-Anbieter).
Das gewünschte Modell erscheint nicht. Es erscheinen nur die Modelle, die der Administrator bei diesem Anbieter für die gewählte Verwendung zugelassen hat.
Stört ein Alias mit demselben Namen in einer anderen App diesen hier? Nein. Jede App hat ihre eigenen Aliase.