Datenquelle von Drittanbietern verbinden

Hinweis: Dieses Feature ist ein Vorschauangebot, das den Pre-GA-Bedingungen in den Nutzungsbedingungen des GCP-Dienstes unterliegt. Pre-GA-Produkte und -Funktionen werden eventuell nur eingeschränkt unterstützt. Änderungen an Pre-GA-Produkten und -Funktionen sind möglicherweise nicht mit anderen Pre-GA-Versionen kompatibel. Weitere Informationen finden Sie unter den Beschreibungen der Startphase. Wenn Sie diese Funktion verwenden, stimmen Sie außerdem den Nutzungsbedingungen für die Vorschau der generativen KI zu ("Vorschaubedingungen"). Für diese Funktion können personenbezogene Daten gemäß dem Zusatz zur Verarbeitung von Cloud-Daten verarbeitet werden, vorbehaltlich der geltenden Einschränkungen und Verpflichtungen in der Vereinbarung (wie in den Vorschaubedingungen definiert).

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

Vorabversion:Sie müssen auf der Zulassungsliste stehen, um Drittanbieter-Connectors verwenden zu können.

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
   • AODocs verbinden (zusätzliche Zulassungsliste)
   • Asana verbinden
   • Connect-Box
   • Connect Coda (zusätzliche Zulassungsliste)
   • Confluence Cloud verbinden
   • On-Premises-Confluence Data Center verbinden
   • Dropbox verbinden
   • Connect Dynamics 365
   • Connect Entra ID
   • GitHub verbinden (zusätzliche Zulassungsliste)
   • GitLab verbinden (zusätzliche Zulassungsliste)
   • Jira Cloud verbinden
   • On-Premises-Jira Data Center verbinden
   • Microsoft Outlook verbinden (zusätzliche Zulassungsliste)
   • Microsoft Teams verbinden (zusätzliche Zulassungsliste)
   • Connect Monday
   • Notion verbinden (zusätzliche Zulassungsliste)
   • Okta verbinden
   • OneDrive verbinden
   • Salesforce verbinden
   • ServiceNow verbinden
   • SharePoint-Rechenzentrum lokal verbinden
   • SharePoint Online verbinden
   • Slack verbinden
   • Trello verbinden
   • WordPress verbinden
   • Connect Workday
   • Zendesk verbinden (zusätzliche Zulassungsliste)

Adobe Experience Manager verbinden

So synchronisieren Sie Daten aus Adobe Experience Manager mit Vertex AI Search:

Vorabversion:Sie müssen auf der Zulassungsliste stehen, um Drittanbieter-Connectors verwenden zu können.

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

Console

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 die nächste geplante Synchronisierung erwartet wird.

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

Nächste Schritte

• Wenn Sie Ihren Datenspeicher an eine App anhängen möchten, erstellen Sie eine App und wählen Sie Ihren Datenspeicher aus. Folgen Sie dazu der Anleitung unter Suchanwendung erstellen.

• Eine Vorschau, wie Ihre Suchergebnisse nach der Einrichtung Ihrer App aussehen, finden Sie unter Suchergebnisse abrufen. Wenn Sie die Zugriffssteuerung für Drittanbieter verwendet haben, lesen Sie den Hilfeartikel Vorschauergebnisse für Apps mit Zugriffssteuerung für Drittanbieter.

AODocs verbinden

So synchronisieren Sie Daten aus AODocs mit der Vertex AI Search:

Vorabversion:Sie müssen auf der Zulassungsliste stehen, um Drittanbieter-Connectors verwenden zu können.

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

Console

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 die nächste geplante Synchronisierung erwartet wird.

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

Nächste Schritte

• Wenn Sie Ihren Connector mit einer App verknüpfen möchten, erstellen Sie eine App und wählen Sie den Connector aus. Folgen Sie dazu der Anleitung unter Such-App erstellen.

• Eine Vorschau, wie Ihre Suchergebnisse nach der Einrichtung Ihrer App aussehen, finden Sie unter Suchergebnisse abrufen. Wenn Sie die Zugriffssteuerung von Drittanbietern verwendet haben, lesen Sie den Hilfeartikel Vorschauergebnisse für Apps mit Zugriffssteuerung von Drittanbietern.

Asana verbinden

So synchronisieren Sie Daten aus Asana mit Vertex AI Search:

Vorabversion:Sie müssen auf der Zulassungsliste stehen, um Drittanbieter-Connectors verwenden zu können.

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

Hinweise

Bevor Sie die Verbindung einrichten:

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

• Ein Asana-Administrator muss das folgende persönliche Zugriffstoken (PAT) für die Authentifizierung generieren oder abrufen. Weitere Informationen finden Sie in der Asana-Dokumentation unter Persönliches Zugriffstoken.

So laden Sie ein Mitglied in einen Asana-Arbeitsbereich ein:

1. Melden Sie sich mit Ihrem Administratorkonto in der Asana-Anwendung an.

2. Klicken Sie auf das Profilsymbol und wählen Sie Admin-Konsole aus.

3. Klicken Sie auf Mitglied einladen. Geben Sie die E-Mail-Adresse des Nutzers und das Projekt ein, das Sie hinzufügen möchten.

4. Klicken Sie auf Senden. Der Nutzer nimmt die Einladung an, damit er dem Projekt hinzugefügt wird.

So erstellst du eine PAT:

1. Öffnen Sie die Asana Developer Console.

2. Klicken Sie auf Meine Apps.

3. Klicken Sie auf Token erstellen.

4. Geben Sie im Dialogfeld Neues Token erstellen die erforderlichen Informationen ein.

5. Klicken Sie auf Token erstellen.

6. Kopieren Sie das Token zur späteren Verwendung.

7. Klicken Sie auf Fertig.

Asana-Cloud-Connector erstellen

Console

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

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

   Zum Agent Builder

2. Wählen Sie im Navigationsmenü Datenspeicher aus.

3. Klicken Sie auf Datenspeicher erstellen.

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

5. Geben Sie die Authentifizierungsdetails ein, einschließlich der generierten PAT.

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

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

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

9. Legen Sie eine Synchronisierungshäufigkeit für den Datenspeicher fest.

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

• Wenn Sie Ihren Datenspeicher mit einer App verknüpfen möchten, erstellen Sie eine App und wählen Sie Ihren Datenspeicher aus. Folgen Sie dazu der Anleitung unter Such-App erstellen.

• Eine Vorschau, wie Ihre Suchergebnisse nach der Einrichtung Ihrer App und Ihres Datenspeichers aussehen, finden Sie unter Suchergebnisse abrufen. Wenn Sie die Zugriffssteuerung von Drittanbietern verwendet haben, lesen Sie den Hilfeartikel Vorschauergebnisse für Apps mit Zugriffssteuerung von Drittanbietern.

Connect Box

So synchronisieren Sie Daten aus Box mit Vertex AI Search:

Vorabversion:Sie müssen auf der Zulassungsliste stehen, um Drittanbieter-Connectors verwenden zu können.

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. Sie benötigen Administratorzugriff auf die Box-Instanz mit aktivierter Bestätigung in zwei Schritten. Alle Einrichtungsanleitungen können nur über das Administratorkonto ausgeführt werden.

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

3. In der Box-Dokumentation finden Sie unter Einrichtung mit JWT eine Übersicht über die Einrichtung mit Screenshots.

Box-App erstellen

1. Melden Sie sich mit Ihrem Administratorkonto in der Box Developer Console an.
2. Klicken Sie auf Plattform-App erstellen.
3. Wählen Sie als App-Typ Benutzerdefinierte App aus.
4. Geben Sie den App-Namen ein.
5. Legen Sie die folgenden Attribute fest:
   1. Zweck:Integration
   2. Kategorien:KI
   3. Externes System: Google Cloud Agent Builder
6. Wählen Sie als Authentifizierungsmethode Server Authentication (with JWT) (Serverauthentifizierung mit JWT) aus.
7. Klicken Sie auf Anwendung erstellen.

Box App konfigurieren

1. Wählen Sie in der Box Developer Console die Plattform-App aus und rufen Sie den Tab Konfiguration auf.
2. Wählen Sie im Abschnitt App-Zugriffsebene die Option App- und Enterprise-Zugriff aus.

3. Wählen Sie im Bereich Anwendungsbereich die folgenden Bereiche aus:

   1. Alle in Box gespeicherten Dateien und Ordner lesen
   2. Alle in Box gespeicherten Dateien und Ordner schreiben
   3. Nutzer verwalten
   4. Gruppen verwalten
   5. Enterprise-Properties verwalten

4. Wählen Sie im Abschnitt Erweiterte Funktionen die Option API-Aufrufe mit dem Header „user-user“ ausführen aus.

5. Klicken Sie im Bereich Öffentliche Schlüssel hinzufügen und verwalten auf Paar aus öffentlichem und privatem Schlüssel erstellen.

   1. Der öffentliche Schlüssel wird automatisch mit einer ID in die Konsole hochgeladen. Diese ID wird beim Erstellen einer Verbindung verwendet.
   2. Sie können eine Konfigurationsdatei mit dem privaten Schlüssel und der Passphrase herunterladen. Bewahren Sie diese Datei für später auf.
   3. Optional können Sie auch einen eigenen Schlüssel generieren. Eine Anleitung dazu finden Sie in der Anleitung zum Einrichten von Box-Schlüsselpaaren.

6. Klicken Sie auf Änderungen speichern.

Box App autorisieren

1. Wählen Sie in der Box Developer Console die Plattform-App aus und rufen Sie den Tab Autorisierung auf.
2. Klicken Sie auf Überprüfen und senden.
3. Klicken Sie im Dialogfeld Einreichung der App-Autorisierung überprüfen auf Senden.
4. Melden Sie sich mit Ihrem Administratorkonto im Box Admin Platform Apps Manager an.
5. Wählen Sie die von Ihnen konfigurierte Plattform-App aus.
6. Klicken Sie in der entsprechenden Zeile auf das Dreipunkt-Menü ….
7. Wählen Sie in der Drop-down-Liste App autorisieren aus.
8. Klicken Sie im Dialogfeld App autorisieren auf Autorisieren, um den Autorisierungsvorgang abzuschließen.

Halten Sie die folgenden Informationen zur Box-Authentifizierung bereit:

• Enterprise-ID: Sie finden sie auf dem Tab Allgemeine Einstellungen.
• Client-ID und Clientschlüssel: Sie finden sie auf dem Tab Konfiguration unter OAuth 2.0-Anmeldedaten.
• Privater Schlüssel, Schlüssel-ID und Passphrase: Diese Parameter wurden bereits generiert und beim Konfigurieren der App auf dem Tab Konfiguration unter Öffentliche Schlüssel hinzufügen und verwalten in eine lokale Datei heruntergeladen.

Box-Connector erstellen

Console

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

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

   Zum Agent Builder

2. Klicken Sie im Navigationsmenü auf Datenspeicher.

3. Klicken Sie auf Datenspeicher erstellen.

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

5. Geben Sie Ihre Authentifizierungsinformationen ein.

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

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

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

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

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

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

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

Nächste Schritte

• Wenn Sie Ihren Datenspeicher an eine App anhängen möchten, erstellen Sie eine App und wählen Sie Ihren Datenspeicher aus. Folgen Sie dazu der Anleitung unter Suchanwendung erstellen.

• Eine Vorschau, wie Ihre Suchergebnisse nach der Einrichtung Ihrer App und Ihres Datenspeichers aussehen, finden Sie unter Suchergebnisse abrufen. Wenn Sie die Zugriffssteuerung von Drittanbietern verwendet haben, lesen Sie den Hilfeartikel Vorschauergebnisse für Apps mit Zugriffssteuerung von Drittanbietern.

Coda verbinden

So synchronisieren Sie Daten aus Coda mit Vertex AI Search:

Vorabversion:Sie müssen auf der Zulassungsliste stehen, um Drittanbieter-Connectors verwenden zu können.

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

Console

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 die nächste geplante Synchronisierung erwartet wird.

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

Nächste Schritte

• Wenn Sie Ihren Connector mit einer App verknüpfen möchten, erstellen Sie eine App und wählen Sie Ihren Connector aus. Folgen Sie dazu der Anleitung unter Such-App erstellen.

• Eine Vorschau, wie Ihre Suchergebnisse nach der Einrichtung Ihrer App aussehen, finden Sie unter Suchergebnisse abrufen. Wenn Sie die Zugriffssteuerung für Drittanbieter verwendet haben, lesen Sie den Hilfeartikel Vorschauergebnisse für Apps mit Zugriffssteuerung für Drittanbieter.

Confluence Cloud verbinden

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

Vorabversion:Sie müssen auf der Zulassungsliste stehen, um Drittanbieter-Connectors verwenden zu können.

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.

      Bereiche ansehen

      • read:attachment:confluence
      • read:configuration:confluence
      • read:content.metadata:confluence
      • read:content-details:confluence
      • read:group:confluence
      • read:space:confluence
      • read:user:confluence
   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

Console

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

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

   Zum Agent Builder

2. Klicken Sie im Navigationsmenü auf Datenspeicher.

3. Klicken Sie auf 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

• Wenn Sie Ihren Datenspeicher mit einer App verknüpfen möchten, erstellen Sie eine App und wählen Sie Ihren Datenspeicher aus. Folgen Sie dazu der Anleitung unter Such-App erstellen.

• Weitere Informationen finden Sie unter Vorschauergebnisse für Apps mit Zugriffssteuerung für Drittanbieter.

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.

Vorabversion:Sie müssen auf der Zulassungsliste stehen, um Drittanbieter-Connectors verwenden zu können.

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 ihr die Berechtigung kann ansehen zu.
10. Klicken Sie auf Übernehmen. 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

Console

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

   Zum Agent Builder

2. Klicken Sie im Navigationsmenü auf Datenspeicher.

3. Klicken Sie auf Datenspeicher erstellen.

4. Scrollen Sie auf der Seite Datenquelle auswählen nach unten oder suchen Sie nach 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. Sie können stattdessen 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. Wenn Ihre Instanz eine Domain-URL hat:
         • Dienstanhang: Geben Sie den Dienstanhang ein.
         • Optional: Basisdomainname: Geben Sie Ihre Basisdomain ein.
         • Domain-URL: Geben Sie die URL Ihrer Domain ein.
         • Optional: Zielport: Geben Sie den Zielport ein.
      2. Wenn für Ihre Instanz keine Domain-URL konfiguriert ist:
         • 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, um eine Meldung zu sehen, 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

• Wenn Sie Ihren Datenspeicher mit einer App verknüpfen möchten, erstellen Sie eine App und wählen Sie Ihren Datenspeicher aus. Folgen Sie dazu der Anleitung unter Such-App erstellen.
• Weitere Informationen finden Sie unter Vorschauergebnisse für Apps mit Zugriffssteuerung für Drittanbieter.

Dropbox verbinden

So synchronisieren Sie Daten aus Dropbox mit Vertex AI Search:

Vorabversion:Sie müssen auf der Zulassungsliste stehen, um Drittanbieter-Connectors verwenden zu können.

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

Console

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

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

   Zum Agent Builder

2. Klicken Sie im Navigationsmenü auf Datenspeicher.

3. Klicken Sie auf Datenspeicher erstellen.

4. 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 die nächste geplante Synchronisierung erwartet wird. 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

• Wenn Sie Ihren Datenspeicher mit einer App verknüpfen möchten, erstellen Sie eine App und wählen Sie Ihren Datenspeicher aus. Folgen Sie dazu der Anleitung unter Such-App erstellen.

• Eine Vorschau, wie Ihre Suchergebnisse nach der Einrichtung Ihrer App und Ihres Datenspeichers aussehen, finden Sie unter Suchergebnisse abrufen. Wenn Sie die Zugriffssteuerung von Drittanbietern verwendet haben, lesen Sie den Hilfeartikel Vorschauergebnisse für Apps mit Zugriffssteuerung von Drittanbietern.

Dynamics 365 verbinden

So synchronisieren Sie Daten aus Dynamics 365 mit Vertex AI Search:

Vorabversion:Sie müssen auf der Zulassungsliste stehen, um Drittanbieter-Connectors verwenden zu können.

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.

Achtung: Dieser Connector unterstützt ACLs nur teilweise. In der privaten Vorschau werden Nutzerdomains überprüft, eine detaillierte Nutzerbestätigung wird jedoch nicht unterstützt.

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

Console

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 die nächste geplante Synchronisierung erwartet wird.

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

Nächste Schritte

• Wenn Sie Ihren Connector mit einer App verknüpfen möchten, erstellen Sie eine App und wählen Sie den Connector aus. Folgen Sie dazu der Anleitung unter Such-App erstellen.

• Eine Vorschau, wie Ihre Suchergebnisse nach der Einrichtung Ihrer App aussehen, finden Sie unter Suchergebnisse abrufen. Wenn Sie die Zugriffssteuerung von Drittanbietern verwendet haben, lesen Sie den Hilfeartikel Vorschauergebnisse für Apps mit Zugriffssteuerung von Drittanbietern.

Entra ID verknüpfen

So synchronisieren Sie Daten von Entra ID mit Vertex AI Search:

Vorabversion:Sie müssen auf der Zulassungsliste stehen, um Drittanbieter-Connectors verwenden zu können.

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. So rufen Sie die Client-ID und den Clientschlüssel ab:

   1. So erstellen Sie eine Entra ID-Anwendung:

      1. Melden Sie sich im Microsoft Entra Admin Center an und klicken Sie auf Anwendung.
      2. Klicken Sie in der Drop-down-Liste Anwendung auf App-Registrierungen.
      3. Klicken Sie auf der Seite App-Registrierungen auf Neue Registrierung.
      4. Klicken Sie auf Neue Registrierung hinzufügen und gehen Sie so vor:
         • Geben Sie einen Namen für die Anwendung ein.
         • Wählen Sie unter Unterstützte Kontotypen die Option Nur Konten im Organisationsverzeichnis aus.
         • Fügen Sie unter Weiterleitungs-URI einen Web-Weiterleitungs-URI hinzu, der auf https://login.microsoftonline.com/common/oauth2/nativeclient verweist.
      5. Klicken Sie auf Registrieren.

   2. Anmeldedaten speichern:

      Speichern Sie im Fenster für die registrierte Anwendung die folgenden Werte für spätere Verwendung:

      1. Verwenden Sie die ID der Anwendung (Client), um den Parameter Client-ID festzulegen.
      2. Verwenden Sie die Verzeichnis-ID (Mandanten-ID), um den Parameter Azure-Mandant festzulegen.

   3. Clientschlüssel erstellen:

      1. Rufen Sie Zertifikate und Secrets auf und erstellen Sie einen neuen Clientschlüssel:
      2. Klicken Sie auf Neuer geheimer Clientschlüssel und geben Sie die erforderliche Dauer an.
      3. Speichern Sie das Client-Secret und kopieren Sie den Schlüsselwert für später.

Entra ID API-Berechtigungen konfigurieren

1. Klicken Sie im Fenster für die registrierte Anwendung auf API-Berechtigungen.

2. Wählen Sie unter Konfigurierte Berechtigungen die Option Microsoft Graph aus und konfigurieren Sie die folgende Berechtigung:

   Berechtigungen aufrufen

   • User.Read.All (Application)

   Wenn Sie profileCardAttributes aufnehmen möchten, konfigurieren Sie die folgenden Berechtigungen:

   Berechtigungen aufrufen

   • People.Read.All (Application)
   • PeopleSettings.Read.All (Application)

3. Gewähren Sie die Administratoreinwilligung für alle hinzugefügten Berechtigungen. Die Einwilligung eines Administrators ist erforderlich, um Clientanmeldedaten im Authentifizierungsablauf zu verwenden.

Entra ID-Connector erstellen

Console

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

5. Geben Sie unter Authentifizierungseinstellungen die Client-ID und den Clientschlüssel ein.

6. Überspringen Sie die Option Ziele und klicken Sie auf Weiter.

7. Geben Sie unter Erweiterte Optionen die Azure-Mandanten-ID ein.

8. Klicken Sie auf Weiter.

9. Wählen Sie unter Zu synchronisierende Entitäten die Option Nutzerprofile aus.

10. Klicken Sie auf Weiter.

11. Wählen Sie unter Daten-Connector konfigurieren eine Region für den Datenspeicher aus.

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

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

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

15. 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 die nächste geplante Synchronisierung erwartet wird.

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

16. Wenn der Status des Connectors zu Aktiv wechselt, rufen Sie den Tab Entität auf.

17. Klicken Sie auf die Entität userprofiles.

18. Prüfen Sie, ob die Anzahl der aufgenommenen Dokumente mit der Anzahl der Nutzer in Entra ID übereinstimmt.

    Wenn die Entra ID App die erforderlichen Berechtigungen zum Aufnehmen benutzerdefinierter Attribute hat, werden pro Datensatz bis zu 15 Profilkartenattribute aufgenommen. Standardmäßig sind die benutzerdefinierten Attribute nicht suchbar.

So machen Sie die benutzerdefinierten Attribute suchbar:

1. Rufen Sie auf der Seite userprofiles den Tab Schema auf.
2. Klicken Sie auf Bearbeiten.

3. Heben Sie die Auswahl der Attribute auf, die z. B. abgerufen, durchsucht und indexiert werden sollen, z. B. address, und klicken Sie dann auf Speichern.

   Die Schaltfläche Bearbeiten bleibt einige Minuten lang inaktiv, bevor sie wieder aktiviert wird.

4. Wenn die Schaltfläche Bearbeiten den Status Aktiv hat, klicken Sie auf Bearbeiten.

5. Klicken Sie für die erforderlichen benutzerdefinierten Attribute die Kästchen Abrufbar, suchbar und indexierbar an.

6. Aktivieren Sie die Suche.

7. Klicken Sie auf Speichern.

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 als Nutzer an.

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

Vorschau der Personensuche

1. Wenn Sie Google IdP verwenden, gehen Sie in der Such-App zu Vorabversion und starten Sie die Suche in der Console.

   • Alternativ können Sie den bereitgestellten Link aufrufen und sich mit Ihrem Identitätsanbieter anmelden, um mit der Suche zu beginnen.
   • Die Suchergebnisse werden als Personenkarten angezeigt, die Nutzerdetails wie Name, Berufsbezeichnung, E-Mail-Adresse und Profilbild enthalten.

2. Klicken Sie auf eine Personenkarte, um eine detaillierte Profilseite aufzurufen. Diese enthält Folgendes:

   • Name
   • Profilbild
   • Position
   • Abteilung
   • Führungsebene
   • Direkt unterstellte Mitarbeiter

3. Wenn benutzerdefinierte Attribute (Eigenschaften der Profilkarte) aufgenommen und indexierbar, suchbar und abrufbar gemacht werden:

   • Wenn Sie nach einem benutzerdefinierten Attributwert suchen, werden nur Personenprofile zurückgegeben, die diese Attribute enthalten.
   • Benutzerdefinierte Attribute werden in den Suchergebnissen angezeigt, aber nur über die API und nicht über die Benutzeroberfläche von Vertex Search darauf zugegriffen werden kann.

Personalpool für einen Drittanbieter-IdP ohne SSO konfigurieren

1. Wenn Ihre Mitarbeiter einen IdP verwenden, der nicht zu Google gehört, kein SSO mit Google nutzen oder keine Google Workspace-Kunden sind, richten Sie einen Mitarbeiterpool ein, wie unter Zugriffssteuerung für Datenquellen verwenden beschrieben, um die Mitarbeitersuche zu aktivieren.

   Mit dem Personalpool können Sie Nutzer von externen Identitätsanbietern wie Azure oder Okta in der Google Cloud Console verwalten und authentifizieren.

2. So konfigurieren Sie Ihren Workforce-Pool und aktivieren die Webanwendung für einen nahtlosen Nutzerzugriff:

   1. Erstellen Sie einen Workforce-Pool 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

• Wenn Sie Ihren Datenspeicher mit einer App verknüpfen möchten, erstellen Sie eine App und wählen Sie Ihren Datenspeicher aus. Folgen Sie dazu der Anleitung unter Such-App erstellen.

• Weitere Informationen finden Sie unter Vorschauergebnisse für Apps mit Zugriffssteuerung für Drittanbieter.

GitHub verbinden

So synchronisieren Sie Daten aus GitHub mit Vertex AI Search:

Vorabversion:Sie müssen auf der Zulassungsliste stehen, um Drittanbieter-Connectors verwenden zu können.

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

Console

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 die nächste geplante Synchronisierung erwartet wird.

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

Nächste Schritte

• Wenn Sie Ihren Connector mit einer App verknüpfen möchten, erstellen Sie eine App und wählen Sie Ihren Connector aus. Folgen Sie dazu der Anleitung unter Such-App erstellen.

• Eine Vorschau, wie Ihre Suchergebnisse nach der Einrichtung Ihrer App aussehen, finden Sie unter Suchergebnisse abrufen. Wenn Sie die Zugriffssteuerung für Drittanbieter verwendet haben, lesen Sie den Hilfeartikel Vorschauergebnisse für Apps mit Zugriffssteuerung für Drittanbieter.

GitLab verbinden

So synchronisieren Sie Daten aus GitLab mit Vertex AI Search:

Vorabversion:Sie müssen auf der Zulassungsliste stehen, um Drittanbieter-Connectors verwenden zu können.

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

Console

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 die nächste geplante Synchronisierung erwartet wird.

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

Nächste Schritte

• Wenn Sie Ihren Connector mit einer App verknüpfen möchten, erstellen Sie eine App und wählen Sie Ihren Connector aus. Folgen Sie dazu der Anleitung unter Such-App erstellen.

• Eine Vorschau, wie Ihre Suchergebnisse nach der Einrichtung Ihrer App aussehen, finden Sie unter Suchergebnisse abrufen. Wenn Sie die Zugriffssteuerung für Drittanbieter verwendet haben, lesen Sie den Hilfeartikel Vorschauergebnisse für Apps mit Zugriffssteuerung für Drittanbieter.

Jira Cloud verbinden

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

Vorabversion:Sie müssen auf der Zulassungsliste stehen, um Drittanbieter-Connectors verwenden zu können.

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

Hinweise

Bevor Sie die Verbindung einrichten:

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

Authentifizierung und Berechtigungen in Jira einrichten

Sorgen Sie mithilfe der Anleitungen in den folgenden Abschnitten dafür, dass Sie die erforderlichen Authentifizierungsdetails und den Administratorzugriff auf Ihre Jira-Instanz haben. Erstellen Sie eine Client-ID und einen Clientschlüssel über die Atlassian Developer Console, konfigurieren Sie die erforderlichen OAuth 2.0-Bereiche, richten Sie Berechtigungen für Nutzer ein, rufen Sie die Instanz-URL und ‑ID ab, konfigurieren Sie Rollen und authentifizieren Sie sich, um Daten zwischen Jira Cloud und Vertex AI Search zu synchronisieren.

Client-ID und Clientschlüssel erstellen

Hinweis: Informationen zum Aktivieren von OAuth 2.0 und zum Abrufen der Client-ID und des Clientschlüssels finden Sie in der Atlassian-Entwicklerdokumentation unter [OAuth 2.0 (3LO) apps][confluence-oauth].

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:

      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/jira_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. Wählen Sie Berechtigungen aus:

      1. Rufen Sie die Jira API auf.
      2. Klicken Sie auf Hinzufügen.
      3. Klicken Sie auf Konfigurieren.
      4. Rufen Sie den Tab Klassische Berechtigungen auf und klicken Sie auf Berechtigungen bearbeiten. Wählen Sie die folgenden Bereiche aus:

         Bereiche ansehen

         • read:avatar:jira
         • read:audit-log:jira
         • read:group:jira
         • read:issue-security-level:jira
         • read:issue-security-scheme:jira
         • read:jira-user
         • read:jira-work
         • read:user:jira

   2. Prüfen Sie, ob acht Bereiche ausgewählt sind, und speichern Sie dann Ihre Änderungen.

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

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, also die Subdomain in der Adressleiste.

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

Console

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

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

   Zum Agent Builder

2. Klicken Sie im Navigationsmenü auf Datenspeicher.

3. Klicken Sie auf Datenspeicher erstellen.

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

• Wenn Sie Ihren Datenspeicher an eine App anhängen möchten, erstellen Sie eine App und wählen Sie Ihren Datenspeicher aus. Folgen Sie dazu der Anleitung unter Suchanwendung erstellen.

• Weitere Informationen finden Sie unter Vorschauergebnisse für Apps mit Zugriffssteuerung für Drittanbieter.

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.

Vorabversion:Sie müssen auf der Zulassungsliste stehen, um Drittanbieter-Connectors verwenden zu können.

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

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.

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

Anwendungszugriff konfigurieren

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

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

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

Console

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

   Zum Agent Builder

2. Klicken Sie im Navigationsmenü auf Datenspeicher.

3. Klicken Sie auf Datenspeicher erstellen.

4. Scrollen Sie auf der Seite Datenquelle auswählen nach unten oder suchen Sie nach 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. Wenn Ihre Instanz eine Domain-URL hat:
         • Dienstanhang: Geben Sie den Dienstanhang ein.
         • Optional: Basisdomainname: Geben Sie Ihre Basisdomain ein.
         • Domain-URL: Geben Sie die URL Ihrer Domain ein.
         • Optional: Zielport: Geben Sie den Zielport ein.
      2. Wenn für Ihre Instanz keine Domain-URL konfiguriert ist:
         • 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, um eine Meldung zu sehen, 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

• Wenn Sie Ihren Datenspeicher an eine App anhängen möchten, erstellen Sie eine App und wählen Sie Ihren Datenspeicher aus. Folgen Sie dazu der Anleitung unter Suchanwendung erstellen.

• Eine Vorschau, wie Ihre Suchergebnisse nach der Einrichtung Ihrer App aussehen, finden Sie unter Suchergebnisse abrufen. Wenn Sie die Zugriffssteuerung für Drittanbieter verwendet haben, lesen Sie den Hilfeartikel Vorschauergebnisse für Apps mit Zugriffssteuerung für Drittanbieter.

Microsoft Outlook verbinden

So synchronisieren Sie Daten aus Microsoft Outlook mit Vertex AI Search:

Vorabversion:Sie müssen auf der Zulassungsliste stehen, um Drittanbieter-Connectors verwenden zu können.

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

Console

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 die nächste geplante Synchronisierung erwartet wird.

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

Nächste Schritte

• Wenn Sie Ihren Connector mit einer App verknüpfen möchten, erstellen Sie eine App und wählen Sie Ihren Connector aus. Folgen Sie dazu der Anleitung unter Such-App erstellen.

• Eine Vorschau, wie Ihre Suchergebnisse nach der Einrichtung Ihrer App aussehen, finden Sie unter Suchergebnisse abrufen. Wenn Sie die Zugriffssteuerung für Drittanbieter verwendet haben, lesen Sie den Hilfeartikel Vorschauergebnisse für Apps mit Zugriffssteuerung für Drittanbieter.

Microsoft Teams verbinden

So synchronisieren Sie Daten aus Microsoft Teams mit der Vertex AI Search:

Vorabversion:Sie müssen auf der Zulassungsliste stehen, um Drittanbieter-Connectors verwenden zu können.

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 Integration mit Vertex AI Search vorzunehmen:

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

Microsoft Teams-Connector erstellen

Console

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 die nächste geplante Synchronisierung erwartet wird.

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

Nächste Schritte

• Wenn Sie Ihren Connector mit einer App verknüpfen möchten, erstellen Sie eine App und wählen Sie Ihren Connector aus. Folgen Sie dazu der Anleitung unter Such-App erstellen.

• Eine Vorschau, wie Ihre Suchergebnisse nach der Einrichtung Ihrer App aussehen, finden Sie unter Suchergebnisse abrufen. Wenn Sie die Zugriffssteuerung von Drittanbietern verwendet haben, lesen Sie den Hilfeartikel Vorschauergebnisse für Apps mit Zugriffssteuerung von Drittanbietern.

Connect Monday

So synchronisieren Sie Daten von Monday mit Vertex AI Search:

Vorabversion:Sie müssen auf der Zulassungsliste stehen, um Drittanbieter-Connectors verwenden zu können.

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, benötigen Sie die Domain-URL, Administratorzugriff und ein API-Token.

So generieren Sie die Konto-URL und das API-Token:

1. Melden Sie sich mit Ihrem Administratorkonto in der Monday-Anwendung an.
2. Klicken Sie auf das Symbol Profil.
3. Wählen Sie Verwaltung aus.
4. Rufen Sie den Tab Allgemein auf und geben Sie den Kontonamen und die Konto-URL ein.
5. Kehren Sie zum Profilsymbol zurück und wählen Sie Entwickler aus.
6. Klicken Sie auf der Seite Monday Developer Center auf Meine Zugriffstokens.
7. Klicken Sie auf Anzeigen, um das Token zu sehen.
8. Kopieren Sie das Token, damit Sie es zur Authentifizierung verwenden können.

Monday-Connector erstellen

Console

So synchronisieren Sie mit der Google Cloud Console Daten von Montag mit Vertex AI Search:

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

   Zum Agent Builder

2. Klicken Sie auf der Seite Datenspeicher auf Datenspeicher erstellen.

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

4. Geben Sie Ihre Monday-Authentifizierungsinformationen ein und klicken Sie auf Weiter.

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

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

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

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

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

10. 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 die nächste geplante Synchronisierung erwartet wird.

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

Nächste Schritte

• Wenn Sie Ihren Connector mit einer App verknüpfen möchten, erstellen Sie eine App und wählen Sie Ihren Connector aus. Folgen Sie dazu der Anleitung unter Such-App erstellen.

• Eine Vorschau, wie Ihre Suchergebnisse nach der Einrichtung Ihrer App aussehen, finden Sie unter Suchergebnisse abrufen. Wenn Sie die Zugriffssteuerung für Drittanbieter verwendet haben, lesen Sie den Hilfeartikel Vorschauergebnisse für Apps mit Zugriffssteuerung für Drittanbieter.

Notion verbinden

So synchronisieren Sie Daten aus Notion mit der Vertex AI Search:

Vorabversion:Sie müssen auf der Zulassungsliste stehen, um Drittanbieter-Connectors verwenden zu können.

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.

Achtung: Dieser Connector unterstützt ACLs nur teilweise. In der privaten Vorschau werden Nutzerdomains überprüft, eine detaillierte Nutzerbestätigung wird jedoch nicht unterstützt.

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

Console

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 die nächste geplante Synchronisierung erwartet wird.

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

Nächste Schritte

• Wenn Sie Ihren Connector mit einer App verknüpfen möchten, erstellen Sie eine App und wählen Sie den Connector aus. Folgen Sie dazu der Anleitung unter Such-App erstellen.

• Eine Vorschau, wie Ihre Suchergebnisse nach der Einrichtung Ihrer App aussehen, finden Sie unter Suchergebnisse abrufen. Wenn Sie die Zugriffssteuerung von Drittanbietern verwendet haben, lesen Sie den Hilfeartikel Vorschauergebnisse für Apps mit Zugriffssteuerung von Drittanbietern.

Okta verbinden

So synchronisieren Sie Daten aus Okta mit Vertex AI Search:

Vorabversion:Sie müssen auf der Zulassungsliste stehen, um Drittanbieter-Connectors verwenden zu können.

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 Domain-URL und den Administratorzugriff auf die Okta-Instanz haben. So rufen Sie die URL der Okta-Instanz, die Client-ID und das API-Token ab:

1. So rufen Sie die URL der Okta-Instanz ab:

   1. Melden Sie sich mit Ihren Administratoranmeldedaten auf der Okta-Anmeldeseite an.
   2. Klicken Sie auf Ihr Profilsymbol oder rufen Sie direkt die Admin-Konsole auf. Die URL Ihrer Okta-Instanz wird in der Adressleiste als Subdomain angezeigt.

2. So generieren Sie die Client-ID und das API-Token:

   1. Melden Sie sich mit Ihrem Administratorkonto in der URL Ihrer Okta-Instanz an.
   2. Rufen Sie das Dashboard „Verwaltung“ auf.
   3. Klicken Sie auf das Symbol Anwendungen und wählen Sie Anwendungen aus.
   4. Klicken Sie auf App-Einbindung erstellen.
   5. Wählen Sie OIDC – OpenID Connect aus.
   6. Wählen Sie als Anwendungstyp Webanwendung aus und klicken Sie auf Weiter.
   7. Geben Sie in das Feld Name der App-Einbindung einen Namen ein.
   8. Scrollen Sie zu Aufgaben und wählen Sie Gruppenzuweisung vorerst überspringen aus.
   9. Klicken Sie auf Speichern.
   10. Klicken Sie im Fenster Clientanmeldedaten auf Bearbeiten.
   11. Wählen Sie Öffentlicher Schlüssel / Privater Schlüssel aus.
   12. Klicken Sie unter Öffentlicher Schlüssel auf Schlüssel hinzufügen.
   13. Klicken Sie auf Neuen Schlüssel generieren, dann auf Fertig und abschließend auf Speichern.
   14. Ein Dialogfeld wird angezeigt. Klicken Sie auf Speichern.
   15. Klicken Sie unter Allgemeine Einstellungen auf Bearbeiten.
   16. Wählen Sie Clientanmeldedaten aus und klicken Sie auf Speichern.

Okta-Connector erstellen

Console

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

5. Geben Sie Ihre Okta-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 die nächste geplante Synchronisierung erwartet wird.

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

Nächste Schritte

• Wenn Sie Ihren Connector mit einer App verknüpfen möchten, erstellen Sie eine App und wählen Sie Ihren Connector aus. Folgen Sie dazu der Anleitung unter Such-App erstellen.

• Eine Vorschau, wie Ihre Suchergebnisse nach der Einrichtung Ihrer App aussehen, finden Sie unter Suchergebnisse abrufen. Wenn Sie die Zugriffssteuerung von Drittanbietern verwendet haben, lesen Sie den Hilfeartikel Vorschauergebnisse für Apps mit Zugriffssteuerung von Drittanbietern.

OneDrive verbinden

So synchronisieren Sie Daten aus OneDrive mit Vertex AI Search:

Vorabversion:Sie müssen auf der Zulassungsliste stehen, um Drittanbieter-Connectors verwenden zu können.

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:

      Bereiche ansehen

      • Files.Read.All (Application)
      • Group.Read.All (Application)
      • User.Read.All (Application)

OneDrive-Connector erstellen

Console

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

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

   Zum Agent Builder

2. Klicken Sie im Navigationsmenü auf Datenspeicher.

3. Klicken Sie auf Datenspeicher erstellen.

4. 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 die nächste geplante Synchronisierung erwartet wird.

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

Nächste Schritte

• Wenn Sie Ihren Datenspeicher mit einer App verknüpfen möchten, erstellen Sie eine App und wählen Sie Ihren Datenspeicher aus. Folgen Sie dazu der Anleitung unter Such-App erstellen.

• Eine Vorschau, wie Ihre Suchergebnisse nach der Einrichtung Ihrer App und Ihres Datenspeichers aussehen, finden Sie unter Suchergebnisse abrufen. Wenn Sie die Zugriffssteuerung von Drittanbietern verwendet haben, lesen Sie den Hilfeartikel Vorschauergebnisse für Apps mit Zugriffssteuerung von Drittanbietern.

Salesforce verbinden

So synchronisieren Sie Daten aus Salesforce mit Vertex AI Search:

Vorabversion:Sie müssen auf der Zulassungsliste stehen, um Drittanbieter-Connectors verwenden zu können.

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

Console

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

• Wenn Sie Ihren Datenspeicher an eine App anhängen möchten, erstellen Sie eine App und wählen Sie Ihren Datenspeicher aus. Folgen Sie dazu der Anleitung unter Suchanwendung erstellen.

• Weitere Informationen finden Sie unter Vorschauergebnisse für Apps mit Zugriffssteuerung für Drittanbieter.

ServiceNow verbinden

So synchronisieren Sie Daten aus ServiceNow mit Vertex AI Search:

Vorabversion:Sie müssen auf der Zulassungsliste stehen, um Drittanbieter-Connectors verwenden zu können.

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

Hinweis :Verwenden Sie für die folgende Einrichtung die Haupt-ServiceNow-Website für die Konfiguration von OAuth und Berechtigungen.

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

Console

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

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

   Zum Agent Builder

2. Klicken Sie im Navigationsmenü auf Datenspeicher.

3. Klicken Sie auf Datenspeicher erstellen.

4. 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 die nächste geplante Synchronisierung erwartet wird.

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

Nächste Schritte

• Wenn Sie Ihren Datenspeicher an eine App anhängen möchten, erstellen Sie eine App und wählen Sie Ihren Datenspeicher aus. Folgen Sie dazu der Anleitung unter Suchanwendung erstellen.

• Weitere Informationen finden Sie unter Vorschauergebnisse für Apps mit Zugriffssteuerung für Drittanbieter.

SharePoint-Rechenzentrum lokal verbinden

Mit dieser Anleitung können Sie in Agent Builder einen SharePoint-Rechenzentrumsdatenspeicher und eine Such-App erstellen und vor Ort gespeicherte SharePoint-Daten mit Vertex AI Search synchronisieren.

Vorabversion:Sie müssen auf der Zulassungsliste stehen, um Drittanbieter-Connectors verwenden zu können.

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

Hinweise

Führen Sie vor dem Einrichten der Verbindung die folgenden Schritte aus:

1. Dienstanhang (nur für den privaten Zieltyp erforderlich): Mit den folgenden Schritten können Sie einen Dienstanhang für die sichere Datenübertragung generieren.

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

   2. Öffentlicher Endpunkt: Wenn der Zieltyp des SharePoint-Rechenzentrums Öffentlich ist, müssen Sie die Einrichtung für den Dienst-Anhang 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 Cloud
      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 eine Systemdiagnose ein, um den Zustand des Backends zu überwachen.
      5. Fügen Sie einen Load Balancer hinzu, um den Traffic an die VM oder das Back-End weiterzuleiten.
      6. Firewallregeln definieren, um Traffic zwischen dem PSC-Endpunkt und dem Backend zuzulassen
      7. Veröffentlichen Sie den Endpunkt, indem Sie einen PSC-Dienstanhang erstellen.

2. Nutzername und Passwort: Wenden Sie sich an Ihren SharePoint-Administrator, um gültige Anmeldedaten für die Authentifizierung zu erhalten.

3. Optional für den privaten Zieltyp: Domain-URL: Behalten Sie die Domain-URL der SharePoint-Rechenzentrums-Instanz bei, wenn sich die Instanz hinter einem Proxy oder einer SSL-basierten Verbindung befindet.

4. Optional: Basisdomainname: Geben Sie den Basisdomainnamen für die SharePoint-Instanz an.

5. Optional: Zielport: Geben Sie den Port an, der für die Kommunikation mit dem SharePoint-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.

SharePoint Data Center-Nutzer erstellen

Wenn Sie einen SharePoint-Rechenzentrumsnutzer erstellen möchten, holen Sie sich einen Nutzernamen und ein Passwort von einem Administrator. Der Administrator muss die folgenden Schritte ausführen, um einen neuen Nutzer in der SharePoint-Rechenzentrumsinstanz zu erstellen.

1. Klicken Sie auf das Startmenü.
2. Gehen Sie zu Windows-Verwaltungstools > Active Directory-Nutzer und -Computer.
3. Starten Sie die Anwendung Active Directory-Nutzer und ‑Computer.
4. Maximieren Sie die Organisationseinheit und rufen Sie den Container Nutzer auf, um den neuen Nutzer hinzuzufügen.
5. Klicken Sie mit der rechten Maustaste auf Nutzer und wählen Sie Neu > Nutzer aus.
6. Im Dialogfeld Neues Objekt: Nutzer:
   1. Geben Sie Vorname, Vollständiger Name und Benutzeranmeldename ein.
   2. Klicken Sie auf Weiter.
7. Im Dialogfeld Neues Objekt: Nutzer:
   1. Geben Sie die erforderlichen Informationen ein:
      1. Passwort
      2. Passwort bestätigen
   2. Wählen Sie die folgenden Optionen aus:
      1. Nutzer kann das Passwort nicht ändern
      2. Das Kennwort läuft nie ab
   3. Klicken Sie auf Weiter.
8. Klicken Sie auf Beenden.
9. Suchen Sie im Bereich Nutzer den erstellten Nutzer, klicken Sie doppelt darauf und wählen Sie Eigenschaften aus.
10. Gehen Sie im Dialogfeld Eigenschaften so vor:
    1. Fügen Sie eine E-Mail-Adresse für den Nutzer hinzu.
    2. Klicken Sie auf Übernehmen.

Websitesammlung in SharePoint konfigurieren

1. Melden Sie sich in der SharePoint-Administratorkonsole an.
2. Gehen Sie auf der Seite Zentrale Verwaltung zu Anwendungsverwaltung.
3. Klicken Sie auf Websitesammlungen erstellen.
4. Geben Sie auf der Seite Websitesammlung erstellen die erforderlichen Informationen in die Felder Titel und Beschreibung ein.
5. Geben Sie im Abschnitt Websiteadresse den URL-Namen der Website ein.
6. Klicken Sie im Bereich Primärer Administrator der Websitesammlung neben dem Feld Nutzername auf die Option Durchsuchen.
7. Geben Sie im Dialogfeld Personen auswählen den Administratornamen ein und klicken Sie auf das Symbol Suchen.
8. Wählen Sie den Nutzer aus und klicken Sie auf OK. Die Seite Website wurde erfolgreich erstellt wird angezeigt und die Website-URL wird eingeblendet.
9. Kopieren Sie die URL und öffnen Sie sie in einem neuen Tab. Die Website wird angezeigt.

Mit dem erstellten Nutzer anmelden

1. Melden Sie sich mit den Anmeldedaten des erstellten Nutzers auf der SharePoint-Website an.
2. Prüfen Sie den Zugriff und die Berechtigungen des Nutzers.

On-Premises-Connector für SharePoint-Rechenzentren erstellen

Console

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

   Zum Agent Builder

2. Klicken Sie im Navigationsmenü auf Datenspeicher.

3. Klicken Sie auf Datenspeicher erstellen.

4. Scrollen Sie auf der Seite Datenquelle auswählen nach unten oder suchen Sie nach SharePoint-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. Sie können stattdessen 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. Wenn Ihre Instanz eine Domain-URL hat:
         • Dienstanhang: Geben Sie den Dienstanhang ein.
         • Optional: Basisdomainname: Geben Sie Ihre Basisdomain ein.
         • Domain-URL: Geben Sie die URL Ihrer Domain ein.
         • Optional: Zielport: Geben Sie den Zielport ein.
      2. Wenn für Ihre Instanz keine Domain-URL konfiguriert ist:
         • 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.

So verwalten Sie Connector-Status:

1. Für den privaten Zieltyp:

   1. Reichen Sie die Connector-Details ein.
   2. VAIS sendet eine Verbindungsanfrage an Ihre PSC.
   3. 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.
   4. Verbindung in PSC zulassen:
      1. Der Connector bleibt im Status Fehler, bis Sie die Anfrage genehmigen.
      2. Nach der Genehmigung wird der Connector bei der nächsten Synchronisierung in den Status Aktiv versetzt.
   5. Wenn Ihr PSC so konfiguriert ist, dass alle Verbindungen akzeptiert werden, wechselt der Connector nach der Erstellung automatisch in den Status Aktiv.

2. Für den öffentlichen Zieltyp:

   1. Reichen Sie die Connector-Details ein.
   2. Der Connector wechselt nach dem Einreichen 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 in Aktiv geändert wurde, 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 Laufend und nach Abschluss der Datenaufnahme zu Aktiv. Das bedeutet, dass der Datenspeicher eingerichtet ist. Je nach Größe der Daten kann die Datenaufnahme mehrere Stunden dauern.

Nächste Schritte

• Wenn Sie Ihren Datenspeicher mit einer App verknüpfen möchten, erstellen Sie eine App und wählen Sie Ihren Datenspeicher aus. Folgen Sie dazu der Anleitung unter Such-App erstellen.
• Weitere Informationen finden Sie unter Vorschauergebnisse für Apps mit Zugriffssteuerung für Drittanbieter.

SharePoint Online verbinden

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

Vorabversion:Sie müssen auf der Zulassungsliste stehen, um Drittanbieter-Connectors verwenden zu können.

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. Wählen Sie zum Registrieren der Anwendung für die Zielgruppe für die Anmeldung Nur Konten in diesem Organisationsverzeichnis aus und suchen Sie dann nach diesen Authentifizierungsinformationen. Weitere Informationen finden Sie in der Microsoft 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 Web-Callback-URL.

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

      Bereiche ansehen

      • GroupMember.Read.All
      • Sites.FullControl.All
      • User.Read.All

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

      Bereiche ansehen

      • AllSites.FullControl

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

Rollen ansehen

Rollen	Registrierung der Clientanwendung	Inhalte aller Entitäten abrufen	ACL abrufen	Identität abrufen	Hinweise
Websiteadministratoren	Nein	Ja	Ja	Ja
Administrator der Websitesammlung	Nein	Ja	Ja	Ja
Globaler Administrator	Ja	Nein	Ja	Nein	Einschränkung: Der globale Administrator kann keine Identitäts-, Kommentar- und Anhangs-Entitäten abrufen.
Websiteinhaber	Nein	Ja	Ja	Nein	Einschränkung: „Websiteinhaber“ bezieht sich auf das Microsoft 365-Verwaltungscenter bzw. das Entra-Verwaltungscenter und nicht speziell auf SharePoint.
Anwendungsadministrator	Ja	–	–	–	Die Rolle „Anwendungsadministrator“ bezieht sich auf das Microsoft 365 Admin Center bzw. das Entra Admin Center. Sie ist nicht auf SharePoint beschränkt.

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-Verwaltungskonsole 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-Verwaltungskonsole 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

Console

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

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

   Zum Agent Builder

2. Klicken Sie im Navigationsmenü auf Datenspeicher.

3. Klicken Sie auf Datenspeicher erstellen.

4. 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 die nächste geplante Synchronisierung erwartet wird.

    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.

Hinweis: Wenn Sie Probleme bei der Anmeldung mit einer Microsoft-ID haben, prüfen Sie, ob der Nutzer den Nutzern der Enterprise-Anwendung in Microsoft Entra hinzugefügt wurde.

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 Workforce-Pool 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

• Wenn Sie Ihren Datenspeicher mit einer App verknüpfen möchten, erstellen Sie eine App und wählen Sie Ihren Datenspeicher aus. Folgen Sie dazu der Anleitung unter Such-App erstellen.

• Weitere Informationen finden Sie unter Vorschauergebnisse für Apps mit Zugriffssteuerung für Drittanbieter.

Slack verbinden

So synchronisieren Sie Daten aus Slack mit Vertex AI Search:

Vorabversion:Sie müssen auf der Zulassungsliste stehen, um Drittanbieter-Connectors verwenden zu können.

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:

      Bereiche ansehen

      • users:read.email
      • channels:history
      • channels:read
      • groups:history
      • groups:read
      • im:history
      • im:read
      • mpim:history
      • mpim:read
      • team:read
      • users:read
      • files:read

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.

Hinweis: Erstellen Sie eine Slack-App und wählen Sie je nach Bedarf ein Bot-Token (generate a bot token) oder ein Nutzertoken (generate a user token) aus.

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:

      Bereiche ansehen

      • users:read.email
      • channels:history
      • channels:read
      • groups:history
      • groups:read
      • im:history
      • im:read
      • mpim:history
      • mpim:read
      • team:read
      • users:read
      • files:read

   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:

      Bereiche ansehen

      • users:read.email
      • channels:history
      • channels:read
      • groups:history
      • groups:read
      • im:history
      • im:read
      • mpim:history
      • mpim:read
      • users:read
      • files:read

   8. Klicken Sie auf Im Arbeitsbereich Ihres Nutzernamens installieren.

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

Slack Cloud-Connector erstellen

Console

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

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

   Zum Agent Builder

2. Klicken Sie im Navigationsmenü auf Datenspeicher.

3. Klicken Sie auf Datenspeicher erstellen.

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

5. Geben Sie Ihre Slack-Authentifizierungsinformationen ein.

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

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

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

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

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

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

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

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

Nächste Schritte

• Wenn Sie Ihren Datenspeicher an eine App anhängen möchten, erstellen Sie eine App und wählen Sie Ihren Datenspeicher aus. Folgen Sie dazu der Anleitung unter Suchanwendung erstellen.

• Weitere Informationen finden Sie unter Vorschauergebnisse für Apps mit Zugriffssteuerung für Drittanbieter.

Trello verbinden

So synchronisieren Sie Daten aus Trello mit der Vertex AI Search:

Vorabversion:Sie müssen auf der Zulassungsliste stehen, um Drittanbieter-Connectors verwenden zu können.

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.

Achtung: Dieser Connector unterstützt ACLs nur teilweise. In der privaten Vorschau werden Nutzerdomains überprüft, eine detaillierte Nutzerbestätigung wird jedoch nicht unterstützt.

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.

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

1. So generieren Sie einen API-Schlüssel in Trello:

   1. Melden Sie sich mit den bereitgestellten Anmeldedaten des Testnutzers in Trello in der Trello-Instanz an.

   2. Gehen Sie auf der Seite Trello-Power-Ups-Verwaltung zu Auf die Power-Up-Verwaltung zugreifen.

   3. Klicken Sie auf Neu, um ein neues Power-Up zu erstellen.

   4. Geben Sie die erforderlichen Details ein:

      Hinweis :Die Iframe-Connector-URL ist nur erforderlich, wenn Sie ein Power-up erstellen möchten. Andernfalls lassen Sie das Feld leer.

   5. Klicken Sie auf Weiter, um fortzufahren, und generieren Sie dann einen API-Schlüssel. Kopieren Sie den API-Schlüssel und das Secret.

2. So generieren Sie ein API-Token in Trello:

   1. Klicken Sie rechts auf den Link Token generieren, um ein API-Token zu generieren.

      1. Klicken Sie auf Zulassen, um Zugriff auf Ihr API-Token zu gewähren.
      2. Prüfen Sie, ob alle erforderlichen Entitäten die richtigen Berechtigungen im Gültigkeitsbereich haben.

   2. Kopieren Sie das generierte API-Token. Verwenden Sie dieses Token für den Trello-Connector in der Vertex AI-Suche.

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

Trello-Connector erstellen

Console

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 die nächste geplante Synchronisierung erwartet wird.

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

Nächste Schritte

• Wenn Sie Ihren Connector mit einer App verknüpfen möchten, erstellen Sie eine App und wählen Sie Ihren Connector aus. Folgen Sie dazu der Anleitung unter Such-App erstellen.

• Eine Vorschau, wie Ihre Suchergebnisse nach der Einrichtung Ihrer App aussehen, finden Sie unter Suchergebnisse abrufen. Wenn Sie die Zugriffssteuerung für Drittanbieter verwendet haben, lesen Sie den Hilfeartikel Vorschauergebnisse für Apps mit Zugriffssteuerung für Drittanbieter.

WordPress verbinden

So synchronisieren Sie Daten aus WordPress mit Vertex AI Search:

Vorabversion:Sie müssen auf der Zulassungsliste stehen, um Drittanbieter-Connectors verwenden zu können.

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.

Achtung :Die Zugriffssteuerung für WordPress wird nicht unterstützt.

Hinweise

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

• Nutzername und Passwort: Erfragen Sie die Anmeldedaten vom WordPress-Administrator.
• Website-URL: Verwenden Sie diese URL für die Erstellung des Datenspeichers.

WordPress-Nutzer erstellen

Wenn Sie einen WordPress-Nutzer erstellen möchten, fordern Sie einen Nutzernamen und ein Passwort von einem Administrator an. Der Administrator muss sich anmelden und diese Schritte ausführen, um einen neuen Nutzer in der WordPress-Instanz zu erstellen.

1. Melden Sie sich als Administrator an:

   1. Rufen Sie Ihre Hostingplattform auf und melden Sie sich mit Ihren Administratoranmeldedaten an, um auf Ihre WordPress-Website zuzugreifen.
   2. Klicken Sie auf das Symbol Website.
   3. Klicken Sie für Ihre Website auf WordPress-Admin.

2. So erstellen Sie einen neuen Nutzer:

   1. Rufen Sie auf der WordPress-Admin-Seite den Tab Nutzer auf.
   2. Klicken Sie auf Neu hinzufügen.
   3. Geben Sie alle erforderlichen Details an, einschließlich:
      • Nutzername
      • E-Mail-Adresse
      • Optional: Vor- und Nachname
      • Rolle
      • Passwort (falls erforderlich)
   4. Klicken Sie auf Neuen Nutzer hinzufügen, um die Änderungen zu speichern.

WordPress-Connector erstellen

Console

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

5. Geben Sie Ihre WordPress-Authentifizierungsinformationen ein und klicken Sie auf Continue (Weiter).

6. Geben Sie im Feld URL die URL Ihrer WordPress-Website 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 die nächste geplante Synchronisierung erwartet wird.

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

Nächste Schritte

• Wenn Sie Ihren Connector mit einer App verknüpfen möchten, erstellen Sie eine App und wählen Sie Ihren Connector aus. Folgen Sie dazu der Anleitung unter Such-App erstellen.

• Eine Vorschau, wie Ihre Suchergebnisse nach der Einrichtung Ihrer App aussehen, finden Sie unter Suchergebnisse abrufen. Wenn Sie die Zugriffssteuerung für Drittanbieter verwendet haben, lesen Sie den Hilfeartikel Vorschauergebnisse für Apps mit Zugriffssteuerung für Drittanbieter.

Workday verknüpfen

So synchronisieren Sie Daten aus Workday mit Vertex AI Search:

Vorabversion:Sie müssen auf der Zulassungsliste stehen, um Drittanbieter-Connectors verwenden zu können.

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.

Achtung: Die Zugriffssteuerung für Workday wird nicht unterstützt.

Hinweise

Bevor Sie einen Workday-Connector erstellen, müssen Sie Folgendes tun:

1. 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 Details der Workday-Instanzkonfiguration.

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

Console

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 die Drittanbieterquelle zu verbinden.

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 die nächste geplante Synchronisierung erwartet wird.

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

Nächste Schritte

• Wenn Sie Ihren Connector mit einer App verknüpfen möchten, erstellen Sie eine App und wählen Sie Ihren Connector aus. Folgen Sie dazu der Anleitung unter Such-App erstellen.

• Eine Vorschau, wie Ihre Suchergebnisse nach der Einrichtung Ihrer App aussehen, finden Sie unter Suchergebnisse abrufen. Wenn Sie die Zugriffssteuerung für Drittanbieter verwendet haben, lesen Sie den Hilfeartikel Vorschauergebnisse für Apps mit Zugriffssteuerung für Drittanbieter.

Zendesk verknüpfen

So synchronisieren Sie Daten aus Zendesk mit Vertex AI Search:

Vorabversion:Sie müssen auf der Zulassungsliste stehen, um Drittanbieter-Connectors verwenden zu können.

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

Console

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 die nächste geplante Synchronisierung erwartet wird.

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

Nächste Schritte

• Wenn Sie Ihren Connector mit einer App verknüpfen möchten, erstellen Sie eine App und wählen Sie Ihren Connector aus. Folgen Sie dazu der Anleitung unter Such-App erstellen.

• Eine Vorschau, wie Ihre Suchergebnisse nach der Einrichtung Ihrer App aussehen, finden Sie unter Suchergebnisse abrufen. Wenn Sie die Zugriffssteuerung für Drittanbieter verwendet haben, lesen Sie den Hilfeartikel Vorschauergebnisse für Apps mit Zugriffssteuerung für Drittanbieter.