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:

Adobe Experience Manager verbinden

So synchronisieren Sie Daten aus Adobe Experience Manager 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:

  1. Zusätzlich zur Zulassungsliste für Drittanbieter-Connectors muss Ihr Projekt für diesen Connector einer zusätzlichen Zulassungsliste hinzugefügt werden. Wenn Sie auf die Zulassungsliste gesetzt werden möchten, wenden Sie sich an Ihr Vertex AI Search-Kontoteam.

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

  3. Ein Adobe Experience Manager-Administrator muss Folgendes generieren oder abrufen, um Vertex AI Search zu integrieren:

    • Anmeldedaten für den Dienst Ihrer Adobe Experience Manager-Instanz
    • Instanz-URL Ihrer Adobe Experience Manager-Website

Adobe Experience Manager-Connector erstellen

Konsole

So synchronisieren Sie mit der Google Cloud Console Daten aus Adobe Experience Manager 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 Adobe Experience Manager, um die Drittanbieterquelle zu verbinden.

  5. Geben Sie Ihre Adobe Experience Manager-Authentifizierungsinformationen ein und klicken Sie auf Weiter.

  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 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. Den Status der Datenaufnahme können Sie auf der Seite Datenspeicher prüfen. Klicken Sie dazu auf den Namen des Connectors, 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.

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

Nächste Schritte

AODocs verbinden

So synchronisieren Sie Daten aus AODocs 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.

Hinweise

Bevor Sie die Verbindung einrichten:

  1. Zusätzlich zur Zulassungsliste für Drittanbieter-Connectors muss Ihr Projekt für diesen Connector einer zusätzlichen Zulassungsliste hinzugefügt werden. Wenn Sie auf die Zulassungsliste gesetzt werden möchten, wenden Sie sich an Ihr Vertex AI Search-Kontoteam.

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

  3. Ein AODocs-Administrator muss Folgendes generieren oder abrufen, um die Einbindung in Vertex AI Search vorzunehmen:

    • Instanz-ID (Domain-URL Ihrer AODocs-Instanz)
    • Client-ID
    • Clientschlüssel

AODocs-Connector erstellen

Konsole

So synchronisieren Sie mit der Google Cloud Console Daten aus AODocs 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 AODocs, um eine Verbindung zu Ihrer Drittanbieterquelle herzustellen.

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

  6. Authentifizieren Sie Ihr Konto und prüfen Sie, ob die Autorisierung erfolgreich war, bevor Sie zur Seite AODocs-Quelle für den 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 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 Connectors, 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.

    Je nach Größe der Daten kann die Datenaufnahme einige Minuten bis mehrere 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:

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

  2. 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

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

Die Synchronisierung inkrementeller Ä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

  1. Konfigurieren Sie die Einstellungen für Ihre Box App, indem Sie einen ö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.

  2. Erforderliche Berechtigungen konfigurieren: Wählen Sie im Bereich Anwendungsbereich die Option Alle in Box gespeicherten Dateien und Ordner lesen aus.

    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

Konsole

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 auf die nächste geplante Synchronisierung wartet.

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

Nächste Schritte

Coda verbinden

So synchronisieren Sie Daten aus Coda 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:

  1. Zusätzlich zur Zulassungsliste für Drittanbieter-Connectors muss Ihr Projekt für diesen Connector einer zusätzlichen Zulassungsliste hinzugefügt werden. Wenn Sie auf die Zulassungsliste gesetzt werden möchten, wenden Sie sich an Ihr Vertex AI Search-Kontoteam.

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

  3. Ein Coda-Administrator muss das Coda API-Token generieren oder abrufen, um es in Vertex AI Search einzubinden.

Coda-Connector erstellen

Konsole

So synchronisieren Sie mit der Google Cloud Console Daten aus Coda 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 Coda, um eine Verbindung zu Ihrer Drittanbieterquelle herzustellen.

  5. Geben Sie Ihre Coda-Authentifizierungsinformationen ein und klicken Sie auf Weiter.

  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 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. Den Status der Datenaufnahme können Sie auf der Seite Datenspeicher prüfen. Klicken Sie dazu auf den Namen des Connectors, 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.

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

Nächste Schritte

Confluence Cloud verbinden

So synchronisieren Sie Daten aus Confluence 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:

  1. Prüfen Sie, ob Sie Administratorzugriff auf die Confluence-Instanz und das Projekt haben.

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

Authentifizierung und Berechtigungen in Confluence einrichten

Sie benötigen die erforderlichen Authentifizierungsdetails und Administratorzugriff auf Ihre Confluence-Instanz. Folgen Sie der Anleitung unten, um über die Atlassian Developer Console eine Client-ID und einen Clientschlüssel zu erstellen, die erforderlichen OAuth 2.0-Bereiche zu konfigurieren, Berechtigungen für Nutzer einzurichten, die Instanz-URL und ‑ID abzurufen, Rollen zu konfigurieren und sich zu authentifizieren, um Daten zwischen Confluence Cloud und Vertex AI Search zu synchronisieren. Informationen zum Aktivieren von OAuth 2.0 und zum Abrufen der Client-ID und des geheimen Schlüssels finden Sie in der Atlassian Developer-Dokumentation unter OAuth 2.0-Anwendungen (3LO).

  1. So erstellen Sie eine OAuth 2.0-Integration in der Atlassian Developer Console:

    1. Melden Sie sich in der Atlassian Developer Console an.
    2. Klicken Sie auf das Profilsymbol und wählen Sie Atlassian Developer Console 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 und führen Sie die folgenden Schritte aus:
      1. Klicken Sie das Kästchen für die Nutzungsbedingungen an.
      2. Klicken Sie auf Erstellen.
      3. Klicken Sie auf Autorisierung.
      4. Wählen Sie in der Tabelle Autorisierungstyp für OAuth 2.0 (3LO) die Option Hinzufügen aus.
    5. Geben Sie im Feld Callback-URL die URL https://vertexaisearch.cloud.google.com/console/oauth/confluence_oauth.html ein.
    6. Klicken Sie auf Änderungen speichern.

    Wenn Sie die Warnung Ihre App enthält keine APIs. Fügen Sie Ihrer App APIs hinzu, fahren Sie mit Schritt 2 fort und führen Sie alle verbleibenden Schritte aus. Fahren Sie andernfalls mit Schritt 4 und Schritt 5 fort.

  2. OAuth 2.0 aktivieren:

    1. Klicken Sie auf Berechtigungen.
    2. Rufen Sie die Confluence API auf.
    3. Klicken Sie auf Hinzufügen.
    4. Klicken Sie auf Konfigurieren.
    5. Wechseln Sie zum Tab Detaillierte Zugriffsbereiche und klicken Sie auf Zugriffsbereiche bearbeiten.
    6. Wählen Sie die folgenden Bereiche aus.
    7. Prüfen Sie, ob sieben Bereiche ausgewählt sind, und speichern Sie die Änderungen.

  3. Client-ID und Clientschlüssel abrufen:

    1. Klicken Sie auf Distribution.
    2. Wählen Sie Bearbeiten aus.
    3. Wählen Sie Freigabe aus, um die Bearbeitung anderer Felder zu aktivieren.
    4. Füllen Sie die restlichen Felder aus.
    5. Wählen Sie Ja aus, wenn Sie Does your app store personal data? sehen.
    6. Wähle Einstellungen aus, um deine Client-ID und dein Client-Secret zu kopieren.

  4. 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. Sie wird in der Adressleiste als Subdomain angezeigt.

  5. 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 Dreistrich-Menü 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. Rufen Sie die Website Ihrer Atlassian-Domain auf und öffnen Sie die Confluence Cloud-Instanz.
  5. Rufen Sie IAM auf.

  6. Weisen Sie dem Confluence-Administrator die Rolle Discovery Engine zu. So kann der Confluence-Administrator den Connector wie unter Confluence Cloud-Connector erstellen beschrieben konfigurieren.

  7. So weisen Sie einem Nutzer die Administratorrolle zu:

    1. Erstellen Sie ein eigenes Nutzerkonto. Verwenden Sie dieses Konto für die Einrichtung des Datenspeichers.
    2. Weisen Sie dem neuen Nutzer die Rolle Administrator zu.

  8. Berechtigungen in Atlassian konfigurieren:

    1. Rufen Sie die Website Ihrer Atlassian-Domain auf und öffnen Sie die Confluence Cloud-Instanz. Alternativ können Sie auch direkt admin.atlassian.com aufrufen.

    2. Klicken Sie auf das Dreipunkt-Menü und wählen Sie die gewünschte Option aus.

    3. Optional: Wählen Sie auf der Landingpage die entsprechende Organisation aus, wenn Sie dazu aufgefordert werden.

  9. Gruppen erstellen und konfigurieren:

    1. Klicken Sie auf der Seite Administrator gegebenenfalls auf die Schaltfläche Nutzer verwalten und wählen Sie im Drop-down-Menü die Option Nutzer verwalten aus.
    2. Wählen Sie auf der Seite Nutzerverwaltung die Option Gruppen aus.
    3. Klicken Sie auf Gruppe erstellen und weisen Sie einen Namen zu. Verwenden Sie diese Gruppe, um dem Connector erforderliche Berechtigungen zuzuweisen.

  10. Fügen Sie der Gruppe Berechtigungen hinzu: Weisen Sie die Rolle Administrator für den Nutzerzugriff zu.

  11. Gruppenmitglieder zuweisen:

    1. Klicken Sie auf der Seite Gruppe auf Produkt hinzufügen und wählen Sie in der Drop-down-Liste die entsprechende Produktrolle aus.Wählen Sie in diesem Fall Administrator für den Nutzerzugriff aus.
    2. Klicken Sie auf Hinzufügen, um die Rollenzuweisung zu bestätigen.
    3. Klicken Sie auf Gruppenmitglieder hinzufügen, um Nutzerkonten oder Gruppenmitglieder hinzuzufügen. Der Connector muss sich im Namen dieser Nutzer authentifizieren, um Dokumente abzurufen.

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.

Confluence Cloud-Connector erstellen

Konsole

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 Datenspeicher erstellen.

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

  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 auf die nächste geplante Synchronisierung wartet.

    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:

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

  6. 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.

    1. Konfigurieren Sie die Netzwerkeinstellungen:

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

      2. 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.

    2. Passen Sie die Firewallregeln an:

      1. 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.

      2. Ausgangsregeln: Ausgehender Traffic wird standardmäßig zugelassen, sofern keine speziellen Regeln zum Ablehnen gelten.

  7. Weitere Hinweise: 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:

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

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

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

    4. Optional: Richten Sie einen Systemdiagnose-Test ein, um den Zustand des Back-Ends zu überwachen.

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

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

    7. 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:

  1. Melden Sie sich als Administrator an:

    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).

  2. So erstellen Sie einen neuen Nutzer:

    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.

  3. So weisen Sie einem Nutzer eine Gruppe zu:

    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 Gruppennamen ein, um die Gruppe 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.

  4. 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

Konsole

  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 Confluence-Rechenzentrum, um eine Verbindung zu Ihrer Drittanbieterquelle herzustellen.

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

  6. Wählen Sie in der Drop-down-Liste Zieltyp die Option Öffentlich oder Privat aus.

    1. Für den Zieltyp Öffentlich müssen Sie die Einrichtung für den Dienstanhang nicht erstellen. Stattdessen können Sie Ihre öffentliche URL im Feld „Domain-URL“ der Google Cloud Console verwenden.

    2. Geben Sie für den Zieltyp Privat alle erforderlichen Informationen ein:

      1. Beispiel mit der Domain-URL:
        • Dienstanhang: Geben Sie den Dienstanhang ein.
        • Optional: Basisdomainname: Geben Sie Ihre Basisdomain ein.
        • Domain-URL: Geben Sie die Domain-URL ein.
        • Optional: Zielport: Geben Sie den Zielport ein.
      2. Beispiel ohne Domain-URL:
        • Dienstanhang: Geben Sie den Dienstanhang ein.
        • Optional: Zielport: Geben Sie den Zielport ein.

  7. Klicken Sie auf Weiter.

  8. Optional: Erweiterte Optionen: Wählen Sie bei Bedarf die Proxy-Einstellungen und die SSL-Einstellungen aus und aktivieren Sie sie.

  9. Wählen Sie unter Zu synchronisierende Entitäten alle erforderlichen Entitäten aus und klicken Sie auf Weiter.

  10. Wählen Sie eine Region für den Daten-Connector aus und geben Sie einen Namen für den Daten-Connector ein.

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

Wenn Sie den Zieltyp Privat auswählen, sendet VAIS nach dem Einreichen der Details für den Connector eine Verbindungsanfrage an Ihren PSC. Rufen Sie Ihren Connector auf. Daraufhin wird eine Meldung angezeigt, in der Sie aufgefordert werden, eine projectId in der PSC auf die Zulassungsliste zu setzen. Der Connector bleibt im Status Fehler, bis Sie die Verbindung im PSC zulassen. Wenn Sie die Verbindungsanfrage akzeptieren, ändert sich der Status des Connectors bei der nächsten Synchronisierung in Aktiv. Wenn Sie Ihren PSC so konfigurieren, dass alle Verbindungen akzeptiert werden, wechselt der Connector nach dem Erstellen automatisch in den Status Aktiv.

Bei dem Zieltyp Öffentlich wechselt der Connector nach dem Senden automatisch in den Status Aktiv.

So prüfen Sie den Status des Datenspeichers und die Datenaufnahme:

  1. Rufen Sie den Connector in der Liste der Datenspeicher auf und beobachten Sie den Status, bis er zu Aktiv wechselt.
  2. Sobald der Status des Connectors zu Aktiv wechselt, klicken Sie auf die gewünschte Entität und prüfen Sie, ob alle ausgewählten Entitäten aufgenommen wurden. Der Status des Datenspeichers ändert sich von Erstellen zu Laufend, wenn die Synchronisierung beginnt, und zu Aktiv, sobald die Datenaufnahme abgeschlossen ist. Das bedeutet, dass der Datenspeicher eingerichtet ist. Je nach Größe der Daten kann die Datenaufnahme mehrere 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:

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

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

    • Client-ID
    • Clientschlüssel

Dropbox-Connector erstellen

Konsole

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. Scrollen Sie auf der Seite Datenquelle auswählen nach unten oder suchen Sie nach Dropbox, um eine Verbindung zu Ihrer Drittanbieterquelle herzustellen.

  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 einige Minuten oder Stunden dauern.

Nächste Schritte

Dynamics 365 verbinden

So synchronisieren Sie Daten aus Dynamics 365 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 einen Dynamics 365-Connector erstellen:

  1. Ein Dynamics 365-Administrator muss Folgendes generieren oder abrufen, um die Integration mit Vertex AI Search vorzunehmen:

    • Client-ID
    • Clientschlüssel
    • Azure-Mandanten
    • URL der Organisation

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

Dynamics 365-Connector erstellen

Konsole

So synchronisieren Sie mit der Google Cloud Console Daten aus Dynamics 365 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 Dynamics 365, um die Drittanbieterquelle zu verbinden.

  5. Geben Sie Ihre Dynamics 365-Authentifizierungsinformationen ein und klicken Sie auf Weiter.

  6. Geben Sie die URL Ihres Azure-Tenants und Ihrer Organisation ein und klicken Sie auf Weiter.

  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 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 Connectors, 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.

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

Nächste Schritte

GitHub verbinden

So synchronisieren Sie Daten aus GitHub 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:

  1. Zusätzlich zur Zulassungsliste für Drittanbieter-Connectors muss Ihr Projekt für diesen Connector einer zusätzlichen Zulassungsliste hinzugefügt werden. Wenn Sie auf die Zulassungsliste gesetzt werden möchten, wenden Sie sich an Ihr Vertex AI Search-Kontoteam.

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

  3. Ein GitHub-Administrator muss das persönliche Zugriffstoken der GitHub-Instanz abrufen, um die Integration mit Vertex AI Search vorzunehmen.

GitHub-Connector erstellen

Konsole

So synchronisieren Sie mit der Google Cloud Console Daten aus GitHub 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 GitHub, um eine Verbindung zu Ihrer Drittanbieterquelle herzustellen.

  5. Geben Sie Ihre GitHub-Authentifizierungsinformationen ein und klicken Sie auf Weiter.

  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 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. Den Status der Datenaufnahme können Sie auf der Seite Datenspeicher prüfen. Klicken Sie dazu auf den Namen des Connectors, 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.

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

Nächste Schritte

GitLab verbinden

So synchronisieren Sie Daten aus GitLab 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:

  1. Zusätzlich zur Zulassungsliste für Drittanbieter-Connectors muss Ihr Projekt für diesen Connector einer zusätzlichen Zulassungsliste hinzugefügt werden. Wenn Sie auf die Zulassungsliste gesetzt werden möchten, wenden Sie sich an Ihr Vertex AI Search-Kontoteam.

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

  3. Ein GitLab-Administrator muss das persönliche Zugriffstoken der GitLab-Instanz abrufen, um die Integration mit Vertex AI Search vorzunehmen.

GitLab-Connector erstellen

Konsole

So synchronisieren Sie mit der Google Cloud Console Daten aus GitLab 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 GitLab, um eine Verbindung zu Ihrer Drittanbieterquelle herzustellen.

  5. Geben Sie Ihre GitLab-Authentifizierungsinformationen ein und klicken Sie auf Weiter.

  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 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. Den Status der Datenaufnahme können Sie auf der Seite Datenspeicher prüfen. Klicken Sie dazu auf den Namen des Connectors, 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.

    Je nach Größe der Daten kann die Datenaufnahme einige Minuten bis mehrere 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:

  1. Prüfen Sie, ob Sie Administratorzugriff auf die Jira-Instanz und das Projekt haben.

  2. 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.

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

  4. Sie benötigen ein Atlassian-Konto, eine Jira-Instanz und ein Projekt.

Authentifizierung und Berechtigungen in Jira einrichten

Sie benötigen die erforderlichen Authentifizierungsdetails und Administratorzugriff auf Ihre Jira-Instanz. Folgen Sie der Anleitung unten, um über die Atlassian Developer Console eine Client-ID und einen Clientschlüssel zu erstellen, die erforderlichen OAuth 2.0-Bereiche zu konfigurieren, Berechtigungen für Nutzer einzurichten, die Instanz-URL und ‑ID abzurufen, Rollen zu konfigurieren und sich zu authentifizieren, um Daten zwischen Jira Cloud und Vertex AI Search zu synchronisieren. Informationen zum Aktivieren von OAuth 2.0 und zum Abrufen der Client-ID und des geheimen Schlüssels finden Sie in der Atlassian Developer-Dokumentation unter OAuth 2.0-Anwendungen (3LO).

  1. So erstellen Sie eine OAuth 2.0-Integration in der Atlassian Developer Console:

    1. Melden Sie sich in der Atlassian Developer Console an.
    2. Klicken Sie auf das Profilsymbol und wählen Sie Developer Console 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 und führen Sie die folgenden Schritte aus:

  2. Geben Sie im Feld Callback-URL die URL https://vertexaisearch.cloud.google.com/console/oauth/jira_oauth.html ein.

  3. Klicken Sie auf Änderungen speichern.

    Wenn Sie die Warnung Ihre App enthält keine APIs. Fügen Sie Ihrer App APIs hinzu, fahren Sie mit Schritt 2 fort und führen Sie alle verbleibenden Schritte aus. Fahren Sie andernfalls mit Schritt 4 und Schritt 5 fort.

  4. OAuth 2.0 aktivieren:

    1. Wählen Sie Berechtigungen aus:
    • Rufen Sie die Jira API auf.
    • Klicken Sie auf Hinzufügen.
    • Klicken Sie auf Konfigurieren.
    • Rufen Sie den Tab Klassische Berechtigungen auf und klicken Sie auf Berechtigungen bearbeiten. Wählen Sie die folgenden Bereiche aus:
    • Wechseln Sie zum Tab Detaillierte Zugriffsbereiche und klicken Sie auf Zugriffsbereiche bearbeiten. Wählen Sie die folgenden Bereiche aus:
    1. Prüfen Sie, ob acht Bereiche ausgewählt sind, und speichern Sie dann Ihre Änderungen.

  5. Client-ID und Clientschlüssel abrufen:

    1. Klicken Sie auf Distribution.

    2. Wählen Sie Bearbeiten aus und gehen Sie so vor:

      1. Wählen Sie Freigabe aus, um die Bearbeitung anderer Felder zu aktivieren.
      2. Füllen Sie die restlichen Felder aus.
      3. Wählen Sie Ja aus, wenn Sie Does your app store personal data? sehen.

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

  6. 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.

  7. 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 in 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 Produkt hinzufügen.
  6. Wählen Sie im Dialogfeld Produkte zur Gruppe hinzufügen als Produktrolle Administrator für Nutzerzugriff aus.
  7. Klicken Sie auf Hinzufügen.
  8. Klicken Sie auf der Seite Gruppen auf Gruppenmitglieder hinzufügen, um Nutzer oder Konten hinzuzufügen, die vom Connector authentifiziert werden.

Damit Nutzerberechtigungen richtig angewendet werden können, muss jeder Jira 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.

Jira Cloud-Connector erstellen

Konsole

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. Scrollen Sie auf der Seite Datenquelle auswählen nach Jira Cloud oder suchen Sie danach, um die Drittanbieterquelle zu verbinden.

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

  6. Geben Sie den Nutzernamen und das Passwort der Instanz ein.

  7. Prüfen Sie, ob die Authentifizierung erfolgreich war, bevor Sie zur Seite Jira-Quelle für Ihren Datenspeicher angeben zurückkehren.

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

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

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

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

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

  13. 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.

    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:

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

  6. 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.

    1. Konfigurieren Sie die Netzwerkeinstellungen:

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

      2. 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.

    2. Passen Sie die Firewallregeln an:

      1. 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.

      2. Ausgangsregeln: Ausgehender Traffic wird standardmäßig zugelassen, sofern keine speziellen Regeln zum Ablehnen gelten.

  7. Weitere Hinweise: 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:

    1. Verwenden Sie PSC, um Verbindungen von privaten Instanzen zu Google Cloudzu aktivieren.

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

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

    4. Optional: Richten Sie einen Systemdiagnose-Test ein, um den Zustand des Back-Ends zu überwachen.

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

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

    7. 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:

  1. Melden Sie sich als Administrator an:

    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).

  2. So erstellen Sie einen neuen Nutzer:

    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.

  3. So weisen Sie einem Nutzer eine Gruppe zu:

    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.

  4. 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:
      1. Projekte durchsuchen
      2. Projekte im Archiv durchsuchen
    8. Fügen Sie dieses Schema Projekten hinzu, in denen Nutzer der Gruppe Zugriff auf das Projekt, Probleme, Kommentare, Arbeitsprotokolle und Anhänge benötigen.

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

Konsole

  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 Jira-Rechenzentrum, um die Drittanbieterquelle zu verbinden.

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

  6. Wählen Sie in der Drop-down-Liste Zieltyp die Option Öffentlich oder Privat aus.

    1. Für den Zieltyp Öffentlich müssen Sie die Einrichtung für den Dienstanhang nicht erstellen. Stattdessen können Sie Ihre öffentliche URL im Feld „Domain-URL“ der Google Cloud Console verwenden.

    2. Geben Sie für den Zieltyp Privat alle erforderlichen Informationen ein:

      1. Beispiel mit der Domain-URL:
        • Dienstanhang: Geben Sie den Dienstanhang ein.
        • Optional: Basisdomainname: Geben Sie Ihre Basisdomain ein.
        • Domain-URL: Geben Sie die Domain-URL ein.
        • Optional: Zielport: Geben Sie den Zielport ein.
      2. Beispiel ohne Domain-URL:
        • Dienstanhang: Geben Sie den Dienstanhang ein.
        • Optional: Zielport: Geben Sie den Zielport ein.

  7. Klicken Sie auf Weiter.

  8. Optional: Erweiterte Optionen: Wählen Sie bei Bedarf die Proxy-Einstellungen und die SSL-Einstellungen aus und aktivieren Sie sie.

  9. Wählen Sie unter Zu synchronisierende Entitäten alle erforderlichen Entitäten aus und klicken Sie auf Weiter.

  10. Wählen Sie eine Region für den Daten-Connector aus und geben Sie einen Namen für den Daten-Connector ein.

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

Wenn Sie den Zieltyp Privat auswählen, sendet VAIS nach dem Einreichen der Details für den Connector eine Verbindungsanfrage an Ihren PSC. Rufen Sie Ihren Connector auf. Daraufhin wird eine Meldung angezeigt, in der Sie aufgefordert werden, eine projectId in der PSC auf die Zulassungsliste zu setzen. Der Connector bleibt im Status Fehler, bis Sie die Verbindung im PSC zulassen. Wenn Sie die Verbindungsanfrage akzeptieren, ändert sich der Status des Connectors bei der nächsten Synchronisierung in Aktiv. Wenn Sie Ihren PSC so konfigurieren, dass alle Verbindungen akzeptiert werden, wechselt der Connector nach dem Erstellen automatisch in den Status Aktiv.

Bei dem Zieltyp Öffentlich wechselt der Connector nach dem Senden automatisch in den Status Aktiv. So prüfen Sie den Status des Datenspeichers und die Datenaufnahme:

  1. Rufen Sie den Connector in der Liste der Datenspeicher auf und beobachten Sie den Status, bis er zu Aktiv wechselt.
  2. Sobald der Status des Connectors zu Aktiv wechselt, klicken Sie auf die gewünschte Entität und prüfen Sie, ob alle ausgewählten Entitäten aufgenommen wurden. Der Status des Datenspeichers ändert sich zu Beginn der Synchronisierung von Erstellen zu Wird ausgeführt und nach Abschluss der Datenaufnahme zu Aktiv. Dies bedeutet, dass der Datenspeicher eingerichtet ist. Je nach Größe der Daten kann die Datenaufnahme einige Stunden dauern.

Nächste Schritte

Microsoft Outlook verbinden

So synchronisieren Sie Daten aus Microsoft Outlook 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:

  1. Zusätzlich zur Zulassungsliste für Drittanbieter-Connectors muss Ihr Projekt für diesen Connector einer zusätzlichen Zulassungsliste hinzugefügt werden. Wenn Sie auf die Zulassungsliste gesetzt werden möchten, wenden Sie sich an Ihr Vertex AI Search-Kontoteam.

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

  3. Ein Microsoft Outlook-Administrator muss Folgendes generieren oder abrufen, um die Einbindung in Vertex AI Search vorzunehmen:

    • Client-ID
    • Clientschlüssel
    • Mandanten-ID

Microsoft Outlook-Connector erstellen

Konsole

So synchronisieren Sie mit der Google Cloud Console Daten aus Microsoft Outlook 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 Microsoft Outlook, um eine Verbindung zu Ihrer Drittanbieterquelle herzustellen.

  5. Geben Sie Ihre Microsoft Outlook-Authentifizierungsinformationen ein und klicken Sie auf Weiter.

  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 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. Den Status der Datenaufnahme können Sie auf der Seite Datenspeicher prüfen. Klicken Sie dazu auf den Namen des Connectors, 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.

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

Nächste Schritte

Microsoft Teams verbinden

So synchronisieren Sie Daten aus Microsoft Teams 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.

Hinweise

Bevor Sie die Verbindung einrichten:

  1. Zusätzlich zur Zulassungsliste für Drittanbieter-Connectors muss Ihr Projekt für diesen Connector einer zusätzlichen Zulassungsliste hinzugefügt werden. Wenn Sie auf die Zulassungsliste gesetzt werden möchten, wenden Sie sich an Ihr Vertex AI Search-Kontoteam.

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

  3. Ein Microsoft Teams-Administrator muss Folgendes generieren oder abrufen, um die Einbindung in Vertex AI Search vorzunehmen:

    • Client-ID
    • Clientschlüssel
    • Mandanten-ID

Microsoft Teams-Connector erstellen

Konsole

So synchronisieren Sie mit der Google Cloud Console Daten aus Microsoft Teams 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 Microsoft Teams, um eine Verbindung zu Ihrer Drittanbieterquelle herzustellen.

  5. Geben Sie Ihre Microsoft Teams-Authentifizierungsinformationen ein und klicken Sie auf Weiter.

  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 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. Den Status der Datenaufnahme können Sie auf der Seite Datenspeicher prüfen. Klicken Sie dazu auf den Namen des Connectors, 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.

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

Nächste Schritte

Notion verbinden

So synchronisieren Sie Daten aus Notion 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.

Hinweise

Bevor Sie den Connector einrichten:

  1. Zusätzlich zur Zulassungsliste für Drittanbieter-Connectors muss Ihr Projekt für diesen Connector einer zusätzlichen Zulassungsliste hinzugefügt werden. Wenn Sie auf die Zulassungsliste gesetzt werden möchten, wenden Sie sich an Ihr Vertex AI Search-Kontoteam.

  2. Ein Notion-Administrator muss Folgendes generieren oder abrufen, um die Integration mit Vertex AI Search vorzunehmen:

    • API-Token der Notion-Instanz
    • Arbeitsbereich-ID

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

Notion-Connector erstellen

Konsole

So synchronisieren Sie Daten mit der Google Cloud Console von Notion 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 Notion, um eine Verbindung zu Ihrer Drittanbieterquelle herzustellen.

  5. Geben Sie Ihre Notion-Authentifizierungsinformationen ein und klicken Sie auf Weiter.

  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 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. Den Status der Datenaufnahme können Sie auf der Seite Datenspeicher prüfen. Klicken Sie dazu auf den Namen des Connectors, 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.

    Je nach Größe der Daten kann die Datenaufnahme einige Minuten bis mehrere 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:

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

  2. Halten Sie die folgenden Informationen zur OneDrive-Authentifizierung bereit:

    1. Client-ID, Clientschlüssel und Mandanten-ID. Informationen zum Einrichten dieser Parameter finden Sie in der Microsoft-Dokumentation unter Kurzanleitung: Anwendung bei der Microsoft Identity Platform registrieren.

    2. Geben Sie Zugriffsbereiche an. Eine Administratorrolle ist erforderlich. Weitere Informationen finden Sie in der Microsoft-Dokumentation unter Kurzanleitung: Clientanwendung für den Zugriff auf eine Web-API konfigurieren.

    3. Konfigurieren Sie die folgenden Zugriffsbereiche:

OneDrive-Connector erstellen

Konsole

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. Scrollen Sie auf der Seite Datenquelle auswählen nach unten oder suchen Sie nach OneDrive, um die Drittanbieterquelle zu verbinden.

  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 auf die nächste geplante Synchronisierung wartet.

    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:

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

  2. 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
    • Verbraucher-ID
    • Consumer-Secret

Es gelten folgende Einschränkungen:

  1. Sie haben ein Enterprise- oder Entwicklerabo. Testkonten werden nicht unterstützt.
  2. Sie müssen Sales Cloud verwenden. Service Cloud wird nicht unterstützt.
  3. Fügen Sie Google Cloud der CORS-Zulassungsliste von Salesforce hinzu. Fahren Sie mit dem nächsten Schritt fort, wenn Sie diese Aufgabe bereits erledigt haben.
    1. Folgen Sie der Anleitung in der Salesforce-Dokumentation, um die CORS-Zulassungsliste zu konfigurieren.
    2. Geben Sie https://console.cloud.google.com/ als Ursprungs-URL ein und speichern Sie die Konfiguration.

Salesforce-Connector erstellen

Konsole

So synchronisieren Sie mit der Google Cloud Console Daten aus Salesforce 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 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 auf die nächste geplante Synchronisierung wartet.

    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.

Hinweise

Bevor Sie die Verbindung einrichten, müssen Sie Folgendes haben:

  1. ServiceNow-Instanz: Erstellen Sie eine ServiceNow-Instanz. Folgen Sie dazu der Anleitung in der ServiceNow Developer-Dokumentation.

  2. Google Cloud -Projekt: Richten Sie ein Google Cloud -Projekt mit einem Administratorkonto ein, mit dem Konfigurationen auf Organisationsebene verwaltet werden können, damit die Organisation einen Personalpool einrichten kann.

  3. Personalpool: Ihre Organisation muss für die Verwaltung eines Personalpools eingerichtet sein.

ServiceNow einrichten

ServiceNow bietet zwei Hauptwebsites:

  1. Haupt-ServiceNow-Website: Die Website Ihrer ServiceNow-Instanz.

    • Verwaltet Nutzer, Gruppen und Aufgaben der Systemadministration.
    • URL: Die URL Ihrer ServiceNow-Instanz.
    • Melden Sie sich mit Ihren Administratoranmeldedaten an.

  2. Entwicklerwebsite:

    • Konfiguriert die Wissensdatenbank, richtet Workflows ein und entwickelt benutzerdefinierte Anwendungen.
    • URL: https://developer.service-now.com.
    • Melden Sie sich mit Ihrer ServiceNow-ID an.

So erstellen Sie einen OAuth-Endpunkt:

  1. Melden Sie sich mit Administratorberechtigungen in der Hauptinstanz von ServiceNow an.
  2. Gehen Sie zu Alle > System-OAuth > Anwendungsregistrierung.
  3. Klicken Sie auf Neu und wählen Sie OAuth API-Endpunkt für externe Clients erstellen aus. Rufen Sie die Client-ID und den Clientschlüssel ab.

  4. Geben Sie die erforderlichen Informationen ein:

    1. Name: Eindeutiger Name.
    2. Weiterleitungs-URL: https://vertexaisearch.cloud.google.com/console/oauth/servicenow_oauth.html.

  5. Klicken Sie auf Senden, um die Anmeldedaten zu erstellen.

  6. Klicken Sie nach dem Senden auf den Namen, um das Client-Secret aufzurufen.

  7. Das Secret ist maskiert. Klicken Sie auf das Schlosssymbol daneben, um das Secret zu entschlüsseln und aufzurufen.

  8. Bewahren Sie eine Kopie der Client-ID und des Clientschlüssels auf, um sie bei Bedarf zu verwenden.

  9. Klicken Sie auf developer.service-now.com und dann auf Instanzpasswort verwalten.

  10. Bewahren Sie eine Kopie des Nutzernamens und des Passworts auf, um sie bei Bedarf zu verwenden.

  11. In dieser Phase sind alle fünf Informationen verfügbar, die zum Einrichten eines ServiceNow-Datenspeichers erforderlich sind. Wenn Sie keine Bedenken haben, die Rolle „Administrator“ zum Abrufen von Daten zu verwenden, fahren Sie mit dem Erstellen eines Datenspeichers fort.

Rollen und Berechtigungen einrichten

Sie benötigen die Rolle „Sicherheitsadministrator“, um Nutzer zu erstellen und zu verwalten. Wenn Sie diese Rolle nicht haben, klicken Sie unter Ihrem Profil auf Rolle steigern, um die Rolle auf security_admin zu erhöhen. Wählen Sie die Rolle security_admin aus und klicken Sie auf Aktualisieren. Die Rolle security_admin ist erforderlich, um Rollen zu erstellen und Nutzer zu verwalten.

  1. Benutzerdefinierte Rolle mit ACL-Regeln erstellen:

    1. Klicken Sie auf Alle > Nutzerverwaltung > Rollen.
    2. Klicken Sie auf Neu, um eine neue Rolle zu erstellen.
    3. Wählen Sie einen Namen aus und klicken Sie auf Senden.
    4. Gehen Sie zu Systemsicherheit > Zugriffssteuerung (ACL), um eine neue ACL-Regel zu erstellen.
    5. Klicken Sie auf Neu, um eine neue ACL-Regel zu erstellen.
    6. Wählen Sie eine Rolle aus, z. B. sys_user_role.
    7. Klicken Sie auf Senden und weisen Sie die Rolle zu.

    8. Wiederholen Sie diesen Vorgang, bis der Zugriff auf alle Tabellen gewährt wurde. Der Connector benötigt Zugriff auf die folgenden Tabellen, damit jede Entität ausgeführt werden kann:

      1. Vorfall: incident.
      2. Katalogelement: sc_cat_item, sc_cat_item_user_criteria_mtom, sc_cat_item_user_criteria_no_mtom, sc_cat_item_user_mtom, sc_cat_item_user_no_mtom
      3. Wissen: kb_knowledge, kb_knowledge_base, kb_uc_can_read_mtom, kb_uc_can_contribute_mtom.
      4. Anhang: Alle aufgeführten Elemente.
      5. Identität: sys_user_role, sys_user_has_role, sys_user_group, sys_user_grmember, sys_user.
      6. Aktualisiert, wenn neue Kriterien abgerufen werden: core_company, cmn_location, cmn_department.
      7. Nutzerkriterien: user_criteria.

    9. Prüfen Sie, ob alle ACLs aktualisiert wurden, indem Sie in der Suchleiste sys_security_acl_role_list.do eingeben.

    10. Wählen Sie die Rolle aus, die Sie bestätigen möchten.

    11. Prüfen Sie, ob der ausgewählten Rolle alle erforderlichen ACLs zugewiesen sind.

  2. Weisen Sie die Rolle einem Dienstkonto zu:

    1. Klicken Sie auf Alle > Nutzerverwaltung > Nutzer und wählen Sie den Nutzer aus.
    2. Suchen Sie den Nutzer, dem Sie die Rolle zuweisen möchten, und wählen Sie ihn aus.

  3. Wenn kein Nutzer verfügbar ist, rufen Sie Systemsicherheit > Nutzer und Gruppen > Nutzer auf.

  4. Klicken Sie auf Neu, um in der Tabelle Nutzer ein neues Dienstkonto zu erstellen.

  5. Setzen Sie ein Häkchen bei Nur Webdienstzugriff.

  6. Gehen Sie unten auf der Seite zur Tabelle Rollen.

  7. Klicken Sie rechts auf Bearbeiten.

  8. Gewähren Sie die zuvor erstellte Rolle und weisen Sie sie dem Nutzer zu. Wählen Sie je nach Art der erstellten Rolle die entsprechende Rolle aus und weisen Sie sie zu.

  9. Ermitteln Sie den Nutzernamen und das Passwort für den Nutzer. Klicken Sie auf derselben Seite auf Passwort festlegen.

  10. Passwort automatisch generieren und für später speichern:

    1. Nutzer-ID: manager.
    2. Passwort: Geben Sie das automatisch generierte Passwort ein.

Personalpool konfigurieren

Folgen Sie der Anleitung, um einen Workforce-Pool mit einer der folgenden Konfigurationen einzurichten:

  1. OIDC-Einrichtung in Azure
  2. Azure SAML-Einrichtung
  3. Okta- und OIDC-Einrichtung
  4. Okta und SAML-Einrichtung

ServiceNow-Connector erstellen

Konsole

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. Scrollen Sie auf der Seite Datenquelle auswählen nach unten oder suchen Sie nach ServiceNow, um die Drittanbieterquelle zu verbinden.

  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. Den Status der Datenaufnahme können Sie auf der Seite Datenspeicher prüfen. Klicken Sie dazu auf den Namen des Daten-Connectors, 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 auf die nächste geplante Synchronisierung wartet.

    Je nach Größe der Daten kann die Datenaufnahme einige Minuten bis mehrere 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.

Hinweise

Bevor Sie die Verbindung einrichten:

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

  2. Administratorzugriff gewähren Informationen zum Gewähren der Einwilligung finden Sie in der Microsoft Entra-Dokumentation unter Mandantenweite Administratoreinwilligung für eine Anwendung gewähren.

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

    1. Instanz-URL. Im Formular http://DOMAIN_OR_SERVER/[sites/]WEBSITE.

    2. Für die föderierte Authentifizierung sind die Tenant-ID und die Client-ID erforderlich, während für OAuth die Tenant-ID, die Client-ID und das Client-Secret erforderlich sind. Wenn Sie die Anwendung registrieren möchten, wählen Sie 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 Entra-Dokumentation unter Schnellstart: Anwendung bei der Microsoft-Identitätsplattform registrieren.

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

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

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

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

Mit dieser Methode können Sie die SharePoint REST API-Berechtigungen detailliert steuern und den Ressourcenzugriff für das Nutzerkonto einschränken. Sie müssen einen neuen SharePoint-Nutzer erstellen, was zusätzliche Lizenzkosten verursachen kann. Verwenden Sie die Methode OAuth 2.0-Aktualisierungstoken, um eine Entra-Anwendungsregistrierung einzurichten und sicheren Zugriff auf SharePoint zu ermöglichen.

Entra-Anwendungsregistrierung konfigurieren

Richten Sie eine Entra-Anwendungsregistrierung ein, um einen sicheren Zugriff auf SharePoint zu ermöglichen. Wählen Sie zwischen föderierten Anmeldedaten für den tokenbasierten Zugriff oder OAuth 2.0-Aktualisierungstoken für eine detailliertere Kontrolle. Führen Sie die folgenden Schritte aus, um die App-Registrierung zu konfigurieren, Berechtigungen zu gewähren und die Authentifizierung einzurichten.

  1. Verbundene Anmeldedaten: Sie können verbundene Anmeldedaten einrichten, um Google mithilfe kryptografisch signierter Tokens sicher auf SharePoint zugreifen zu lassen. Dadurch ist kein echter Nutzereinteiler erforderlich. So konfigurieren Sie Berechtigungen und gewähren Zugriff:

    1. Client-ID des Dienstkontos abrufen:

      1. Rufen Sie in der Google Cloud Console die Seite Agent Builder auf.
      2. Klicken Sie im Navigationsmenü auf Datenspeicher.
      3. Klicken Sie auf Datenspeicher erstellen.
      4. Scrollen Sie auf der Seite Datenquelle auswählen nach SharePoint Online oder suchen Sie danach, um eine Verbindung zu Ihrer Drittanbieterquelle herzustellen.
      5. Notieren Sie sich die Subjekt-ID.

    2. So registrieren Sie die App in Microsoft Entra:

      1. Rufen Sie die Entra-Admin-Konsole auf.

      2. So erstellen Sie eine App-Registrierung:

        • Unterstützte Kontotypen: Nur Konten im Organisationsverzeichnis
        • Lassen Sie die anderen Einstellungen unverändert und klicken Sie auf Registrieren.

      3. Notieren Sie sich die Client-ID und die Mandanten-ID.

    3. Fügen Sie föderierte Anmeldedaten hinzu:

      1. Gehen Sie zu Zertifikate und Secrets > Föderierte Anmeldedaten > Anmeldedaten hinzufügen.

      2. Verwenden Sie die folgenden Einstellungen:

        • Aussteller: https://accounts.google.com
        • Subjekt-ID: Verwenden Sie die angegebene Subjekt-ID.
        • Name: Geben Sie einen eindeutigen Namen an.

      3. Klicken Sie auf Hinzufügen, um Zugriff zu gewähren.

    4. API-Berechtigungen festlegen:

      1. Fügen Sie die folgenden Berechtigungen hinzu und erteilen Sie die Administratorzustimmung:

        • GroupMember.Read.All (Anwendung): Alle Gruppenmitgliedschaften lesen.
        • Sites.Read.All (Anwendung): Lesezugriff auf alle Websites.
        • User.Read.All (Anwendung): Vollständige Profile aller Nutzer lesen.
        • Sites.FullControl.All (Anwendung): Vollständige Kontrolle über alle Websites.

      2. Verwenden Sie Sites.Selected, um spezifische Websiteberechtigungen zuzuweisen, anstelle von Sites.FullControl.All. Sites.Selected kann nicht direkt über die Benutzeroberfläche konfiguriert werden. Nachdem Sie Sites.Selected ausgewählt haben, müssen Sie die Microsoft Graph API aufrufen, um der Anwendung die Rolle „FullControl“ für die Websites zu gewähren, die Sie crawlen möchten.

      3. Gewähren Sie Sites.Read.All Zugriff zum Crawling aller Unterwebsites unter einer Stammwebsite-URL.

  2. OAuth 2.0-Aktualisierungstoken: Konfigurieren Sie die OAuth 2.0-Authentifizierung mit einem Clientsecret und einem Aktualisierungstoken des SharePoint-Nutzers, um eine detaillierte Zugriffssteuerung für die SharePoint API zu ermöglichen. So richten Sie die App-Registrierung ein, fügen einen Clientschlüssel hinzu und weisen API-Berechtigungen zu:

    1. So erstellen Sie eine App-Registrierung:

      1. Rufen Sie die Entra-Admin-Konsole auf.

      2. So erstellen Sie eine App-Registrierung:

        • Unterstützte Kontotypen: Nur Konten im Organisationsverzeichnis
        • Weiterleitungs-URI: https://vertexaisearch.cloud.google.com/console/oauth/sharepoint_oauth.html.

      3. Notieren Sie sich die Client-ID und die Mandanten-ID.

    2. Clientschlüssel hinzufügen:

      1. Gehen Sie zu Zertifikate und Secrets > Neuer geheimer Clientschlüssel.

      2. Notieren Sie sich den Secret-String.

    3. API-Berechtigungen festlegen:

      1. Fügen Sie die folgenden Berechtigungen hinzu und erteilen Sie die Administratorzustimmung:

        • GroupMember.Read.All: Alle Gruppenmitgliedschaften lesen
        • Sites.FullControl.All: Vollständige Kontrolle über alle Websitesammlungen.
        • User.Read.All: Die vollständigen Profile aller Nutzer lesen.
        • AllSites.FullControl: Vollständige Kontrolle über alle Websites.

      2. Verwenden Sie ein eigenes Nutzerkonto mit eingeschränktem Zugriff auf bestimmte Websites.

      3. Das Konto muss Inhaberzugriff auf die ausgewählten Websites haben.

SharePoint Online-Connector erstellen

Konsole

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. Scrollen Sie auf der Seite Datenquelle auswählen nach SharePoint Online oder suchen Sie danach, um eine Verbindung zu Ihrer Drittanbieterquelle herzustellen.

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

  6. Geben Sie die URL der SharePoint-Website ein:

    • Für eine einzelne Website: https://<domain_name>.sharepoint.com/sites/<site_name>.
    • Für alle Websites der ersten Ebene: https://<domain_name>.sharepoint.com.

  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 auf die nächste geplante Synchronisierung wartet.

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

Suchmaschine testen

Testen Sie nach der Konfiguration die Funktionen Ihrer Suchmaschine. So werden genaue Ergebnisse basierend auf dem Nutzerzugriff zurückgegeben.

  1. Webanwendung aktivieren:

    1. Rufen Sie die Konfigurationen für die App-Integration auf und aktivieren Sie Webanwendung aktivieren.

  2. Webanwendung testen:

    1. Klicken Sie neben dem Link zur Webanwendung auf Öffnen und melden Sie sich mit einem Nutzer in Ihrem Mitarbeiterpool an.

    2. Prüfen Sie, ob die Suchergebnisse auf Elemente beschränkt sind, auf die der angemeldete Nutzer zugreifen kann.

Personalpool konfigurieren

Mit dem Personalpool können Sie Nutzer von externen Identitätsanbietern wie Azure oder Okta in der Google Cloud Console verwalten und authentifizieren. So konfigurieren Sie Ihren Workforce-Pool und aktivieren die Webanwendung für einen nahtlosen Nutzerzugriff:

  1. Erstellen Sie einen Personalpool auf Organisationsebene in Google Cloud . Folgen Sie dazu der entsprechenden Einrichtungsanleitung:

    1. OIDC-Einrichtung in Azure
    2. Azure SAML-Einrichtung
    3. Okta- und OIDC-Einrichtung
    4. Okta und SAML-Einrichtung

  2. Konfigurieren Sie den Personalpool in Agent Builder > Einstellungen für die Region, in der Sie Ihre App erstellen.

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:

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

  2. Wenden Sie sich an den Eigentümer des Arbeitsbereichs, um die Berechtigungen zum Installieren neuer Apps in Ihrem Arbeitsbereich zu erhalten.

  3. Bereiten Sie die folgenden Informationen zur Slack-Authentifizierung vor:

    1. Arbeitsbereichs-ID: Folgen Sie der Anleitung unter Slack-Quelle für Ihren Datenspeicher angeben in der Slack-Dokumentation, um die Arbeitsbereichs-ID abzurufen.

    2. 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.

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

  4. 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.

  1. Erstelle 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.

    1. So aktivieren Sie das Crawling:

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

    2. Klicken Sie auf Im Arbeitsbereich Ihres Nutzernamens installieren.

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

  2. 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

Konsole

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 auf die nächste geplante Synchronisierung wartet.

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

Nächste Schritte

Trello verbinden

So synchronisieren Sie Daten aus Trello 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 den Connector einrichten, müssen Sie die folgenden Schritte ausführen:

  1. Prüfen Sie, ob Sie Administratorzugriff auf Trello haben. Ein Trello-Administrator muss im folgenden Abschnitt einen API-Schlüssel und ein Token generieren.
  2. Prüfen Sie, ob Ihr Projekt der Zulassungsliste hinzugefügt wurde, damit Sie Trello verwenden können.
  3. Richten Sie die Zugriffssteuerung für Ihre Datenquelle ein. Informationen zum Einrichten der Zugriffssteuerung finden Sie unter Zugriffssteuerung für Datenquellen verwenden.

API-Schlüssel und -Token in Trello generieren

Ein Trello-Administrator muss die folgenden Schritte ausführen:

  1. Erstellen Sie ein Trello-Power-Up zum Generieren eines API-Schlüssels.
  2. Rufen Sie die Trello-Seite „Verwaltung“ auf.
  3. Rufen Sie den Tab „API-Schlüssel“ auf und wählen Sie die Option zum Generieren eines neuen API-Schlüssels aus.
  4. Klicken Sie auf Token.
  5. Klicken Sie auf Zulassen.
  6. Kopieren Sie das Token.

Weitere Informationen zur Trello API finden Sie unter Einführung in die API.

Trello-Connector erstellen

Konsole

So synchronisieren Sie mit der Google Cloud Console Daten aus Trello 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 Trello, um die Drittanbieterquelle zu verbinden.

  5. Geben Sie Ihre Trello-Authentifizierungsinformationen ein und klicken Sie auf Weiter.

  6. Optional: Wenn Sie HTTP-Traffic weiterleiten möchten, klicken Sie auf Ziel hinzufügen und geben Sie den Hostnamen oder die IP-Adresse des Proxyservers ein. Klicken Sie dann auf Weiter.

  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 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 Connectors, 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.

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

Nächste Schritte

Workday verknüpfen

So synchronisieren Sie Daten aus Workday 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 einen Workday-Connector erstellen, müssen Sie Folgendes tun:

  1. Zusätzlich zur Zulassungsliste für Drittanbieter-Connectors muss Ihr Projekt für diesen Connector einer zusätzlichen Zulassungsliste hinzugefügt werden. Wenn Sie auf die Zulassungsliste gesetzt werden möchten, wenden Sie sich an Ihr Vertex AI Search-Kontoteam.

  2. Ein Workday-Administrator muss Folgendes generieren oder abrufen, um die Einbindung in Vertex AI Search vorzunehmen:

    1. Client-ID. Sie können sie auf der Seite „API-Clients ansehen“ in Workday abrufen.
    2. Clientschlüssel Sie können sie auf der Seite „API-Clients ansehen“ in Workday abrufen.
    3. Aktualisierungstoken. Sie können sie auf der Seite „API-Clients ansehen“ in Workday abrufen.
    4. Optional: Proxyserver. Der Hostname oder die IP-Adresse eines Proxys, über den HTTP-Traffic weitergeleitet werden soll.
    5. Optional: Basis-URL. Die Basis-URL für die Workday-Verbindung.
    6. Optional: API-URL. Die vollständige URL zum API-Endpunkt, der für SOAP-Anfragen verwendet werden soll. Beispiel: https://<var>host</var>.workday.com/ccx/service/<var>tenant</var>/<var>service</var>
    7. Workday-Mandanten Der Mandant für das Konto. Beispiel: abc_cms1. Sie finden den Namen des Tenants in den Konfigurationsdetails Ihrer Workday-Instanz.

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

Workday-Connector erstellen

Konsole

So synchronisieren Sie mit der Google Cloud Console Daten aus Workday 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 Workday, um eine Verbindung zu Ihrer Drittanbieterquelle herzustellen.

  5. Geben Sie Ihre Workday-Anmeldedaten ein und klicken Sie auf Weiter.

  6. Optional: Geben Sie Ihre Workday-Zielinformationen ein und klicken Sie auf Weiter.

  7. Geben Sie Ihren Workday-Tenant ein und klicken Sie auf Weiter.

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

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

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

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

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

  13. Den Status der Datenaufnahme können Sie auf der Seite Datenspeicher prüfen. Klicken Sie dazu auf den Namen des Connectors, 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.

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

Nächste Schritte

Zendesk verknüpfen

So synchronisieren Sie Daten aus Zendesk 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:

  1. Zusätzlich zur Zulassungsliste für Drittanbieter-Connectors muss Ihr Projekt für diesen Connector einer zusätzlichen Zulassungsliste hinzugefügt werden. Wenn Sie auf die Zulassungsliste gesetzt werden möchten, wenden Sie sich an Ihr Vertex AI Search-Kontoteam.

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

  3. Ein Zendesk-Administrator muss Folgendes generieren oder abrufen, um Vertex AI Search zu integrieren:

    1. Zugriffstoken API-Token Ihrer Zendesk-Instanz.
    2. Instanz-URI.

Zendesk-Connector erstellen

Konsole

So synchronisieren Sie mit der Google Cloud Console Daten aus Zendesk 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 Zendesk, um die Drittanbieterquelle zu verbinden.

  5. Geben Sie Ihre Zendesk-Authentifizierungsinformationen ein und klicken Sie auf Weiter.

  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 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. Den Status der Datenaufnahme können Sie auf der Seite Datenspeicher prüfen. Klicken Sie dazu auf den Namen des Connectors, 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.

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

Nächste Schritte