Auf dieser Seite wird beschrieben, wie Sie einen Datenspeicher erstellen und Zendesk mit Gemini Enterprise verbinden.
Hinweise
Bevor Sie Ihren Zendesk-Datenspeicher einrichten, müssen Sie Folgendes sicherstellen:
Weisen Sie die Rolle „Discovery Engine-Bearbeiter“ (roles/discoveryengine.editor) zu. Diese Rolle ist erforderlich, damit der Nutzer den Datenspeicher erstellen kann. So weisen Sie diese Rolle zu:
- Rufen Sie in der Google Cloud Console die Seite IAM auf.
- Lokalisieren Sie das Nutzerkonto und klicken Sie auf das Symbol Bearbeiten.
- Weisen Sie dem Nutzer die Rolle
Discovery Engine Editorzu: Weitere Informationen finden Sie unter IAM-Rollen und -Berechtigungen.
Erstellen Sie einen OAuth-Client und rufen Sie die folgenden Anmeldedaten ab:
Client-ID
Clientschlüssel
Konfigurieren Sie die erforderlichen Berechtigungen in Zendesk für die OAuth-Anwendung.
Prüfen Sie, ob in den Zendesk API-Einstellungen Token-Zugriff aktiviert ist.
Zendesk-Datenspeicher erstellen
So erstellen Sie den Zendesk-Datenspeicher:
Rufen Sie in der Google Google Cloud Console die Seite „Gemini Enterprise“ auf.
Projekt auswählen oder erstellen Google Cloud .
Klicken Sie im Navigationsmenü auf Datenspeicher.
Klicken Sie auf Datenspeicher erstellen.
Suchen Sie unter Quelle nach Zendesk und klicken Sie auf Auswählen.
Im Abschnitt Daten:
Geben Sie im Bereich Authentifizierungseinstellungen die folgenden Details an: * Instanz-URI:Geben Sie den Zendesk-Instanz-URI ein, z. B.
https://[subdomain].zendesk.com. * Client-ID:Die eindeutige Kennung der in Zendesk registrierten Anwendung. * Clientschlüssel:Der geheime Schlüssel, der während der Registrierung der OAuth 2.0-Anwendung in Zendesk generiert wurde.Informationen zum Abrufen der Client-ID und des Clientschlüssels finden Sie unter Client-ID und Clientschlüssel abrufen. Informationen zu den Berechtigungen, die zum Ausführen von Suchvorgängen erforderlich sind, finden Sie unter Erforderliche Berechtigungen.
Klicken Sie auf Anmelden und schließen Sie die Zendesk-Anmeldung ab.
Klicken Sie auf Weiter.
Gehen Sie im Abschnitt Ziele so vor:
- Proxyserver: Geben Sie den Hostnamen oder die IP-Adresse eines Proxys ein, über den HTTP-Traffic weitergeleitet werden soll, einschließlich Host und Port.
- Zendesk-Support-URL: Geben Sie die Instanz-URL einschließlich
https://ein. Das ist Ihre Zendesk-Support-URL. - Klicken Sie auf Weiter.
Optional: Im Abschnitt Erweiterte Optionen:
- Statische IP-Adressen aktivieren: Registriert eine kleine Gruppe statischer IP-Adressen, die der Zulassungsliste Ihres Systems hinzugefügt werden. Synchronisierungsvorgänge schlagen fehl, solange diese IP-Adressen nicht auf der Zulassungsliste stehen.
- Maximale Anzahl von API-Anfragen pro Minute: Die maximale Anzahl von API-Anfragen pro Minute, die für jeden Connector-Lauf an Ihre Zendesk-Instanz gesendet werden.
- Klicken Sie auf Weiter.
Wählen Sie im Bereich Zu suchende Entitäten alle Entitäten aus, die durchsucht werden sollen. Wählen Sie mindestens eine Entität aus.
Klicken Sie auf Weiter.
Im Abschnitt Konfiguration:
- Wählen Sie in der Liste Multiregional den Speicherort für den Daten-Connector aus.
- Geben Sie im Feld Name des Daten-Connectors einen Namen für den Connector ein.
- Wenn Sie
USoderEUals Speicherort gewählt haben, konfigurieren Sie die Verschlüsselungseinstellungen:- Optional: Wenn Sie keine Schlüssel für einzelne Regionen konfiguriert haben, klicken Sie auf Zur Einstellungsseite, um dies zu tun. Weitere Informationen finden Sie unter Cloud KMS-Schlüssel für eine einzelne Region für Drittanbieter-Connectors registrieren.
- Wählen Sie Google-verwalteter Verschlüsselungsschlüssel oder Cloud KMS-Schlüssel aus.
- Falls Sie Cloud KMS-Schlüssel ausgewählt haben:
- Wählen Sie in der Liste Schlüsselverwaltungstyp den entsprechenden Typ aus.
- Wählen Sie in der Liste Cloud KMS-Schlüssel den Schlüssel aus.
Klicken Sie auf Weiter.
Wählen Sie im Bereich Abrechnung die Option Allgemeine Preise oder die Option Konfigurierbare Preise aus. Weitere Informationen finden Sie unter Abrechnungsstatus Ihrer Projekte prüfen und Lizenzen.
Klicken Sie auf der Seite Datenspeicher auf den Namen des Datenspeichers, um den Status anzuzeigen. Sobald sich der Status des Datenspeichers von Wird erstellt zu Aktiv ändert, ist der Zendesk-Connector einsatzbereit.
Nachdem Sie den Datenspeicher erstellt haben, erstellen Sie eine App, verbinden diese mit dem Zendesk-Datenspeicher und autorisieren Gemini Enterprise für den Zugriff auf Zendesk, bevor Sie Abfragen ausführen.
Informationen zu den Berechtigungen, die zum Ausführen von Suchvorgängen erforderlich sind, finden Sie unter Erforderliche Berechtigungen.
Datenverarbeitung und Abfrageausführung
In diesem Abschnitt wird beschrieben, wie Gemini Enterprise Ihre Anfrage verarbeitet und welche Auswirkungen die Verwendung des föderierten Datenspeichers auf den Datenschutz hat.
Ausführung von Abfragen
Nachdem Sie Zendesk autorisiert und eine Suchanfrage an Gemini Enterprise gesendet haben, passiert Folgendes:
- Gemini Enterprise sendet Ihre Suchanfrage direkt an die Zendesk API.
- Gemini Enterprise kombiniert die Ergebnisse mit denen aus anderen verbundenen Datenquellen und zeigt ein umfassendes Suchergebnis an.
Datenverarbeitung
Wenn Sie eine föderierte Suche von Drittanbietern verwenden, gelten folgende Regeln für die Datenverarbeitung:
- Ihr Abfragestring wird an das Such-Backend des Drittanbieters (Zendesk API) gesendet.
- Diese Drittanbieter können Abfragen mit Ihrer Identität verknüpfen.
- Wenn mehrere Datenquellen für die föderierte Suche aktiviert sind, wird die Abfrage möglicherweise an alle gesendet.
- Sobald die Daten im Drittanbietersystem angekommen sind, unterliegen sie den Nutzungsbedingungen und Datenschutzbestimmungen dieses Systems.
Nächste Schritte
- Wenn Sie eine Benutzeroberfläche für das Abfragen Ihrer Daten bereitstellen möchten, erstellen Sie eine App und verbinden Sie sie mit dem Zendesk-Datenspeicher.
- Um eine Vorschau darüber zu erhalten, wie Ihre Suchergebnisse aussehen, nachdem Ihre App eingerichtet ist, gehen Sie auf Suchergebnisse abrufen.
- Informationen zum Aktivieren von Benachrichtigungen für den Datenspeicher finden Sie unter Benachrichtigungen für Drittanbieter-Datenspeicher konfigurieren.