SQL-Datenquelle als Werkzeug einrichten

Eine SQL-Datenquelle macht Geschäftsdaten als KI-aufrufbares Werkzeug verfügbar: Der Assistent führt eine feste, parametrisierte Abfrage aus und erhält das Ergebnis als Tabelle. Eingerichtet wird das im Tab Administration → Konfigurierte Tools in zwei Schritten — erst die Verbindung, dann das Werkzeug. Zur Einordnung siehe Konfigurierbare Werkzeuge — Überblick.

Lizenz (Pro/Site): Damit der Assistent ein SQL-Werkzeug tatsächlich aufruft, ist eine Pro- oder **Site-**Lizenz nötig (nicht in Free). Einrichtung und Testlauf sind in allen Editionen möglich. → Lizenz- & Editionsmodell

Schritt 1 — Datenquelle (Verbindung) anlegen

1. Im Tab Konfigurierte Tools eine neue Datenquelle anlegen.
2. Name und Datenbanktyp wählen — unterstützt sind SQL Server, PostgreSQL, MySQL/MariaDB und SQLite.
3. Die Verbindungszeichenfolge eintragen. Sie wird AES-verschlüsselt gespeichert und beim Bearbeiten maskiert. → Umgebungsvariablen & Secrets
4. Mit Verbindung testen den Zugang prüfen, dann Aktiv setzen und speichern.

Schritt 2 — SQL-Werkzeug definieren

Ein Werkzeug verknüpft eine Datenquelle mit genau einer Abfrage:

Feld	Bedeutung
Slug / Anzeigename	Technische Kennung + sprechender Name.
Beschreibung	Erklärt dem Assistenten, wann das Werkzeug zu nutzen ist.
Verbindung	Die zugrunde liegende Datenquelle aus Schritt 1.
SQL-Abfrage	Nur lesend (SELECT/WITH), parametrisiert mit @name.
Parameter	Name, Typ (string/integer/number/boolean), Beschreibung, Default, Pflicht.
Max. Zeilen / Timeout	Begrenzen Ergebnisgröße und Laufzeit.
Im Chat / Für Agenten	Wo das Werkzeug nutzbar ist.
PII-Ausnahme	Ergebnisse bewusst vom PII-Schild ausnehmen. → Der PII-Schild
Vertrauenswürdiges Ziel	Die Abfrage-Argumente werden re-identifiziert, die Datenbank sucht also mit echten Werten. Nicht verwechseln mit der PII-Ausnahme: die betrifft die Ergebnisse (herein), diese Option die Argumente (hinaus). → Vertrauenswürdige Ziele (PII-Abfluss)

Mit Testlauf prüfen Sie das Werkzeug vor der Freigabe. Werkzeuge lassen sich erst anlegen, wenn mindestens eine Datenquelle existiert.

Sicherheitszusagen

• Nur Lesen — dreifach erzwungen. Es sind ausschließlich SELECT/WITH-Abfragen erlaubt; jede Ausführung läuft zusätzlich in einer Rollback-Transaktion, sodass auch eine durchgerutschte Schreiboperation nichts ändern kann.
• Nur Parameter-Binding. Werte gelangen ausschließlich über gebundene Parameter in die Abfrage — kein String-Zusammenbau, kein Injection-Vektor.
• Verschlüsselte Verbindung. Die Verbindungszeichenfolge wird AES-verschlüsselt gespeichert.
• Admin-only. Anlegen und Ändern ist Administratoren vorbehalten.

Hinweis: Dies ersetzt den früheren Artikel „Konfigurierte Tools (SQL)” — der bestehende Link führt weiterhin hierher.