Voraussetzungen und Netzwerkkonfiguration

• VPN-Tunnel & IP-Whitelisting: Es wird ein Site-to-Site-VPN-Tunnel benötigt. Falls erforderlich, lassen Sie die IP-Adresse von amber durch Ihre Firewall durch.

  • Bitte teilen Sie Amber die IP-Adresse, den Port und den Hostnamen des Datenbankservers mit oder vereinbaren Sie einen kurzen Termin mit Ihrem Customer Success Manager. Der Hostname für die unten stehende Konfiguration wird dann von Amber für Sie eingerichtet.

• Offene Ports: Stellen Sie sicher, dass der spezifische Datenbankport (z. B. 5432 für PostgreSQL) für Amber zugänglich ist.

• Verschlüsselung: Aktivieren Sie SSL/TLS, um sicherzustellen, dass alle abgefragten Daten während der Übertragung verschlüsselt werden.

1. Erstellen eines dedizierten Dienstkontos

• Spezieller Benutzer: Erstellen Sie einen speziellen Datenbankbenutzer mit Lesezugriff (z. B. amber_service_user). Verwenden
  Sie keine Root- oder gemeinsam genutzten Anmeldedaten.

• Prinzip der geringsten Berechtigungen: Erteilen Sie „SELECT“ nur Berechtigungen für die spezifischen Datenbanken, auf die amber zugreifen muss.

• Datenschutz: Verbinden Sie keine Datenbanken, die hochsensible Informationen (z. B. Passwörter, personenbezogene Daten) enthalten, die im Chat-Kontext nicht sichtbar sein sollten.

2. Konfigurieren der Verbindung in amber

Neue Datenbankverbindung hinzufügen

Navigieren Sie zu „Unternehmenseinstellungen“ → „Konnektoren“ → „Datenbanken“ → „Datenbank hinzufügen“ und geben Sie die folgenden Details ein:

• Name des Datenbank-Konnektors: Der Name des Konnektors, der allen Benutzern in amber angezeigt wird

• Datenbankbeschreibung: Eine Beschreibung des Inhalts und des Zwecks dieser Datenbank
  . Dies trägt zur Verbesserung der Genauigkeit von amberAI bei

• Hostname / IP-Adresse

  • Wird von amber vergeben (siehe „Voraussetzungen“ oben)

• Datenbankname

• Datenbanktyp

• Schema-Name

• Port

• Benutzername und Passwort (für das dedizierte Dienstkonto aus Schritt 2)

Tabellen auswählen

Die Datenbankverbindung wird auf Erreichbarkeit geprüft; sind die Tests erfolgreich, kann sie gespeichert werden. Sobald die Verbindung gespeichert ist, wird die Übersicht zur Tabellenauswahl angezeigt.

Wählen Sie die Tabellen aus, auf die Amber über den Chat zugreifen soll, und fügen Sie für jede Tabelle erläuternde Beschreibungen hinzu, um die Qualität der generierten Antworten zu verbessern. Genaue Tabellenbeschreibungen sind besonders hilfreich bei Datenbanken mit kurzen oder abgekürzten Tabellennamen oder wenn viele Tabellen verwendet werden sollen.

Nachdem der Konnektor gespeichert wurde, können Sie die Tabellen und ihre Beschreibungen bei Bedarf weiterhin aktualisieren.

Wenn die Tabellenauswahl und die Beschreibungen gespeichert sind, wird die Datenbank-Konnektor-Karte mit allen relevanten Informationen und Optionen zum Konnektor angezeigt.

4. Aktualisieren der Verbindung und Verwalten des Zugriffs

Konfigurationsaktualisierungen

Sobald die neue Datenbankverbindung eingerichtet ist, können Sie alle bisherigen Datenbankkonfigurationsfelder weiterhin über die Schaltfläche „Konfigurieren“ auf der Konnektorkarte aktualisieren. Die Tests werden mit der neuen Konfiguration ausgeführt und die Datenbank wird aktualisiert.

Aktivierung der Verbindung

Die Verbindung kann über den Schalter „Verbindung aktiv“ deaktiviert werden, sodass die Benutzer diesen Konnektor nicht mehr in ihren Datenquelleneinstellungen und Chat-Optionen sehen. Ebenso kann die Verbindung vom Administrator wieder aktiviert werden, falls sie deaktiviert wurde. Bei aktivierten Datenbanken haben Benutzer die Möglichkeit, diese zu sehen und optional über die Chat-Schalter ein- und auszuschalten.

Benutzerzugriff

Standardmäßig haben alle Benutzer Zugriff auf eine externe Datenbankverbindung, es sei denn, diese wurde vom Administrator wie oben beschrieben deaktiviert. Zusätzlich kann der Administrator die Benutzerzugriffskontrolle über den Schalter „Zugriff auf ausgewählte Benutzer beschränken“ aktivieren. Ist diese Option aktiviert, muss ein Benutzer in der Liste der zugelassenen Benutzer und Gruppen aufgeführt sein, damit er auf die Datenbank zugreifen kann. Dies gilt auch für den aktuell angemeldeten Administratorbenutzer.

Tabellenaktualisierungen

Über die Schaltfläche „Bearbeiten“ in der Tabellenübersicht ist es möglich, neue Tabellen auszuwählen, bestehende Tabellen abzuwählen sowie die Tabellenbeschreibungen zu bearbeiten.

Spaltenaktualisierungen

Um die Antwortgenauigkeit von Amber weiter zu verbessern, ist es möglich, auch die Spaltenbeschreibungen zu aktualisieren und eine kurze Zusammenfassung der in einer Spalte enthaltenen Informationen hinzuzufügen. Dies ist insbesondere bei Datenbanken mit kurzen oder abgekürzten Spaltennamen hilfreich.

5. Datensicherheit und unterstützte Aktionen

• Schreibgeschützte Vorgänge: „amber“ ist für den SQL-Konnektor rein schreibgeschützt ausgelegt. Es übersetzt Benutzeranfragen in sichere SELECT-Abfragen, um die Datenbankzeilen abzurufen, die für die Beantwortung der Benutzeranfrage relevant sind.

• Keine Änderungen: Der Agent kann und wird keine Anweisungen wie `INSERT`, `UPDATE`, `DELETE` oder `DROP` ausführen.

• Interaktionen mit mehreren Datenbanken: Amber unterstützt die Integration mit mehreren SQL-Datenbanken, und der Agent entscheidet, welche der verbundenen Datenbanken oder anderer Datenquellen und Tools für die Beantwortung der eingegebenen Frage relevant sind.

Fehlerbehebung

Weitere Informationen zur Fehlerbehebung beim SQL-Datenbank-Konnektor finden Sie unter https://helpcenter.amber.de/en/help/articles/6494418-troubleshooting-the-sql-chat