Künstliche Intelligenz

KI ist optional. Ohne konfigurierten Anbieter geht nichts irgendwohin. basedb kann mit OpenAI, Anthropic und Mistral sprechen, mit Ihrem eigenen Schlüssel – und mit jedem Server, der die API von OpenAI spricht: Azure, ein Unternehmens-Gateway, ein bei Ihnen betriebenes Modell.

Einen Anbieter konfigurieren

Solange in der Oberfläche keine Einstellung gespeichert ist, liest die API ihre Umgebung:

BASEDB_AI_PROVIDER=mistral      # openai, anthropic, mistral oder openai_compatible
BASEDB_AI_MODEL=mistral-small-latest
MISTRAL_API_KEY=…               # oder BASEDB_AI_API_KEY

Der Schlüssel wird aus BASEDB_AI_API_KEY gelesen oder, falls nicht vorhanden, unter dem üblichen Namen des Anbieters (OPENAI_API_KEY, ANTHROPIC_API_KEY, MISTRAL_API_KEY).

Azure, ein Gateway, ein lokales Modell

BASEDB_AI_PROVIDER=openai_compatible sendet die Aufrufe im Format von OpenAI an die Adresse aus BASEDB_AI_BASE_URL: alles, was vor /chat/completions steht, Parameter eingeschlossen. BASEDB_AI_HEADERS fügt jedem Aufruf die Header hinzu, die dieser Server verlangt, als JSON-Objekt.

# Azure OpenAI: der Name des Deployments als Modell, der Schlüssel im Header api-key
BASEDB_AI_PROVIDER=openai_compatible
BASEDB_AI_MODEL=mon-deploiement
BASEDB_AI_BASE_URL=https://ma-ressource.openai.azure.com/openai/v1
BASEDB_AI_HEADERS='{"api-key":"…"}'

# Die ältere Form von Azure, pro Deployment: der Parameter bleibt hinter dem Pfad
BASEDB_AI_BASE_URL=https://ma-ressource.openai.azure.com/openai/deployments/mon-deploiement?api-version=2024-10-21

# Ein von Ollama bereitgestelltes Modell, ohne Schlüssel
BASEDB_AI_PROVIDER=openai_compatible
BASEDB_AI_MODEL=llama3.1
BASEDB_AI_BASE_URL=http://ollama:11434/v1

Mit openai_compatible ist der Schlüssel optional: Wird BASEDB_AI_API_KEY angegeben, geht er als Authorization: Bearer hinaus. Ein Header aus BASEDB_AI_HEADERS ersetzt den des Schlüssels – etwa bei einem Gateway, das seinen eigenen Authorization-Header verlangt.

BASEDB_AI_BASE_URL und BASEDB_AI_HEADERS gelten auch für die drei anderen Anbieter, wenn sie über ein Gateway erreicht werden: Bei anthropic ist die Adresse alles, was vor /messages steht. Diese beiden Variablen gehören zum Anbieter der Umgebung, und nur zu ihm: Ein Arbeitsbereich, der einen anderen gewählt hat, erhält weder die Adresse noch die Header noch den Schlüssel. Beim Start der API wird der verwendete Anbieter ins Log geschrieben; eine ungültige Adresse oder ein ungültiges JSON-Objekt wird gemeldet.

Ein internes Gateway mit selbstsigniertem TLS-Zertifikat oder ein Unternehmens-Proxy, der den Datenverkehr neu signiert, lässt die Aufrufe scheitern: BASEDB_AI_PROVIDER_SSL_VERIFY=false hört auf, das Zertifikat nur dieses Anbieters zu prüfen – alle anderen ausgehenden Aufrufe der Instanz und der Anbieter, den ein Arbeitsbereich gewählt haben könnte, werden weiterhin geprüft. Der Start meldet es. Da der Schlüssel bei jedem Aufruf mitgeht, setzen Sie die Einstellung nur in einem Netzwerk ein, das Sie selbst kontrollieren.

Die KI-Option eines Felds

KI ist kein Feldtyp, sondern eine Option: Der Schalter KI im Formular eines Felds – Text, Langtext, URL, Zahl, Einfachauswahl, Boolean, Datum – lässt es von einem Modell ausfüllen, ausgehend von einer Anweisung, die andere Spalten zitiert:

Résume {{Notes}} en une phrase.
Catégorie de {{Description}} parmi les choix de la liste.

• Das Feld wird berechnet, sobald die Zeile existiert, und dann jedes Mal, wenn sich eine zitierte Spalte ändert – und, wenn gewünscht, nach einem Zeitplan (höchstens alle 15 Minuten).
• Die Spalte behält ihren Typ: Eine Antwort, in der sich nichts in diesem Typ lesen lässt (keine auffindbare Zahl, eine nicht existierende Option), wird abgelehnt statt geschrieben.
• Wird die Option deaktiviert, lässt sich das Feld wieder von Hand bearbeiten; die Werte bleiben erhalten.
• Die zitierten Werte gehen an den Anbieter: Die Aktivierung erfordert eine ausdrückliche Zustimmung.

BASEDB_AI_FIELD_QUOTA begrenzt diese Berechnungen pro Stunde und pro Arbeitsbereich (standardmäßig 300).

In einer Automatisierung

Eine Automatisierung kann in einem ihrer Schritte die KI fragen: eine Anweisung, die die Zeile und die vorherigen Schritte zitiert, eine Antwort, die im gewählten Typ gelesen wird und die die folgenden Schritte schreiben, senden oder zitieren. Es gelten dieselben Regeln wie für ein Feld: Zustimmung beim Speichern, nur was die Anweisung zitiert, geht hinaus, jeder Aufruf wird protokolliert und gegen BASEDB_AI_FIELD_QUOTA gezählt.

Entwürfe und Copilot

• Entwürfe: eine Tabelle oder eine Formel in einem Satz beschreiben und einen Vorschlag zum Prüfen erhalten. Es gehen nur Bezeichnungen, Typen und der eingegebene Satz hinaus – kein Zellenwert.
• Vorlagen: eine ganze Datenbank beschreiben – „die Nachverfolgung der Reklamationen meiner Kunden“ – und Tabellen, Beispielzeilen, Ansichten, Dashboard und Automatisierungen erhalten, zum Verfeinern und anschließenden Anlegen. Nur der Satz geht hinaus. Siehe Datenbankvorlagen.
• Copilot: eine Unterhaltung über die angezeigte Datenbank. Sie bitten um einen Filter, eine Abfrage, Spalten, eine Tabelle, einen Testdatensatz; jeder Vorschlag kommt als Karte und wird mit einem Klick angewendet, über dieselben Routen wie die Formulare.

Standardmäßig geht nur die Struktur an den Anbieter. Das Kästchen „Lesen der Daten erlauben“ gestattet dem Copilot für diese Unterhaltung, Zeilen zu lesen (höchstens 50 pro Lesevorgang) und auf ihrer Grundlage zu antworten – jeder Lesevorgang wird unter seiner Antwort aufgelistet.

Der Copilot der Dashboards

Im Bereich Dashboards schlägt der Copilot Fragen, Änderungen am Dashboard und Werte für dessen Filter vor, die sich mit einem Klick anwenden lassen. Dieselben Regeln: Ohne Zustimmung geht nur die Struktur hinaus – Tabellen und Felder, Dashboards und Fragen der Datenbank, die Definition der Karten des angezeigten Dashboards (ihre Fragen, ihre Texte) –, nie die Ergebnisse oder die in den Filtern gewählten Werte. Das Kästchen „Lesen der Daten erlauben“ fügt diese Werte und die Ergebnisse der Karten unter den angezeigten Filtern hinzu, höchstens 50 Zeilen pro Lesevorgang, jeder unter der Antwort aufgelistet.

Der Copilot der Automatisierungen

Im Bereich Automatisierungen schlägt der Copilot eine vollständige Automatisierung vor – die auf dem Bildschirm, geändert, oder eine neue –, die er auf den Ablauf im Editor legt, ohne sie je zu speichern: Sie prüfen sie und speichern sie dann. Dieselben Regeln: Ohne Zustimmung geht nur die Struktur hinaus – Tabellen und Felder, Automatisierungen der Datenbank, die auf dem Bildschirm, ihre letzten Ausführungen ohne jeden Wert, Personen und Slack-Kanäle unter Platzhaltern –, und das Kästchen „Lesen der Daten erlauben“ fügt gelesene Zeilen hinzu, höchstens 50 pro Lesevorgang.

BASEDB_AI_QUOTA begrenzt die interaktiven Aufrufe pro Stunde und pro Arbeitsbereich (standardmäßig 120).