Datenquelle von Drittanbietern verbinden

Auf dieser Seite wird beschrieben, wie Sie Datenquellen von Drittanbietern mit Vertex AI Search verbinden.

Wenn Sie eine Drittanbieterdatenquelle verbinden, erstellt Vertex AI Search einen Daten-Connector und verknüpft Datenspeicher (Entitätsdatenspeicher) für die von Ihnen angegebenen Entitäten damit. Entitätstypen sind spezifisch für die Datenquelle, mit der Sie eine Verbindung herstellen. Beispiele für Jira Cloud-Entitäten sind Probleme, Anhänge, Kommentare und Arbeitsprotokolle.

Datenquellen von Drittanbietern sind nur für allgemeine Suchanwendungen verfügbar. Für Chat, Empfehlungen und Kundenservicemitarbeiter-Apps dürfen keine Drittanbieterdatenquellen verwendet werden.

Connectors von Drittanbietern sind nicht CMEK-kompatibel.

Wenn Sie stattdessen Daten aus einer Google-Datenquelle importieren möchten, lesen Sie den Hilfeartikel Suchdatenspeicher erstellen.

Hinweise

  1. Wenden Sie sich an Ihr Google Konten-Team und bitten Sie darum, der Zulassungsliste für Connectors von Drittanbieterdatenquellen hinzugefügt zu werden.

  2. Rufen Sie den Abschnitt für die Quelle auf, die Sie verwenden möchten:

Confluence Cloud verbinden

So synchronisieren Sie Daten aus Confluence Cloud mit Vertex AI Search:

Nachdem Sie die Datenquelle eingerichtet und zum ersten Mal Daten importiert haben, werden die Daten aus dieser Quelle mit der Häufigkeit synchronisiert, die Sie bei der Einrichtung ausgewählt haben.

Bevor Sie die Verbindung einrichten:

  • Richten Sie die Zugriffssteuerung für Ihre Datenquelle ein. Informationen zum Einrichten der Zugriffssteuerung finden Sie unter Zugriffssteuerung für Datenquellen verwenden.

  • Halten Sie die folgenden Authentifizierungsinformationen bereit:

    • Instanz-URL. Im Format https://EXAMPLE.atlassian.net, z. B. https://google.atlassian.net.

    • Instanz-ID. Das ist der cloudid. Sie finden ihn unter https://EXAMPLE.atlassian.net/_edge/tenant_info. Kopieren Sie dazu den Wert von cloudId.

  • Aktivieren Sie OAuth 2.0 und rufen Sie die Client-ID und den Clientschlüssel ab.

    Verwenden Sie https://vertexaisearch.cloud.google.com/console/oauth/confluence_oauth.html als Callback-URL. Informationen zum Aktivieren von OAuth 2.0 für Confluence Cloud und zum Abrufen der Client-ID und des Clientschlüssels finden Sie in der Atlassian Developer-Dokumentation unter OAuth 2.0 (3LO)-Apps.

  • Konfigurieren Sie beim Festlegen von OAuth 2.0-Berechtigungsbereichen die folgenden Bereiche:

  • Damit Nutzerberechtigungen richtig angewendet werden können, muss jeder Confluence Cloud-Nutzer seine E-Mail-Adresse für alle Nutzer sichtbar machen. Ändern Sie dazu die Einstellungen für die E-Mail-Sichtbarkeit in Confluence Cloud und legen Sie die Sichtbarkeit auf Anyone fest. Weitere Informationen finden Sie in der Atlassian-Dokumentation unter E-Mail-Sichtbarkeit festlegen.

Console

So synchronisieren Sie mit der Google Cloud Console Daten aus Confluence Cloud mit Vertex AI Search:

  1. Rufen Sie in der Google Cloud Console die Seite Agent Builder auf.

    Zum Agent Builder

  2. Klicken Sie im Navigationsmenü auf Datenspeicher.

  3. Klicken Sie auf Neuer Datenspeicher.

  4. Gehen Sie auf der Seite Datenquelle auswählen zum Abschnitt Drittanbieterquellen und wählen Sie Confluence aus.

  5. Geben Sie Ihre Authentifizierungsinformationen ein und klicken Sie auf Authentifizieren.

  6. Ein neues Fenster wird geöffnet. Geben Sie den Nutzernamen und das Passwort der Instanz ein. Prüfen Sie, ob die Authentifizierung erfolgreich war, bevor Sie zur Seite Confluence-Quelle für Ihren Datenspeicher angeben zurückkehren.

  7. Wählen Sie die zu synchronisierenden Entitäten aus und klicken Sie auf Weiter.

  8. Wählen Sie eine Region für den Daten-Connector aus.

  9. Geben Sie einen Namen für den Daten-Connector ein.

  10. Wählen Sie eine Synchronisierungshäufigkeit aus.

  11. Klicken Sie auf Erstellen. Vertex AI Search erstellt Ihren Datenspeicher und zeigt ihn auf der Seite Datenspeicher an.

  12. Den Status der Datenaufnahme können Sie auf der Seite Datenspeicher prüfen. Klicken Sie dazu auf den Namen des Datenspeichers, um auf der Seite Daten Details dazu aufzurufen. Der Status des Connectors ändert sich von Erstellen zu Laufend, wenn die Datensynchronisierung beginnt. Wenn die Datenaufnahme abgeschlossen ist, ändert sich der Status in Aktiv. Das bedeutet, dass die Verbindung zu Ihrer Datenquelle eingerichtet ist und die nächste geplante Synchronisierung erwartet wird.

    Je nach Größe der Daten kann die Datenaufnahme einige Minuten oder Stunden dauern.

Nächste Schritte

Confluence Data Center On-Premises verbinden

Mit dieser Anleitung können Sie einen Confluence Data Center-Datenspeicher und eine Suchanwendung in Agent Builder erstellen und vor Ort gespeicherte Confluence-Daten mit Vertex AI Search synchronisieren.

Nachdem Sie die Datenquelle eingerichtet und Daten zum ersten Mal importiert haben, können Sie festlegen, wie oft der Datenspeicher mit dieser Quelle synchronisiert wird.

Hinweise

Bevor Sie die Verbindung einrichten, benötigen Sie Folgendes:

  • Dienstanhänge (nur für privaten Zieltyp erforderlich): Konfigurieren Sie einen Dienstanhang für die sichere Datenübertragung.
  • Nutzername und Passwort: Wenden Sie sich an Ihren Confluence-Administrator, um gültige Anmeldedaten für die Authentifizierung zu erhalten.
  • Domain-URL (optional für den privaten Zieltyp): Geben Sie die URL der Confluence Data Center-Instanz an.
  • Basisdomainname (optional): Geben Sie den Basisdomainnamen für die Confluence-Instanz an.
  • Zielport (optional): Geben Sie den Port an, der für die Kommunikation mit dem Confluence Data Center verwendet wird.

Konfigurationsrichtlinien für Private Service Connect

Folgen Sie den folgenden Konfigurationsrichtlinien, um Verbindungen mit Private Service Connect(PSC) herzustellen. Passen Sie die Ressourcen nach Bedarf an oder fügen Sie weitere hinzu. Achten Sie darauf, dass der PSC-Dienstanhang richtig für die Verbindung mit der privaten Instanz konfiguriert ist und die Anforderungen für einen veröffentlichten Dienst erfüllt.

  • Netzwerkkonfiguration:

    a. Platzieren Sie den PSC-Dienstanhang und den Load Balancer in verschiedenen Subnetzen innerhalb desselben Virtual Private Cloud-Netzwerks.

    b. Das Backend-System muss aus Sicherheitsgründen für das öffentliche Netzwerk geschlossen bleiben. Achten Sie jedoch darauf, dass Traffic von den folgenden Quellen akzeptiert werden kann:

    • Konfigurieren Sie für proxybasierte/HTTP(S)-Load Balancer (L4-Proxy-ILB, L7-ILB) das Back-End so, dass es Anfragen vom Proxy-Subnetz im Virtual Private Cloud-Netzwerk akzeptiert.
    • Weitere Informationen finden Sie in der Dokumentation Nur-Proxy-Subnetze für Envoy-basierte Load Balancer.

  • Firewallregeln:

    a. Regeln für eingehenden Traffic:

    • Lassen Sie Traffic vom Subnetz der PSC-Dienstanwendung zum Subnetz des internen Load Balancers (ILB) zu.
    • Achten Sie darauf, dass der ILB Traffic an das Backend senden kann.
    • Erlauben Sie Systemdiagnosetests, das Backend zu erreichen.

    b. Regeln für ausgehenden Traffic:

    • Aktivieren Sie ausgehenden Traffic standardmäßig, es sei denn, bestimmte Regeln zum Ablehnen gelten.

Weitere Überlegungen:

  • Achten Sie darauf, dass sich alle Komponenten, einschließlich des PSC-Dienstanhangs und des Load Balancers, in derselben Region befinden.

Dienstanhang generieren

So generieren Sie einen Dienstanhang:

  1. Endpunkttyp auswählen: Wählen Sie Öffentlich oder Privat aus.

  2. Öffentlicher Endpunkt: Wenn der Zieltyp des Confluence-Rechenzentrums Öffentlich ist, müssen Sie die Einrichtung für den Dienstanhang nicht erstellen. Stattdessen können Sie beim Erstellen des Connectors Ihre öffentliche URL im Feld Domain-URL der Google Cloud Console verwenden.

  3. Für den privaten Endpunkt:

    a. Verwenden Sie Private Service Connect (PSC), um Verbindungen von privaten Instanzen zu Google Cloud zu ermöglichen.

    b. Erstellen Sie ein Virtual Private Cloud-Netzwerk und die erforderlichen Subnetze.

    c. Erstellen Sie eine VM-Instanz und installieren Sie den Back-End-Dienst.

    d. Optional: Richten Sie einen Systemdiagnose-Test ein, um den Zustand des Backends zu überwachen.

    e. Fügen Sie einen Load Balancer hinzu, um den Traffic an die VM oder das Back-End weiterzuleiten.

    f. Definieren Sie Firewallregeln, um Traffic zwischen dem PSC-Endpunkt und dem Backend zuzulassen.

    g. Veröffentlichen Sie den Endpunkt, indem Sie einen PSC-Dienstanhang erstellen.

Confluence Data Center-Nutzer erstellen und Berechtigungen einrichten

Damit Vertex AI Search Daten aus Confluence abrufen kann, müssen Sie einen neuen Nutzer mit den erforderlichen Mindestberechtigungen erstellen. So erstellen Sie den Nutzer und richten die erforderlichen Berechtigungen ein:

Als Administrator anmelden
  1. Rufen Sie die Website Ihrer Atlassian-Domain auf und öffnen Sie die Confluence Data Center-Instanz.
  2. Geben Sie den Nutzernamen und das Passwort des Administrators ein.
  3. Klicken Sie auf Log In (Anmelden).
Neuen Nutzer erstellen

Wenn Sie einen Datenspeicher erstellen, müssen Sie einen Nutzer erstellen, um Daten von der Drittanbieterinstanz abzurufen.

  1. Klicken Sie auf das Symbol für die Einstellungen.
  2. Wählen Sie Nutzerverwaltung aus.
  3. Geben Sie die Administratoranmeldedaten ein, wenn Sie dazu aufgefordert werden.
  4. Klicken Sie auf der Seite Verwaltung auf Nutzer erstellen.
  5. Geben Sie die E-Mail-Adresse, den vollständigen Namen, den Nutzernamen und das Passwort ein.
  6. Klicken Sie auf Nutzer erstellen.
Nutzer einer Gruppe zuweisen
  1. Rufen Sie auf der Seite Confluence-Verwaltung den Tab „Nutzer und Sicherheit“ auf und klicken Sie auf Gruppen.
  2. Klicken Sie auf Gruppe hinzufügen. Geben Sie einen Namen für die Gruppe ein und erstellen Sie sie.
  3. Geben Sie im Feld Gruppe suchen den Namen der Gruppe ein, um sie zu finden.
  4. Klicken Sie auf das Symbol für die Einstellungen.
  5. Wählen Sie das Profilkonto aus und rufen Sie Nutzerverwaltung auf.
  6. Suchen Sie auf der Seite Nutzer unter Nutzerliste im Feld Nutzer suchen nach dem neu erstellten Nutzer.
  7. Klicken Sie auf den Nutzer, um die Seite Nutzer ansehen zu öffnen.
  8. Klicken Sie auf Gruppen bearbeiten, um die Seite Nutzergruppe bearbeiten zu öffnen.
  9. Klicken Sie das Kästchen für die erstellte Nutzergruppe an.
  10. Klicken Sie auf Speichern, um den Nutzer der neu erstellten Gruppe zuzuweisen.

Der hinzugefügte Nutzer wird im Bereich Gruppenmitglieder zugewiesen.

Nutzerberechtigungen konfigurieren
  1. Rufen Sie auf der Seite Confluence-Verwaltung den Tab Probleme auf.
  2. Suchen Sie Berechtigungen.
  3. Wählen Sie Globale Berechtigungen ansehen aus.
  4. Wählen Sie Berechtigungen bearbeiten aus.
  5. Suchen Sie auf der Seite Globale Berechtigungen bearbeiten nach der Gruppe, die dem Nutzer zugewiesen ist, und aktivieren Sie die Option kann verwenden.

Dokumentationsbereich konfigurieren

  1. Klicken Sie auf das Symbol Confluence, um die Seite Dashboard aufzurufen.
  2. Klicken Sie auf Gruppenbereich erstellen.
  3. Wählen Sie Documentation space (Dokumentationsbereich) aus und klicken Sie auf Weiter.
  4. Geben Sie alle erforderlichen Details ein und klicken Sie auf Erstellen, um den Dokumentbereich zu erstellen.
  5. Klicken Sie unter Meine Gruppenbereiche auf den neu erstellten Gruppenbereich.
  6. Rufen Sie Seiten auf und öffnen Sie das Dreipunkt-Menü.
  7. Wählen Sie Einschränkungen aus.
  8. Wählen Sie im Drop-down-Menü Einschränkungen die Option Ansehen und Bearbeiten eingeschränkt aus.
  9. Suchen Sie nach der Gruppe und weisen Sie die Berechtigung kann ansehen zu.
  10. Klicken Sie auf Anwenden. Der Nutzer wird mit minimalem Zugriff erstellt und es werden Berechtigungen für Gruppenbereiche festgelegt. Sie können den Blogs auch Berechtigungen zuweisen.

On-Premises-Connector für Confluence Data Center erstellen

Richten Sie einen lokalen Confluence Data Center-Connector ein, um Daten mit Google Cloud zu synchronisieren. Erstellen Sie zuerst einen Datenspeicher in Agent Builder und konfigurieren Sie die Verbindungseinstellungen, einschließlich Authentifizierungs- und Synchronisierungseinstellungen.

#### On-Premises-Connector für Confluence Data Center erstellen

Console

So synchronisieren Sie mit der Google Cloud Console Daten aus Confluence Cloud mit Vertex AI Search:

  1. Rufen Sie in der Google Cloud Console die Seite Agent Builder auf.

    Zum Agent Builder

  2. Klicken Sie im Navigationsmenü auf Datenspeicher.

  3. Klicken Sie auf Neuer Datenspeicher.

  4. Gehen Sie auf der Seite Datenquelle auswählen zum Abschnitt Drittanbieterquellen und wählen Sie Confluence aus.

  5. Geben Sie Ihre Authentifizierungsinformationen ein und klicken Sie auf Authentifizieren.

  6. Ein neues Fenster wird geöffnet. Geben Sie den Nutzernamen und das Passwort der Instanz ein. Prüfen Sie, ob die Authentifizierung erfolgreich war, bevor Sie zur Seite Confluence-Quelle für Ihren Datenspeicher angeben zurückkehren.

  7. Wählen Sie die zu synchronisierenden Entitäten aus und klicken Sie auf Weiter.

  8. Wählen Sie eine Region für den Daten-Connector aus.

  9. Geben Sie einen Namen für den Daten-Connector ein.

  10. Wählen Sie eine Synchronisierungshäufigkeit aus.

  11. Klicken Sie auf Erstellen. Vertex AI Search erstellt Ihren Datenspeicher und zeigt ihn auf der Seite Datenspeicher an.

  12. Den Status der Datenaufnahme können Sie auf der Seite Datenspeicher prüfen. Klicken Sie dazu auf den Namen des Datenspeichers, um auf der Seite Daten Details dazu aufzurufen. Der Status des Connectors ändert sich von Erstellen zu Laufend, wenn die Datensynchronisierung beginnt. Wenn die Datenaufnahme abgeschlossen ist, ändert sich der Status in Aktiv. Das bedeutet, dass die Verbindung zu Ihrer Datenquelle eingerichtet ist und die nächste geplante Synchronisierung erwartet wird.

    Je nach Größe der Daten kann die Datenaufnahme einige Minuten oder Stunden dauern.

Nächste Schritte

Jira Cloud verbinden

So synchronisieren Sie Daten aus Jira Cloud mit Vertex AI Search:

Nachdem Sie die Datenquelle eingerichtet und Daten zum ersten Mal importiert haben, können Sie festlegen, wie oft der Datenspeicher mit dieser Quelle synchronisiert wird.

Hinweise

Bevor Sie die Verbindung einrichten:

  • Richten Sie die Zugriffssteuerung ein. Prüfen Sie, ob die Zugriffssteuerung für Ihre Datenquelle richtig konfiguriert ist. So wird sichergestellt, dass nur autorisierte Nutzer auf die Daten zugreifen und sie verwalten können. Weitere Informationen finden Sie in der Dokumentation Zugriffssteuerung für Datenquellen verwenden.
  • Damit Nutzerberechtigungen richtig angewendet werden können, müssen Jira Cloud-Nutzer ihre Einwilligung zur Freigabe erteilen.
  • Sie benötigen ein Atlassian-Konto, eine Jira-Instanz und ein Projekt.
  • Prüfen Sie, ob Sie Administratorzugriff auf die Jira-Instanz und das Projekt haben.

Authentifizierung und Berechtigungen in Jira einrichten

Anhand der Anleitungen in den folgenden Abschnitten können Sie prüfen, ob Sie die erforderlichen Authentifizierungsdetails und den Administratorzugriff auf Ihre Jira-Instanz haben. Erstellen Sie eine Client-ID und einen Clientschlüssel über die Atlassian Developer Console, konfigurieren Sie die erforderlichen OAuth 2.0-Bereiche und richten Sie Berechtigungen für Nutzer ein. Rufen Sie abschließend die Instanz-URL und ‑ID ab, konfigurieren Sie Rollen und authentifizieren Sie sich, um Daten zwischen Jira Cloud und Vertex AI Search zu synchronisieren.

Client-ID und Clientschlüssel erstellen

  1. Melden Sie sich unter developer.atlassian.com an.
  2. Klicken Sie rechts oben auf das Profilsymbol und wählen Sie Developer Console (Entwicklerkonsole) aus.
  3. Klicken Sie auf Erstellen und wählen Sie OAuth 2.0-Integration aus.
  4. Geben Sie einen Namen für die App ein.
    • Klicken Sie das Kästchen für die Nutzungsbedingungen an.
    • Klicken Sie auf Erstellen.

  5. Sie sehen fünf Optionen: Übersicht, Verteilung, Berechtigungen, Autorisierung und Einstellungen. Beginnen Sie mit Autorisierung:

    a. Klicken Sie auf Autorisierung.

    b. Wählen Sie in der Tabelle Autorisierungstyp für OAuth 2.0 (3LO) die Option Hinzufügen aus.

  6. Geben Sie im Feld Callback-URL https://vertexaisearch.cloud.google.com/console/oauth/jira_oauth.html ein und klicken Sie dann auf Änderungen speichern.

    HINWEIS: Wenn Sie die Warnung Ihre App hat keine APIs sehen, Ihrer App APIs hinzufügen.Dies wird im nächsten Abschnitt behandelt.

  7. Wählen Sie Berechtigungen aus:

    a. Rufen Sie die Jira API auf, klicken Sie auf Hinzufügen und dann auf Konfigurieren.

    HINWEIS:Wenn Sie auf Hinzufügen klicken, ändert sich die Schaltfläche in Konfigurieren.

    b. Rufen Sie den Tab Klassische Berechtigungen auf und klicken Sie auf Berechtigungen bearbeiten. Wählen Sie die folgenden Bereiche aus:

    Prüfen Sie, ob sieben Bereiche ausgewählt sind, und speichern Sie dann die Änderungen.

  8. Klicken Sie auf Verteilung, wählen Sie Bearbeiten aus und gehen Sie so vor:

    • Wählen Sie zuerst das Optionsfeld Freigabe aus, um andere Felder bearbeiten zu können.
    • Füllen Sie die restlichen Felder aus.
    • Wählen Sie Ja aus, wenn Sie gefragt werden: Does your app store personal data?

  9. Wähle Einstellungen aus, um deine Client-ID und dein Client-Secret zu kopieren.

Instanz-URL und Instanz-ID abrufen

So rufen Sie die Instanz-URL ab:

  1. Rufen Sie atlassian.net auf und melden Sie sich mit Ihrem Administratorkonto an.
  2. Wählen Sie die App aus, die Sie synchronisieren möchten. Synchronisieren Sie beispielsweise die erste App.
  3. Suchen Sie die Instanz-URL, also die Subdomain in der Adressleiste. Er sieht so aus: Assign appropriate permissions.

So rufen Sie die Instanz-ID ab:

  1. Öffnen Sie einen neuen Tab, kopieren Sie die Instanz-URL und hängen Sie /_edge/tenant_info an die Instanz-URL an. Beispiel: https://YOUR-INSTANCE.atlassian.net/_edge/tenant_info.
  2. Rufen Sie den Link auf, um den Wert für cloudId zu finden. cloudId ist Ihre Instanz-ID.

Berechtigungen und Rollen einrichten

  1. Melden Sie sich mit Ihrem Administratorkonto unter atlassian.com an.
  2. Klicken Sie auf das Menüsymbol links oben oder rufen Sie admin.atlassian.com auf.

  3. Klicken Sie auf der Seite Verwaltung auf Nutzer verwalten und rufen Sie die Seite Gruppen auf.

  4. Klicken Sie auf Gruppe erstellen. Geben Sie einen Namen für die Gruppe ein und erstellen Sie sie.

  5. Klicken Sie auf der Seite der neuen Gruppe im Abschnitt Produktzugriff gruppieren auf Produkte zur Gruppe hinzufügen.

  6. Wählen Sie für Jira die Produktrolle Administrator für den Nutzerzugriff aus.

  7. Wählen Sie für Jira-Administrator die Produktrolle Produktadministrator aus und speichern Sie die Änderungen.

  8. Klicken Sie auf der Seite Gruppen auf Gruppenmitglieder hinzufügen und fügen Sie Nutzer oder Konten hinzu, als die sich der Connector authentifizieren soll.

Jira Cloud-Connector erstellen

Console

So synchronisieren Sie mit der Google Cloud Console Daten aus Jira Cloud mit Vertex AI Search:

  1. Rufen Sie in der Google Cloud Console die Seite Agent Builder auf.

    Zum Agent Builder

  2. Klicken Sie im Navigationsmenü auf Datenspeicher.

  3. Klicken Sie auf Datenspeicher erstellen.

  4. Gehen Sie auf der Seite Datenquelle auswählen zum Abschnitt Drittanbieterquellen und wählen Sie Jira aus.

  5. Geben Sie Ihre Authentifizierungsinformationen ein und klicken Sie auf Authentifizieren.

  6. Ein neues Fenster wird geöffnet. Geben Sie den Nutzernamen und das Passwort der Instanz ein. Prüfen Sie, ob die Authentifizierung erfolgreich war, bevor Sie zur Seite Jira-Quelle für Ihren Datenspeicher angeben zurückkehren.

  7. Wählen Sie die zu synchronisierenden Entitäten aus und klicken Sie auf Weiter.

  8. Wählen Sie eine Region für Ihren Datenspeicher aus.

  9. Geben Sie einen Namen für den Datenspeicher ein.

  10. Wählen Sie eine Synchronisierungshäufigkeit aus.

  11. Klicken Sie auf Erstellen. Vertex AI Search erstellt Ihren Datenspeicher und zeigt ihn auf der Seite Datenspeicher an.

  12. Den Status der Datenaufnahme können Sie auf der Seite Datenspeicher prüfen. Klicken Sie dazu auf den Namen des Datenspeichers, um auf der Seite Daten Details dazu aufzurufen. Der Status des Connectors ändert sich von Erstellen zu Laufend, wenn die Datensynchronisierung beginnt. Wenn die Datenaufnahme abgeschlossen ist, ändert sich der Status in Aktiv. Das bedeutet, dass die Verbindung zu Ihrer Datenquelle eingerichtet ist und die nächste geplante Synchronisierung erwartet wird.

    Je nach Größe der Daten kann die Datenaufnahme einige Minuten oder Stunden dauern.

Nächste Schritte

Jira Data Center On-Premises verbinden

Mit dieser Anleitung können Sie einen Jira Data Center-Datenspeicher und eine Suchanwendung in Agent Builder erstellen und On-Premises-Jira-Daten mit Vertex AI Search synchronisieren.

Nachdem Sie die Datenquelle eingerichtet und Daten zum ersten Mal importiert haben, können Sie festlegen, wie oft der Datenspeicher mit dieser Quelle synchronisiert wird.

Hinweise

Bevor Sie die Verbindung einrichten, benötigen Sie Folgendes:

  • Dienstanhänge (nur für privaten Zieltyp erforderlich): Konfigurieren Sie einen Dienstanhang für die sichere Datenübertragung.
  • Nutzername und Passwort: Wenden Sie sich an Ihren Jira-Administrator, um gültige Anmeldedaten für die Authentifizierung zu erhalten.
  • Domain-URL (optional für den privaten Zieltyp): Geben Sie die URL der Jira Data Center-Instanz an.
  • Basisdomainname (optional): Geben Sie den Basisdomainnamen für die Jira-Instanz an.
  • Zielport (optional): Geben Sie den Port an, der für die Kommunikation mit dem Jira Data Center verwendet wird.

Konfigurationsrichtlinien für Private Service Connect

Folgen Sie den folgenden Konfigurationsrichtlinien, um Verbindungen mit Private Service Connect(PSC) herzustellen. Passen Sie die Ressourcen nach Bedarf an oder fügen Sie weitere hinzu. Achten Sie darauf, dass der PSC-Dienstanhang richtig für die Verbindung mit der privaten Instanz konfiguriert ist und die Anforderungen für einen veröffentlichten Dienst erfüllt.

  • Netzwerkkonfiguration:

    a. Platzieren Sie den PSC-Dienstanhang und den Load Balancer in verschiedenen Subnetzen innerhalb desselben Virtual Private Cloud-Netzwerks.

    b. Das Backend-System muss aus Sicherheitsgründen für das öffentliche Netzwerk geschlossen bleiben. Achten Sie jedoch darauf, dass Traffic von den folgenden Quellen akzeptiert werden kann:

    • Konfigurieren Sie für proxybasierte/HTTP(S)-Load Balancer (L4-Proxy-ILB, L7-ILB) das Back-End so, dass es Anfragen vom Proxy-Subnetz im Virtual Private Cloud-Netzwerk akzeptiert.

    • Weitere Informationen finden Sie in der Dokumentation Nur-Proxy-Subnetze für Envoy-basierte Load Balancer.

  • Firewallregeln:

    a. Regeln für eingehenden Traffic:

    • Lassen Sie Traffic vom Subnetz der PSC-Dienstanwendung zum Subnetz des internen Load Balancers (ILB) zu.
    • Achten Sie darauf, dass der ILB Traffic an das Backend senden kann.
    • Erlauben Sie Systemdiagnosetests, das Backend zu erreichen.

    b. Regeln für ausgehenden Traffic:

    • Aktivieren Sie ausgehenden Traffic standardmäßig, es sei denn, bestimmte Regeln zum Ablehnen gelten.

Weitere Überlegungen:

  • Achten Sie darauf, dass sich alle Komponenten, einschließlich des PSC-Dienstanhangs und des Load Balancers, in derselben Region befinden.

Dienstanhang generieren

So generieren Sie einen Dienstanhang:

  1. Endpunkttyp auswählen: Wählen Sie Öffentlich oder Privat aus.

  2. Für öffentlichen Endpunkt: Wenn der Zieltyp des Jira-Rechenzentrums öffentlich ist, müssen Sie die Einrichtung für den Dienstanhang nicht erstellen. Sie können stattdessen Ihre öffentliche URL im Feld Domain-URL der Google Cloud Console verwenden.

  3. Für den privaten Endpunkt:

    a. Verwenden Sie PSC, um Verbindungen von privaten Instanzen zu Google Cloud zu ermöglichen.

    b. Erstellen Sie ein Virtual Private Cloud-Netzwerk und die erforderlichen Subnetze.

    c. Erstellen Sie eine VM-Instanz und installieren Sie den Back-End-Dienst.

    d. Optional: Richten Sie einen Systemdiagnose-Test ein, um den Zustand des Backends zu überwachen.

    e. Fügen Sie einen Load Balancer hinzu, um den Traffic an die VM oder das Back-End weiterzuleiten.

    f. Definieren Sie Firewallregeln, um Traffic zwischen dem PSC-Endpunkt und dem Backend zuzulassen.

    g. Veröffentlichen Sie den Endpunkt, indem Sie einen PSC-Dienstanhang erstellen.

Jira Data Center-Nutzer erstellen und Berechtigungen einrichten

Damit Vertex AI Search Daten aus Jira abrufen kann, müssen Sie einen neuen Nutzer mit den erforderlichen Mindestberechtigungen erstellen. So erstellen Sie den Nutzer und richten die erforderlichen Berechtigungen ein:

Als Administrator anmelden
  1. Rufen Sie die Website Ihrer Atlassian-Domain auf und öffnen Sie die Jira Data Center-Instanz.
  2. Geben Sie den Nutzernamen und das Passwort des Administrators ein.
  3. Klicken Sie auf Log In (Anmelden).
Neuen Nutzer erstellen

Wenn Sie einen Datenspeicher erstellen, müssen Sie einen Nutzer erstellen, um Daten von der Drittanbieterinstanz abzurufen.

  1. Klicken Sie auf das Symbol für die Einstellungen.
  2. Wählen Sie Nutzerverwaltung aus.
  3. Geben Sie die Administratoranmeldedaten ein, wenn Sie dazu aufgefordert werden.
  4. Klicken Sie auf der Seite Verwaltung auf Nutzer erstellen.
  5. Geben Sie die E-Mail-Adresse, den vollständigen Namen, den Nutzernamen und das Passwort ein.
  6. Klicken Sie auf Nutzer erstellen.
Nutzer einer Gruppe zuweisen
  1. Klicken Sie auf der Seite Verwaltung unter Nutzerverwaltung auf Gruppen.
  2. Erstellen Sie eine Gruppe, indem Sie einen Namen eingeben und auf Gruppe hinzufügen klicken.
  3. Wählen Sie die neu erstellte Gruppe aus.
  4. Klicken Sie auf Nutzer hinzufügen/entfernen.
  5. Klicken Sie auf das Mitgliedssymbol neben dem Feld Ausgewählten Gruppen Mitglieder hinzufügen.
  6. Wählen Sie den neu erstellten Nutzer aus und klicken Sie auf Auswahl speichern.
  7. Klicken Sie auf Ausgewählten Nutzer hinzufügen, um neue Nutzer im Bereich „Gruppenmitglieder“ zu sehen.

Sie sehen, dass der hinzugefügte Nutzer im Bereich Gruppenmitglieder zugewiesen ist.

Nutzerberechtigungen konfigurieren
  1. Rufen Sie auf der Seite Verwaltung den Tab Probleme auf.
  2. Wählen Sie Berechtigungsschemata aus.
  3. Klicken Sie auf Berechtigungsschema hinzufügen.
  4. Geben Sie einen Namen für das Schema ein und klicken Sie auf Hinzufügen.
  5. Wählen Sie das Schema aus und klicken Sie auf das Symbol Berechtigung.
  6. Klicken Sie auf Berechtigung gewähren.
  7. Fügen Sie die folgenden Berechtigungen hinzu, weisen Sie sie der zuvor erstellten Gruppe zu und klicken Sie auf Gewähren:
    • Projekte durchsuchen
    • Projekte im Archiv durchsuchen

Sie können dieses Schema den Projekten hinzufügen, in denen die Nutzer in dieser Gruppe Zugriff benötigen, um das Projekt und die zugehörigen Probleme, Kommentare, Arbeitsprotokolle und Anhänge aufzurufen.

Anwendungszugriff konfigurieren

  1. Rufen Sie auf der Seite Verwaltung den Tab Anwendungen auf.
  2. Wählen Sie auf dem Tab Anwendungen die Option Anwendungszugriff aus.
  3. Suchen Sie nach der erstellten Gruppe und wählen Sie sie aus.
  4. Prüfen Sie, ob die Gruppe in der Zugriffsliste aufgeführt ist.

Der Nutzer wird mit minimalen Zugriffsberechtigungen erstellt. Dieses Schema wird den Projekten hinzugefügt. Der Jira-Administrator kann dieser Gruppe weitere Mitglieder oder dem Projekt weitere Nutzer hinzufügen.

On-Premises-Connector für Jira Data Center erstellen

Richten Sie einen lokalen Jira Data Center-Connector ein, um Daten mit Google Cloud zu synchronisieren. Erstellen Sie zuerst einen Datenspeicher in Agent Builder und konfigurieren Sie die Verbindungseinstellungen, einschließlich Authentifizierungs- und Synchronisierungseinstellungen.

On-Premises-Connector für Jira Data Center erstellen

Console

So synchronisieren Sie mit der Google Cloud Console Daten aus Jira Cloud mit Vertex AI Search:

  1. Rufen Sie in der Google Cloud Console die Seite Agent Builder auf.

    Zum Agent Builder

  2. Klicken Sie im Navigationsmenü auf Datenspeicher.

  3. Klicken Sie auf Datenspeicher erstellen.

  4. Gehen Sie auf der Seite Datenquelle auswählen zum Abschnitt Drittanbieterquellen und wählen Sie Jira aus.

  5. Geben Sie Ihre Authentifizierungsinformationen ein und klicken Sie auf Authentifizieren.

  6. Ein neues Fenster wird geöffnet. Geben Sie den Nutzernamen und das Passwort der Instanz ein. Prüfen Sie, ob die Authentifizierung erfolgreich war, bevor Sie zur Seite Jira-Quelle für Ihren Datenspeicher angeben zurückkehren.

  7. Wählen Sie die zu synchronisierenden Entitäten aus und klicken Sie auf Weiter.

  8. Wählen Sie eine Region für Ihren Datenspeicher aus.

  9. Geben Sie einen Namen für den Datenspeicher ein.

  10. Wählen Sie eine Synchronisierungshäufigkeit aus.

  11. Klicken Sie auf Erstellen. Vertex AI Search erstellt Ihren Datenspeicher und zeigt ihn auf der Seite Datenspeicher an.

  12. Den Status der Datenaufnahme können Sie auf der Seite Datenspeicher prüfen. Klicken Sie dazu auf den Namen des Datenspeichers, um auf der Seite Daten Details dazu aufzurufen. Der Status des Connectors ändert sich von Erstellen zu Laufend, wenn die Datensynchronisierung beginnt. Wenn die Datenaufnahme abgeschlossen ist, ändert sich der Status in Aktiv. Das bedeutet, dass die Verbindung zu Ihrer Datenquelle eingerichtet ist und die nächste geplante Synchronisierung erwartet wird.

    Je nach Größe der Daten kann die Datenaufnahme einige Minuten oder Stunden dauern.

Nächste Schritte

Salesforce verbinden

So synchronisieren Sie Daten aus Salesforce mit Vertex AI Search:

Nachdem Sie die Datenquelle eingerichtet und zum ersten Mal Daten importiert haben, werden die Daten aus dieser Quelle mit der Häufigkeit synchronisiert, die Sie bei der Einrichtung ausgewählt haben.

Hinweise

Bevor Sie die Verbindung einrichten:

  • Richten Sie die Zugriffssteuerung für Ihre Datenquelle ein. Informationen zum Einrichten der Zugriffssteuerung finden Sie unter Zugriffssteuerung für Datenquellen verwenden.

  • Halten Sie die folgenden Authentifizierungsinformationen bereit. Informationen zum Einrichten der Client-ID und des Clientsecrets in Salesforce finden Sie in der Salesforce-Dokumentation unter Verbundene App für den OAuth 2.0-Client-Anmeldedatenfluss konfigurieren.

    • Instanz-URL: Der Domainname Ihrer Salesforce-Instanz. Suchen Sie nach Meine Domain, kopieren Sie die Domain, die auf my.salesforce.com endet, und fügen Sie https:// an den Anfang an.
    • Client-ID: Klicken Sie auf Kundendetails verwalten, um die Client-ID aus der verbundenen App zu kopieren. Wenn das Aktualisierungstoken aktiviert ist, prüfen Sie, ob das Token aktualisiert wird, und geben Sie beim Erstellen eines Datenspeichers das aktuelle Token an.
    • Clientschlüssel: Klicken Sie auf Kundendetails verwalten, um den Clientschlüssel aus der verbundenen App zu kopieren. Wenn das Aktualisierungstoken aktiviert ist, prüfen Sie, ob das Token aktualisiert wird, und geben Sie beim Erstellen eines Datenspeichers das aktuelle Token an.

  • Damit Nutzerberechtigungen richtig angewendet werden können, müssen Salesforce-Nutzer ihre Einwilligung zur Freigabe erteilen.

  • Sie haben ein Enterprise- oder Entwickler-Abo. Testkonten werden nicht unterstützt.

  • Sie müssen Sales Cloud verwenden. Service Cloud wird nicht unterstützt.

  • Fügen Sie Google Cloud der CORS-Zulassungsliste von Salesforce hinzu. Wenn Sie diese Aufgabe bereits erledigt haben, fahren Sie mit dem Abschnitt „App erstellen“ fort.

    • Folgen Sie der Anleitung in der Salesforce-Dokumentation, um die CORS-Zulassungsliste zu konfigurieren.
    • Geben Sie https://console.cloud.google.com/ als Ursprungs-URL ein und speichern Sie die Konfiguration.

App erstellen

Salesforce unterstützt die folgenden Apps:

  1. Verbundene App
  2. Externe Client-App

Verbundene App erstellen

So richten Sie eine verbundene Anwendung in Salesforce für die Einbindung in Google Cloud ein:

  1. Melden Sie sich in Salesforce an.
  2. Klicken Sie auf das Zahnradsymbol und gehen Sie zu Einrichtung.
  3. Gehen Sie im Menü Einrichtung zu App-Manager.
  4. Klicken Sie auf Neue verbundene App.

  5. So konfigurieren Sie die verbundene App:

    a. Führen Sie auf der Seite zum Erstellen der verbundenen App die folgenden Schritte aus:

    • Klicken Sie das Kästchen OAuth-Einstellungen aktivieren an.
    • Legen Sie die Callback-URL auf https://vertexaisearch.cloud.google.com/console/oauth/salesforce_oauth.html fest.
    • Wählen Sie die folgenden OAuth-Bereiche aus:
      • Vollzugriff (full)
      • Anfragen jederzeit ausführen (refresh_token, offline_access)

    b. Aktivieren Sie die folgenden Abläufe:

    • Ablauf der Clientanmeldedaten
    • Ablauf für Autorisierungscode und Anmeldedaten
    • Nutzeranmeldedaten im POST-Text für Autorisierungscode und Anmeldedatenablauf
    • Weisen Sie für den Ablauf der Clientanmeldedaten im Feld Als ausführen Ihren Nutzernamen zu. Sie benötigen Leseberechtigungen für alle Entitäten, die Ihr Connector extrahieren kann.

Gehen Sie nach dem Erstellen der verbundenen App so vor:

  1. App-Richtlinien bearbeiten:

    • Rufen Sie den App-Manager auf und bearbeiten Sie die neu erstellte App.
    • Legen Sie für IP-Lockerung den Wert Relax IP restrictions fest.
    • Konfigurieren Sie die Richtlinie für das Aktualisierungstoken nach Bedarf auf Valid until revoked oder auf eine restriktivere Einstellung.
    • Achten Sie darauf, dass Zulässige Nutzer auf All users may self-authorize festgelegt ist.

  2. Konfigurieren Sie IP-Einschränkungen:

    • Wenn die Durchsetzung von IP-Bereichen auf Organisationsebene aktiviert ist, legen Sie unter Sicherheit > Netzwerkzugriff die Vertrauenswürdigen IP-Bereiche fest. Weitere Informationen finden Sie in der Dokumentation IP-Lockerung und kontinuierliche IP-Durchsetzung für verbundene Apps.
    • Deaktivieren Sie IP-Bereiche für Anmeldungen bei jeder Anfrage erzwingen, wenn keine IP-Einschränkungen erforderlich sind.

  3. So konfigurieren Sie eine mit OAuth verbundene App:

  4. So speichern Sie die verbundene App:

    • Speichern Sie die verbundene App und schließen Sie sie.
    • Suchen Sie in der Suchleiste nach OAuth- und OpenId Connect-Einstellungen.
    • Aktivieren Sie Autorisierungscode- und Anmeldedatenabläufe zulassen und OAuth-Abläufe mit Nutzernamen und Passwort.

Externe Client-App erstellen

So erstellen und konfigurieren Sie eine externe Client-App in Salesforce, um die OAuth-basierte Authentifizierung für Integrationen zu aktivieren:

  1. Client-ID und Clientschlüssel abrufen:

    • Melden Sie sich in Salesforce an.
    • Klicken Sie auf das Zahnradsymbol und gehen Sie zu Einrichtung.
    • Gehen Sie zu Einrichtung > Apps > Externe Client-Apps.
    • Klicken Sie auf Neue externe Client-App.

  2. Geben Sie die erforderlichen Informationen an:

    • Geben Sie den Namen der App und Ihre E-Mail-Adresse ein. Der API-Name wird standardmäßig automatisch ausgefüllt.
    • Belassen Sie den Vertriebsstatus bei Local.

  3. Aktivieren Sie die OAuth-Einstellungen:

    • Maximieren Sie API (OAuth-Einstellungen aktivieren) und wählen Sie OAuth aktivieren aus.
    • Konfigurieren:
      • Callback-URL: https://login.salesforce.com/services/oauth2/callback
      • OAuth-Bereiche: Nutzerdaten über APIs verwalten (api).
      • Wählen Sie unter Flow-Aktivierung die Option Clientanmeldedatenfluss aktivieren aus.
      • Klicken Sie auf Erstellen, um die externe Client-App zu erstellen. Gehen Sie zum Verwaltungstool für externe Client-Apps, um die App aufzurufen, die Sie der Liste hinzugefügt haben.

  4. App-Richtlinien bearbeiten:

    • Öffnen Sie die erstellte App.
    • Klicken Sie auf Richtlinien und dann auf Bearbeiten.
    • Setzen Sie unter OAuth-Abläufe und Verbesserungen für externe Clientanwendungen ein Häkchen bei Ablauf für Clientanmeldedaten aktivieren.
    • Geben Sie Ihren Salesforce-Nutzernamen in das Feld Als ausführen ein.

  5. Auf OAuth-Anmeldedaten zugreifen:

    • Klicken Sie auf Einstellungen.
    • Klicken Sie auf OAuth-Einstellungen.
    • Klicken Sie auf Consumer-Key und Secret, um auf die Anmeldedaten zuzugreifen. Der Bestätigungscode wird an Ihre E-Mail-Adresse gesendet.
    • Gib den Bestätigungscode ein und klicke auf Bestätigen.
    • Kopieren Sie den Consumer-Schlüssel und verwenden Sie ihn als Client-ID.
    • Kopieren Sie das Consumer Secret und verwenden Sie es als Clientschlüssel.

Salesforce-Connector erstellen

Console

So synchronisieren Sie Daten aus Salesforce mit Vertex AI Search über die Google Cloud Console:

  1. Rufen Sie in der Google Cloud Console die Seite Agent Builder auf.

    Zum Agent Builder

  2. Klicken Sie im Navigationsmenü auf Datenspeicher.

  3. Klicken Sie auf Datenspeicher erstellen.

  4. Scrollen Sie auf der Seite Datenquelle auswählen nach unten oder suchen Sie nach Salesforce, um eine Verbindung zu Ihrer Drittanbieterquelle herzustellen.

  5. Geben Sie Ihre Salesforce-Authentifizierungsinformationen ein.

  6. Wählen Sie die zu synchronisierenden Entitäten aus und klicken Sie auf Weiter.

  7. Wählen Sie eine Region für Ihren Datenspeicher aus.

  8. Geben Sie einen Namen für den Datenspeicher ein.

  9. Wählen Sie eine Synchronisierungshäufigkeit aus.

  10. Klicken Sie auf Erstellen. Vertex AI Search erstellt Ihren Datenspeicher und zeigt ihn auf der Seite Datenspeicher an.

  11. Den Status der Datenaufnahme können Sie auf der Seite Datenspeicher prüfen. Klicken Sie dazu auf den Namen des Datenspeichers, um auf der Seite Daten Details dazu aufzurufen. Der Status des Connectors ändert sich von Erstellen zu Laufend, sobald die Datensynchronisierung beginnt. Wenn die Datenaufnahme abgeschlossen ist, ändert sich der Status in Aktiv. Das bedeutet, dass die Verbindung zu Ihrer Datenquelle eingerichtet ist und die nächste geplante Synchronisierung erwartet wird.

    Je nach Größe der Daten kann die Datenaufnahme einige Minuten oder Stunden dauern.

Nächste Schritte

ServiceNow verbinden

So synchronisieren Sie Daten aus ServiceNow mit Vertex AI Search:

Nachdem Sie die Datenquelle eingerichtet und zum ersten Mal Daten importiert haben, werden die Daten aus dieser Quelle mit der Häufigkeit synchronisiert, die Sie bei der Einrichtung ausgewählt haben.

Bevor Sie die Verbindung einrichten:

  • Richten Sie die Zugriffssteuerung für Ihre Datenquelle ein. Informationen zum Einrichten der Zugriffssteuerung finden Sie unter Zugriffssteuerung für Datenquellen verwenden.

  • Halten Sie die folgenden Authentifizierungsinformationen bereit:

    • Instanz-URL im Format https://<domain-name>.service-now.com/.
    • Client-ID und Clientschlüssel Informationen zur Endpunkteinrichtung und zum Abrufen der Client-ID und des Clientschlüssels finden Sie in der ServiceNow-Dokumentation unter Endpunkt für den Zugriff von Clients auf die Instanz erstellen.

    • Nutzername und Passwort für eine der folgenden ServiceNow-Rollentypen:

      • Administratorrolle Weitere Informationen finden Sie in der ServiceNow-Dokumentation unter Base system roles (Grundlegende Systemrollen).

      • Eine benutzerdefinierte ServiceNow-Rolle. Dies ist eine Alternative zur Verwendung einer Administratorrolle. Wenn Sie eine benutzerdefinierte ServiceNow-Rolle verwenden möchten, erstellen Sie Zugriffssteuerungsregeln mit den folgenden Feldern:

        Weitere Informationen finden Sie in der ServiceNow-Dokumentation unter Rolle erstellen und ACL-Regel erstellen.

Console

So synchronisieren Sie mit der Google Cloud Console Daten aus ServiceNow mit Vertex AI Search:

  1. Rufen Sie in der Google Cloud Console die Seite Agent Builder auf.

    Zum Agent Builder

  2. Klicken Sie im Navigationsmenü auf Datenspeicher.

  3. Klicken Sie auf Datenspeicher erstellen.

  4. Gehen Sie auf der Seite Datenquelle auswählen zum Abschnitt Drittanbieterquellen und wählen Sie ServiceNow aus.

  5. Geben Sie Ihre ServiceNow-Authentifizierungsinformationen ein.

  6. Wählen Sie die zu synchronisierenden Entitäten aus und klicken Sie auf Weiter.

  7. Wählen Sie eine Region für den Daten-Connector aus.

  8. Geben Sie einen Namen für den Daten-Connector ein.

  9. Wählen Sie eine Synchronisierungshäufigkeit aus.

  10. Klicken Sie auf Erstellen. Vertex AI Search erstellt Ihren Datenspeicher und zeigt ihn auf der Seite Datenspeicher an.

  11. Wenn Sie den Status der Datenaufnahme prüfen möchten, rufen Sie die Seite Datenspeicher auf und klicken Sie auf den Namen des Daten-Connectors. Auf der Seite Daten finden Sie dann weitere Informationen. Der Status des Connectors ändert sich von Erstellen zu Laufend, sobald die Datensynchronisierung beginnt. Wenn die Datenaufnahme abgeschlossen ist, ändert sich der Status in Aktiv. Das bedeutet, dass die Verbindung zu Ihrer Datenquelle eingerichtet ist und die nächste geplante Synchronisierung erwartet wird.

    Je nach Größe der Daten kann die Datenaufnahme einige Minuten oder Stunden dauern.

Nächste Schritte

SharePoint Online verbinden

So synchronisieren Sie Daten aus SharePoint Online mit der Vertex AI Search:

Nachdem Sie die Datenquelle eingerichtet und zum ersten Mal Daten importiert haben, werden die Daten aus dieser Quelle mit der Häufigkeit synchronisiert, die Sie bei der Einrichtung ausgewählt haben.

Bevor Sie die Verbindung einrichten:

  • Richten Sie die Zugriffssteuerung für Ihre Datenquelle ein. Informationen zum Einrichten der Zugriffssteuerung finden Sie unter Zugriffssteuerung für Datenquellen verwenden.

  • Geben Sie die Einwilligung des Administrators. Informationen zum Gewähren der Einwilligung finden Sie in der Microsoft-Dokumentation unter Mandatenweite Administratorzustimmung für eine Anwendung gewähren.

  • Bereiten Sie die folgenden Informationen zur SharePoint Online-Authentifizierung für die Einrichtung vor:

    • Instanz-URL. Im Formular http://DOMAIN_OR_SERVER/[sites/]WEBSITE. Weitere Informationen zu URLs finden Sie in der SharePoint-Dokumentation unter URLs und Tokens in SharePoint.

    • Mieter-ID, Client-ID und Clientschlüssel. Wählen Sie zum Registrieren der Anwendung für die Zielgruppe für die Anmeldung Nur Konten in diesem Organisationsverzeichnis aus und suchen Sie dann nach diesen Authentifizierungsinformationen. Weitere Informationen finden Sie in der Microsoft-Dokumentation unter Schnellstart: Anwendung bei der Microsoft-Identitätsplattform registrieren.

    • Verwenden Sie bei der Registrierung der Anwendung https://vertexaisearch.cloud.google.com/console/oauth/confluence_oauth.html als Webanfrage-URL.

    • Fügen Sie beim Konfigurieren von Anwendungsberechtigungen die folgenden Anwendungsberechtigungen für die Graph API hinzu:

    • Fügen Sie beim Konfigurieren der Anwendungsberechtigungen die folgenden delegierten Berechtigungen für die Sharepoint REST API hinzu:

  • In der folgenden Tabelle werden die für die Konfiguration empfohlenen Rollen und ihre Einschränkungen beschrieben.

Console

So synchronisieren Sie mit der Google Cloud Console Daten aus SharePoint Online mit Vertex AI Search:

  1. Rufen Sie in der Google Cloud Console die Seite Agent Builder auf.

    Zum Agent Builder

  2. Klicken Sie im Navigationsmenü auf Datenspeicher.

  3. Klicken Sie auf Datenspeicher erstellen.

  4. Gehen Sie auf der Seite Datenquelle auswählen zum Bereich Drittanbieterquellen und wählen Sie SharePoint Online aus.

  5. Geben Sie Ihre SharePoint Online-Authentifizierungsinformationen ein und klicken Sie auf Authentifizieren.

  6. Ein neues Fenster wird geöffnet. Geben Sie den Nutzernamen und das Passwort der Instanz ein. Prüfen Sie, ob die Authentifizierung erfolgreich war, bevor Sie zur Seite SharePoint Online-Quelle für Ihren Datenspeicher angeben zurückkehren.

  7. Wählen Sie die zu synchronisierenden Entitäten aus und klicken Sie auf Weiter.

  8. Wählen Sie eine Region für Ihren Datenspeicher aus.

  9. Geben Sie einen Namen für den Datenspeicher ein.

  10. Wählen Sie eine Synchronisierungshäufigkeit für den Datenspeicher aus.

  11. Klicken Sie auf Erstellen. Vertex AI Search erstellt Ihren Datenspeicher und zeigt ihn auf der Seite Datenspeicher an.

  12. Den Status der Datenaufnahme können Sie auf der Seite Datenspeicher prüfen. Klicken Sie dazu auf den Namen des Datenspeichers, um auf der Seite Daten Details dazu aufzurufen. Der Status des Connectors ändert sich von Erstellen zu Laufend, wenn die Datensynchronisierung beginnt. Wenn die Datenaufnahme abgeschlossen ist, ändert sich der Status in Aktiv. Das bedeutet, dass die Verbindung zu Ihrer Datenquelle eingerichtet ist und die nächste geplante Synchronisierung erwartet wird.

    Je nach Größe der Daten kann die Datenaufnahme einige Minuten oder Stunden dauern.

Nächste Schritte

Slack verbinden

So synchronisieren Sie Daten aus Slack mit Vertex AI Search:

Nachdem Sie die Datenquelle eingerichtet und zum ersten Mal Daten importiert haben, werden die Daten aus dieser Quelle mit der Häufigkeit synchronisiert, die Sie bei der Einrichtung ausgewählt haben.

Hinweise

Bevor Sie die Verbindung einrichten:

  • Richten Sie die Zugriffssteuerung für Ihre Datenquelle ein. Informationen zum Einrichten der Zugriffssteuerung finden Sie unter Zugriffssteuerung für Datenquellen verwenden.

  • Wenden Sie sich an den Workspace-Inhaber, um die Berechtigungen zum Installieren neuer Apps in Ihrem Arbeitsbereich zu erhalten.

  • Bereiten Sie die folgenden Informationen zur Slack-Authentifizierung vor:

    • Arbeitsbereichs-ID: Folgen Sie der Anleitung unter Slack-Quelle für Ihren Datenspeicher angeben in der Slack-Dokumentation, um die Arbeitsbereichs-ID abzurufen.
    • Zugriffstoken: Erstellen Sie eine Clientanwendung und definieren Sie die erforderlichen Bereiche. Weitere Informationen finden Sie in der Slack-Dokumentation unter Schnellstart und So rufen Sie schnell ein Slack API-Token ab und verwenden es.
    • Konfigurieren Sie beim Festlegen von OAuth 2.0-Berechtigungsbereichen die folgenden Bereiche:

  • Standardmäßig schränkt Slack das Crawling und die Synchronisierung von Inhalten aus privaten Channels, Gruppennachrichten und Direktnachrichten ein.

Slack-App konfigurieren

Holen Sie sich ein Zugriffstoken, damit Vertex AI Search Dokumente aus Ihrem Slack-Arbeitsbereich aufnehmen kann.

Bot-Token generieren

Erstellen Sie ein Bot-Token, um sicher auf private Kanäle, Instant Messages (IMs) und Multi-Party-Instant Messages (MPIMs) zuzugreifen. Das Bot-Token kann nicht in öffentliche Kanäle gecrawlt werden, zu denen es nicht gehört. Wenn es einem öffentlichen Kanal beitritt, wird eine entsprechende Nachricht generiert.

  1. Melden Sie sich in Slack API-Apps an.
  2. Klicken Sie auf Neue App erstellen.
  3. Wählen Sie Neu beginnen aus.
  4. Geben Sie einen Namen für die App ein und wählen Sie den Arbeitsbereich für die Integration aus.
  5. Klicken Sie auf Anwendung erstellen.
  6. Klicken Sie auf OAuth und Berechtigungen.

  7. Fügen Sie unter Bereiche für Bot-Token die folgenden erforderlichen Bereiche hinzu:

    Standardmäßig liest der Bot aus den Kanälen #general und #random. So aktivieren Sie das Crawling:

    • Gewähren Sie für öffentliche Kanäle den Zugriffsumfang channels:join, damit der Bot automatisch beitreten kann.
    • Bei privaten Kanälen müssen Sie den Bot manuell einladen.

  8. Klicken Sie auf Im Arbeitsbereich Ihres Nutzernamens installieren.

  9. Folgen Sie der Anleitung auf dem Bildschirm, um die App zu installieren und das Bot-Token abzurufen.

Nutzertoken generieren

Nutzertoken generieren, um auf alle öffentlichen Kanäle zuzugreifen, ohne ihnen zuerst beitreten zu müssen Das Nutzertoken kann keine privaten Kanäle, IMs oder MPIMs crawlen, es sei denn, der Nutzer hat Zugriff.

  1. Melden Sie sich in Slack API-Apps an.
  2. Klicken Sie auf Neue App erstellen.
  3. Wählen Sie Neu beginnen aus.
  4. Geben Sie einen Namen für die App ein und wählen Sie den Arbeitsbereich für die Integration aus.
  5. Klicken Sie auf Anwendung erstellen.
  6. Klicken Sie auf OAuth und Berechtigungen.

  7. Fügen Sie unter Umfang des Nutzertokens die folgenden erforderlichen Bereiche hinzu:

  8. Klicken Sie auf Im Arbeitsbereich Ihres Nutzernamens installieren.

  9. Folgen Sie der Anleitung auf dem Bildschirm, um die App zu installieren und das Nutzertoken abzurufen.

Slack Cloud-Connector erstellen

Console

So synchronisieren Sie mit der Google Cloud Console Daten aus Slack mit Vertex AI Search:

  1. Rufen Sie in der Google Cloud Console die Seite Agent Builder auf.

    Zum Agent Builder

  2. Klicken Sie im Navigationsmenü auf Datenspeicher.

  3. Klicken Sie auf Datenspeicher erstellen.

  4. Scrollen Sie auf der Seite Datenquelle auswählen nach unten oder suchen Sie nach Slack, um die Drittanbieterquelle zu verbinden.

  5. Geben Sie Ihre Slack-Authentifizierungsinformationen ein.

    • Instanz-ID (Arbeitsbereichs-ID): Sie finden diese in Ihrem Slack-Arbeitsbereich, indem Sie sich über einen Browser anmelden. Die Workspace-ID ist das Segment nach /client in der URL.
    • Auth-Token: Verwende das Token aus dem vorherigen Abschnitt.

  6. Wählen Sie die zu synchronisierenden Entitäten aus und klicken Sie auf Weiter.

  7. Wählen Sie eine Region für Ihren Datenspeicher aus.

  8. Geben Sie einen Namen für den Datenspeicher ein.

  9. Wählen Sie eine Synchronisierungshäufigkeit für den Datenspeicher aus.

  10. Klicken Sie auf Erstellen. Vertex AI Search erstellt Ihren Datenspeicher und zeigt ihn auf der Seite Datenspeicher an.

  11. Den Status der Datenaufnahme können Sie auf der Seite Datenspeicher prüfen. Klicken Sie dazu auf den Namen des Datenspeichers, um auf der Seite Daten Details dazu aufzurufen. Der Status des Connectors ändert sich von Erstellen zu Laufend, wenn die Datensynchronisierung beginnt. Wenn die Datenaufnahme abgeschlossen ist, ändert sich der Status in Aktiv. Das bedeutet, dass die Verbindung zu Ihrer Datenquelle eingerichtet ist und die nächste geplante Synchronisierung erwartet wird.

    Je nach Größe der Daten kann die Datenaufnahme einige Minuten oder Stunden dauern.

Nächste Schritte

Dropbox verbinden

So synchronisieren Sie Daten aus Dropbox mit Vertex AI Search:

Nachdem Sie die Datenquelle eingerichtet und zum ersten Mal Daten importiert haben, werden die Daten aus dieser Quelle mit der Häufigkeit synchronisiert, die Sie bei der Einrichtung ausgewählt haben.

Hinweise

Bevor Sie die Verbindung einrichten:

  • Richten Sie die Zugriffssteuerung für Ihre Datenquelle ein. Weitere Informationen finden Sie unter Zugriffssteuerung für Datenquellen verwenden.

  • Halten Sie die folgenden Informationen zur Dropbox-Authentifizierung bereit. Informationen zum Einrichten dieser Parameter finden Sie im OAuth-Leitfaden in der Dropbox-Dokumentation.

    • Client-ID
    • Clientschlüssel

Console

So synchronisieren Sie mit der Google Cloud Console Daten aus Dropbox mit Vertex AI Search:

  1. Rufen Sie in der Google Cloud Console die Seite Agent Builder auf.

    Zum Agent Builder

  2. Klicken Sie im Navigationsmenü auf Datenspeicher.

  3. Klicken Sie auf Datenspeicher erstellen.

  4. Gehen Sie auf der Seite Datenquelle auswählen zum Abschnitt Drittanbieterquellen und wählen Sie Dropbox aus.

  5. Geben Sie Ihre Dropbox-Authentifizierungsinformationen ein und klicken Sie auf Authentifizieren. Ein neues Fenster wird geöffnet.

  6. Authentifizieren Sie Ihr Konto und prüfen Sie, ob die Authentifizierung erfolgreich war, bevor Sie zur Seite Dropbox-Quelle für Ihren Datenspeicher angeben zurückkehren.

  7. Wählen Sie die zu synchronisierenden Entitäten aus und klicken Sie auf Weiter.

  8. Wählen Sie einen Speicherort für den Datenspeicher aus.

  9. Geben Sie einen Namen für den Datenspeicher ein.

  10. Wählen Sie eine Synchronisierungshäufigkeit für den Datenspeicher aus.

  11. Klicken Sie auf Erstellen. Vertex AI Search erstellt Ihren Datenspeicher und zeigt ihn auf der Seite Datenspeicher an.

  12. Den Status der Datenaufnahme können Sie auf der Seite Datenspeicher prüfen. Klicken Sie dazu auf den Namen des Datenspeichers, um auf der Seite Daten Details dazu aufzurufen. Der Status des Connectors ändert sich von Erstellen zu Laufend, wenn die Datensynchronisierung beginnt. Wenn die Datenaufnahme abgeschlossen ist, ändert sich der Status in Aktiv. Das bedeutet, dass die Verbindung zu Ihrer Datenquelle eingerichtet ist und auf die nächste geplante Synchronisierung wartet. Prüfen Sie auf dem Tab Dokumente, ob Ihre Entitäten korrekt aufgenommen wurden.

    Je nach Größe der Daten kann die Datenaufnahme Minuten oder Stunden dauern.

Nächste Schritte

Connect Box

So synchronisieren Sie Daten aus Box mit Vertex AI Search:

Nachdem Sie die Datenquelle eingerichtet und zum ersten Mal Daten importiert haben, werden die Daten aus dieser Quelle mit der Häufigkeit synchronisiert, die Sie bei der Einrichtung ausgewählt haben.

Hinweise

Bevor Sie die Verbindung einrichten:

  • Richten Sie die Zugriffssteuerung für Ihre Datenquelle ein. Informationen zum Einrichten der Zugriffssteuerung finden Sie unter Zugriffssteuerung für Datenquellen verwenden.

  • Halten Sie die folgenden Informationen zur Box-Authentifizierung bereit. Informationen zum Einrichten dieser Parameter finden Sie in der Box-Entwicklerdokumentation unter JWT Auth.

    • Unternehmens-ID
    • Client-ID
    • Clientschlüssel
    • ID des öffentlichen Schlüssels
    • Privater Schlüssel
    • Passphrase

  • Konfigurieren Sie beim Erstellen des JWT-Endpunkts die folgenden Bereiche:

Die Synchronisierung von inkrementellen Änderungen an Kommentaren kann länger dauern als das konfigurierte Häufigkeitsintervall. Wenn ein Ordner mit einem Element kopiert oder verschoben wird, kann die Synchronisierung inkrementeller Änderungen länger als das konfigurierte Häufigkeitsintervall dauern.

Box-App erstellen

  1. Melden Sie sich mit Ihrem Administratorkonto in der Box Developer Console an.
  2. Klicken Sie auf Neue App erstellen.
  3. Wählen Sie den Typ Benutzerdefinierte App aus.
  4. Geben Sie den App-Namen ein.
  5. Legen Sie den Zweck der App fest: Integration, KI oder Google Cloud Agent Builder.
  6. Wählen Sie Server Authentication with JWT (Serverauthentifizierung mit JWT) aus.

Box App konfigurieren

Konfigurieren Sie die Einstellungen für die Box App.

Öffentlichen/privaten Schlüssel erstellen

  1. Rufen Sie die Box Developer Console auf.

  2. Klicken Sie auf dem Tab Konfiguration auf Paar aus öffentlichem und privatem Schlüssel erstellen.

    • Der öffentliche Schlüssel wird automatisch mit einer ID in die Console hochgeladen. Diese ID wird beim Erstellen einer Verbindung verwendet.
    • Eine Konfigurationsdatei mit dem privaten Schlüssel und der Passphrase kann lokal heruntergeladen werden. Bewahren Sie diese Konfigurationsdatei für später auf.
    • Wenn Sie einen eigenen Schlüssel generieren möchten, lesen Sie den Leitfaden zur Einrichtung von Box-Schlüsselpaaren.

Erforderliche Berechtigungen konfigurieren

  1. Wählen Sie im Bereich Anwendungsbereich die folgende Berechtigung aus:
    • Alle in Box gespeicherten Dateien und Ordner lesen

App autorisieren

  1. Klicken Sie auf dem Tab Autorisierung auf Überprüfen und senden und warten Sie auf die Genehmigung Ihres Administrators.
  2. Administratoren können die App in der Admin-Konsole genehmigen.

Nach der Autorisierung richtet Box die App vollständig ein.

Box-Connector erstellen

Console

So synchronisieren Sie Daten über die Google Cloud Console von Box mit Vertex AI Search:

  1. Rufen Sie in der Google Cloud Console die Seite Agent Builder auf.

    Zum Agent Builder

  2. Klicken Sie im Navigationsmenü auf Datenspeicher.

  3. Klicken Sie auf Datenspeicher erstellen.

  4. Scrollen Sie auf der Seite Datenquelle auswählen nach unten oder suchen Sie nach Box, um eine Verbindung zu Ihrer Drittanbieterquelle herzustellen.

  5. Geben Sie Ihre Authentifizierungsinformationen ein.

  6. Wählen Sie die zu synchronisierenden Entitäten aus und klicken Sie auf Weiter.

  7. Wählen Sie eine Region für Ihren Datenspeicher aus.

  8. Geben Sie einen Namen für den Datenspeicher ein.

  9. Wählen Sie eine Synchronisierungshäufigkeit für den Datenspeicher aus.

  10. Klicken Sie auf Erstellen. Vertex AI Search erstellt Ihren Datenspeicher und zeigt ihn auf der Seite Datenspeicher an.

  11. Den Status der Datenaufnahme können Sie auf der Seite Datenspeicher prüfen. Klicken Sie dazu auf den Namen des Datenspeichers, um auf der Seite Daten Details dazu aufzurufen. Der Status des Connectors ändert sich von Erstellen zu Laufend, wenn die Datensynchronisierung beginnt. Wenn die Datenaufnahme abgeschlossen ist, ändert sich der Status in Aktiv. Das bedeutet, dass die Verbindung zu Ihrer Datenquelle eingerichtet ist und die nächste geplante Synchronisierung erwartet wird.

    Je nach Größe der Daten kann die Datenaufnahme einige Minuten oder Stunden dauern.

Nächste Schritte

OneDrive verbinden

So synchronisieren Sie Daten aus OneDrive mit Vertex AI Search:

Nachdem Sie die Datenquelle eingerichtet und zum ersten Mal Daten importiert haben, werden die Daten aus dieser Quelle mit der Häufigkeit synchronisiert, die Sie bei der Einrichtung ausgewählt haben.

Hinweise

Bevor Sie die Verbindung einrichten:

Console

So synchronisieren Sie mit der Google Cloud Console Daten aus OneDrive mit Vertex AI Search:

  1. Rufen Sie in der Google Cloud Console die Seite Agent Builder auf.

    Zum Agent Builder

  2. Klicken Sie im Navigationsmenü auf Datenspeicher.

  3. Klicken Sie auf Datenspeicher erstellen.

  4. Gehen Sie auf der Seite Datenquelle auswählen zum Abschnitt Drittanbieterquellen und wählen Sie OneDrive aus.

  5. Geben Sie Ihre OneDrive-Authentifizierungsinformationen ein.

  6. Wählen Sie die zu synchronisierenden Entitäten aus und klicken Sie auf Weiter.

  7. Wählen Sie eine Region für Ihren Datenspeicher aus.

  8. Geben Sie einen Namen für den Datenspeicher ein.

  9. Wählen Sie eine Synchronisierungshäufigkeit für den Datenspeicher aus.

  10. Klicken Sie auf Erstellen. Vertex AI Search erstellt Ihren Datenspeicher und zeigt ihn auf der Seite Datenspeicher an.

  11. Den Status der Datenaufnahme können Sie auf der Seite Datenspeicher prüfen. Klicken Sie dazu auf den Namen des Datenspeichers, um auf der Seite Daten Details dazu aufzurufen. Der Status des Connectors ändert sich von Erstellen zu Laufend, wenn die Datensynchronisierung beginnt. Wenn die Datenaufnahme abgeschlossen ist, ändert sich der Status in Aktiv. Das bedeutet, dass die Verbindung zu Ihrer Datenquelle eingerichtet ist und die nächste geplante Synchronisierung erwartet wird.

    Je nach Größe der Daten kann die Datenaufnahme einige Minuten oder Stunden dauern.

Nächste Schritte