Jira Cloud-Datenspeicher einrichten

Öffentliche Vorschau:Die Funktionen für die föderierte Suche und Aktionen sind in der öffentlichen Vorschau verfügbar. Diese Funktion unterliegt den „Pre-GA-Angebotsbedingungen“ im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA‑Funktionen stehen in der vorliegenden Form zur Verfügung und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie unter Beschreibungen der Startphase.

Auf dieser Seite wird beschrieben, wie Sie einen Datenspeicher erstellen und Jira Cloud mit Gemini Enterprise verbinden.

Hinweise

Achten Sie vor dem Einrichten der föderierten Jira Cloud-Verbindung auf Folgendes:

• Weisen Sie dem Nutzer die Rolle „Discovery Engine Editor“ (roles/discoveryengine.editor) zu. Diese Rolle ist erforderlich, damit der Nutzer den Datenspeicher erstellen kann. So weisen Sie diese Rolle zu:

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

     IAM aufrufen

  2. Lokalisieren Sie das Nutzerkonto und klicken Sie auf das Symbol Bearbeiten.
  3. Weisen Sie dem Nutzer die Rolle Discovery Engine Editor zu: Weitere Informationen finden Sie unter IAM-Rollen und -Berechtigungen.

• Wenn Sie die Zugriffssteuerung für Datenquellen erzwingen und Daten in Google Gemini Enterprise schützen möchten, konfigurieren Sie Ihren Identitätsanbieter.

• Um den Jira Cloud-Datenspeicher einzurichten, müssen Sie das neue zentralisierte Atlassian-Nutzerverwaltungsmodell verwenden. Wenn Sie das ursprüngliche Modell verwenden, müssen Sie die Nutzerverwaltung migrieren, bevor Sie fortfahren. Weitere Informationen finden Sie unter Rolle „Websiteadministrator“.

• Erstellen Sie eine OAuth 2.0-App, rufen Sie die Client-ID und den Clientschlüssel ab und konfigurieren Sie die Mindestanwendungsberechtigungen mit Zustimmung eines Jira Cloud-Administrators. Prüfen Sie, ob Sie in Jira als Administrator der Organisation Zugriff auf die Jira-Instanz und das Projekt haben. Mit dem Zugriff als Administrator der Organisation können Sie Mindestberechtigungen einrichten und Nutzergruppen Zugriffsrechte gewähren.

• Optional: Wenn Sie Nutzer-E-Mail-Adressen aus Jira Cloud abrufen möchten (selbst wenn die Sichtbarkeit von E-Mail-Adressen durch Einstellungen eingeschränkt ist), müssen Sie die App User Identity Accessor for Jira Cloud installieren. Sie benötigen die Jira-Website-Administrator-Berechtigungen, um diese App zu installiert und zum sicheren Abrufen von Nutzer-E-Mails zu konfigurieren. Falls die E-Mail-Adressen bereits öffentlich zugänglich sind müssen Sie diese App nicht unbedingt installieren.

  Hinweis: Atlassian aktualisiert Elemente der Benutzeroberfläche. Einige Elemente, die in dieser Dokumentation erwähnt werden, werden umbenannt. So wird beispielsweise Produkte in Anwendungen umbenannt. Weitere Informationen finden Sie unter Änderung der Atlassian-Administratorterminologie von „Produkte“ zu „Anwendungen“.

Jira Cloud-Datenspeicher erstellen

So erstellen Sie einen Jira Cloud-Datenspeicher:

1. Rufen Sie in der Google Cloud Console die Seite Gemini Enterprise auf.

   Gemini Enterprise

2. Projekt auswählen oder erstellen Google Cloud .

3. Klicken Sie im Navigationsmenü auf Datenspeicher.

4. Klicken Sie auf Datenspeicher erstellen.

5. Suchen Sie im Abschnitt Quelle nach Jira Cloud und klicken Sie auf Auswählen.

6. Im Abschnitt Daten:

   1. Wählen Sie im Abschnitt Connector-Modus als Verbindungsmodus Datenaufnahme oder Föderierte Suche aus.

   2. Klicken Sie auf Weiter.

   3. Konfigurieren Sie im Abschnitt Authentifizierungseinstellungen die Authentifizierung entsprechend dem ausgewählten Verbindungsmodus.

      1. Geben Sie die folgenden Authentifizierungsdetails an:

         • Client-ID: Die Kennung für Ihre OAuth 2.0-App.
         • Clientschlüssel: Der geheime Schlüssel, der mit Ihrer OAuth 2.0-App verknüpft ist.
         • Instanz-URI: Die Basis-URL Ihrer Jira Cloud-Instanz (z. B. https://your-domain.atlassian.net).
         • Instanz-ID: Eine eindeutige Kennung für Ihre Jira Cloud-Instanz.

         Weitere Informationen zum Abrufen dieser Anmeldedaten finden Sie unter Jira Cloud-Konfiguration.

      2. Wenn Sie Föderierte Suche ausgewählt haben, klicken Sie auf Anmelden und schließen Sie die Atlassian-Anmeldung ab.

      3. Klicken Sie auf Weiter.

   4. Geben Sie im Bereich Ziele die URL zu Ihrem Jira Cloud-Endpunkt ein.

   5. Klicken Sie auf Weiter.

   6. Gehen Sie im Bereich Zu durchsuchende Entitäten (falls Sie Föderierte Suche ausgewählt haben) oder Zu synchronisierende Entitäten (falls Sie Datenaufnahme ausgewählt haben) so vor:

      1. Wählen Sie alle erforderlichen Entitäten aus.
      2. Wenn Sie Föderierte Suche ausgewählt haben, fahren Sie mit dem nächsten Schritt fort.
      3. Wenn Sie Datenaufnahme ausgewählt haben, fahren Sie mit den folgenden Schritten fort:
         1. Optional können Sie bestimmte Projekte so synchronisieren:
            1. Klicken Sie auf Filtern.
            2. Wenn Sie Entitäten aus dem Index herausfiltern möchten, wählen Sie Aus Index ausschließen. Wenn Sie dafür sorgen möchten, dass sie im Index enthalten sind, wählen Sie In den Index aufnehmen.
            3. Geben Sie den Projektschlüssel ein. Drücken Sie nach jedem Projektschlüssel die Eingabetaste. Weitere Informationen zum Abrufen des Projektschlüssels finden Sie unter Projektschlüssel abrufen.
            4. Klicken Sie auf Speichern.
         2. So konfigurieren Sie den Synchronisierungs-Zeitplan:
            1. Wählen Sie in der Liste Synchronisierungshäufigkeit die Synchronisierungshäufigkeit aus.
               • Wenn Sie separate vollständige Synchronisierungen von Entitäts- und Identitätsdaten planen möchten, maximieren Sie das Menü im Abschnitt Vollständige Synchronisierung und wählen Benutzerdefinierte Optionen aus.
            2. Wählen Sie in der Liste Häufigkeit der inkrementellen Synchronisierung die Häufigkeit der inkrementellen Synchronisierung aus. Weitere Informationen finden Sie unter Synchronisierungszeitpläne.

7. Klicken Sie auf Weiter.

8. Im Bereich Aktionen:

   • Falls Sie Föderierte Suche ausgewählt haben, wählen Sie im Abschnitt Jira Cloud-Aktionen auswählen, die aktiviert werden sollen die Aktionen aus, die für den Datenspeicher aktiviert werden sollen.

   • Falls Sie Datenaufnahme ausgewählt haben:

     1. Im Abschnitt Authentifizierungseinstellungen:

        1. Geben Sie die folgenden Authentifizierungsdetails an:
           • Client-ID: Die Kennung für Ihre OAuth 2.0-App.
           • Clientschlüssel: Der geheime Schlüssel, der mit Ihrer OAuth 2.0-App verknüpft ist.
           • Instanz-URI: Die Basis-URL Ihrer Jira Cloud-Instanz (z. B. https://your-domain.atlassian.net).
           • Instanz-ID: Eine eindeutige Kennung für Ihre Jira Cloud-Instanz.

        Weitere Informationen zu Anmeldedaten finden Sie unter Jira Cloud-Konfiguration.

        1. Klicken Sie auf Anmelden und melden Sie sich in Jira Cloud an, um Ihr Konto zu bestätigen.

     2. Klicken Sie auf Weiter.

     3. Wählen Sie unter Jira Cloud-Aktionen auswählen, die aktiviert werden sollen die Aktionen aus der Kategorie aus, um sie für den Datenspeicher zu aktivieren.

     Hinweis: Wenn Sie in diesem Schritt keine Aktionen hinzufügen, können Sie dies später nachholen. Weitere Informationen finden Sie unter Aktionen hinzufügen.

     Informationen zum Verwalten der Liste der Aktionen finden Sie unter Aktionen verwalten.

9. Klicken Sie auf Weiter.

10. Im Abschnitt Konfiguration:

    1. Wählen Sie in der Liste Multiregional den Speicherort für den Daten-Connector aus.
    2. Geben Sie im Feld Name des Daten-Connectors einen Namen für den Connector ein.
    3. Wenn Sie US oder EU als Speicherort gewählt haben, konfigurieren Sie die Verschlüsselungseinstellungen:
       • Optional: Wenn Sie keine Schlüssel für einzelne Regionen konfiguriert haben, klicken Sie auf Zur Einstellungsseite, um dies zu tun. Weitere Informationen finden Sie unter Cloud KMS-Schlüssel für eine einzelne Region für Drittanbieter-Connectors registrieren.
       • Wählen Sie Google-verwalteter Verschlüsselungsschlüssel oder Cloud KMS-Schlüssel aus.
       • Falls Sie Cloud KMS-Schlüssel ausgewählt haben:
         • Wählen Sie in der Liste Schlüsselverwaltungstyp den entsprechenden Typ aus.
         • Wählen Sie in der Liste Cloud KMS-Schlüssel den Schlüssel aus.
       Weitere Informationen finden Sie unter Kundenverwaltete Verschlüsselungsschlüssel.

11. Klicken Sie auf Weiter.

12. Wählen Sie im Bereich Abrechnung die Option Allgemeine Preise oder die Option Konfigurierbare Preise aus. Weitere Informationen finden Sie unter Abrechnungsstatus Ihrer Projekte prüfen und Lizenzen.

13. Klicken Sie auf Erstellen. Gemini Enterprise erstellt den Datenspeicher und zeigt ihn auf der Seite Datenspeicher an.

Klicken Sie auf der Seite Datenspeicher auf den Namen des Datenspeichers, um den Status anzuzeigen. Sobald sich der Status des Datenspeichers von Wird erstellt zu Aktiv ändert, ist der Jira Cloud-Datenspeicher einsatzbereit.

Bei einem mit Jira Cloud erstellten Datenspeicher für die Aufnahme ändert sich der Status des Datenspeichers zu Beginn der Synchronisierung von Wird erstellt zu Wird ausgeführt. Sobald die Aufnahme abgeschlossen ist, ändert sich der Status in Aktiv. Das bedeutet, dass der Datenspeicher vollständig konfiguriert ist. Je nach Datenvolumen kann die Aufnahme mehrere Stunden dauern.

Nachdem Sie den Datenspeicher erstellt haben, erstellen Sie eine App, verbinden diese mit dem Jira Cloud-Datenspeicher und autorisieren Gemini Enterprise für den Zugriff auf Jira Cloud, bevor Sie Abfragen ausführen.

Echtzeitsynchronisierung für die Datenaufnahme aktivieren

Vorschau – Real-time sync

Diese Funktion unterliegt den Bedingungen für Pre‑GA-Angebote im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Funktionen stehen in der vorliegenden Form zur Verfügung und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie in den Beschreibungen der Produkteinführungsphasen.

Bei der Echtzeitsynchronisierung werden nur Dokumententitäten synchronisiert, keine Daten, die sich auf Identitätsentitäten beziehen. Die folgende Tabelle zeigt, welche Dokumentereignisse mit der Echtzeitsynchronisierung unterstützt werden.

Jira-Entitäten	Erstellen	Aktualisieren	Löschen	Berechtigungsänderungen
Probleme
Arbeitslogs
Projekte
Kommentare
Anhänge

So aktivieren Sie die Echtzeitsynchronisierung für einen Jira Cloud-Datenspeicher:

Webhook-URL generieren

1. Rufen Sie die Seite „Gemini Enterprise“ auf und klicken Sie im Navigationsmenü auf Datenspeicher.
2. Wählen Sie einen Jira Cloud-Datenspeicher aus.

3. Klicken Sie in der Zeile Echtzeitsynchronisierung auf Ansehen/Bearbeiten.

4. Führen Sie im Dialogfeld Parameter der Echtzeitsynchronisierung ansehen und bearbeiten folgende Schritte aus:

   1. Klicken Sie auf die Ein/Aus-Schaltfläche Echtzeitsynchronisierung aktivieren, um die Option zu aktivieren.
   2. Geben Sie einen Wert in das Feld Clientschlüssel ein und kopieren Sie ihn. Sie benötigen diesen Wert später noch einmal, um einen Webhook in der Jira-Verwaltungskonsole zu erstellen.
   3. Klicken Sie auf Speichern.

5. Wenn sich der Status von Echtzeitsynchronisierung in Running ändert, klicken Sie auf Ansehen/Bearbeiten.

6. Führen Sie im Dialogfeld Parameter der Echtzeitsynchronisierung ansehen und bearbeiten folgende Schritte aus:

   1. Kopieren Sie die URL unter Webhook URL (Webhook-URL).
   2. Klicken Sie auf Schließen.

Webhook erstellen

1. Melden Sie sich in der Jira-Verwaltungskonsole an.
2. Klicken Sie auf Settings (Einstellungen) und wählen Sie System aus.
3. Wählen Sie im Bereich System settings (Systemeinstellungen) die Option Webhooks aus.
4. Klicken Sie auf Create a webhook (Webhook erstellen). Informationen zu Webhooks finden Sie unter Webhooks.
5. Geben Sie einen Namen für den Webhook ein.
6. Wählen Sie für den Status Enabled aus.
7. Fügen Sie in das Feld URL die URL ein, die Sie aus Gemini Enterprise kopiert haben, und hängen Sie /{issue.id} an.

8. Geben Sie im Feld Secret den Wert ein, den Sie beim Generieren einer Webhook-URL in Gemini Enterprise eingegeben haben.

   Hinweis: Um die Datenkonsistenz zu gewährleisten und Fehler bei der Konfiguration von Webhooks in Jira zu vermeiden, sollten Sie nur Entitäten auswählen, die für die Synchronisierung in Ihrem Datenspeicher aktiviert sind.

9. Wählen Sie im Bereich Problembezogene Ereignisse die folgenden Optionen aus:

   Entitäten	Erstellt	Aktualisiert	Gelöscht
   Problem	Ja	Ja	Ja
   Arbeitslog	Ja	Ja	Ja
   Kommentar	Ja	Ja	Ja
   Anhang	Ja	Nein	Ja

10. Markieren Sie im Bereich Projektbezogene Ereignisse die Kästchen erstellt, aktualisiert und gelöscht für die Einheit Projekt.

11. Klicken Sie auf Erstellen.

Datenverarbeitung und Abfrageausführung

In diesem Abschnitt wird beschrieben, wie Gemini Enterprise Ihre Anfrage verarbeitet und welche Auswirkungen die Verwendung des föderierten Datenspeichers auf den Datenschutz hat.

Ausführung von Abfragen

Nachdem Sie Jira Cloud autorisiert und eine Suchanfrage an Gemini Enterprise gesendet haben, passiert Folgendes:

• Gemini Enterprise sendet Ihre Suchanfrage direkt an die Atlassian API.
• Gemini Enterprise kombiniert die Ergebnisse mit denen aus anderen verbundenen Datenquellen und zeigt ein umfassendes Suchergebnis an.

Datenverarbeitung

Wenn Sie eine föderierte Suche von Drittanbietern verwenden, gelten folgende Regeln für die Datenverarbeitung:

• Ihr Abfragestring wird an das Such-Backend des Drittanbieters (Atlassian API) gesendet.
• Diese Drittanbieter können Abfragen mit Ihrer Identität verknüpfen.
• Wenn mehrere Datenquellen für die föderierte Suche aktiviert sind, wird die Abfrage möglicherweise an alle gesendet.
• Sobald die Daten im Drittanbietersystem angekommen sind, unterliegen sie den Nutzungsbedingungen und Datenschutzbestimmungen dieses Systems.

Hinweis: Um die Genauigkeit zu verbessern, kann ein LLM Ihre Anfrage umschreiben, bevor sie an Jira Cloud gesendet wird. Diese neu formulierte Abfrage kann Informationen aus dem Abfrageverlauf Ihrer Sitzung enthalten. Daher können Teile Ihres Suchanfragenverlaufs auch in die Anfrage aufgenommen werden, die an die Atlassian API gesendet wird.

Nächste Schritte

• Wenn Sie eine Benutzeroberfläche für das Abfragen Ihrer Jira Cloud-Daten bereitstellen möchten, erstellen Sie eine App und verbinden diese mit dem Jira Cloud-Datenspeicher.
• Informationen zum Verwalten der Liste der Aktionen finden Sie unter Aktionen verwalten.
• Um eine Vorschau darüber zu erhalten, wie Ihre Suchergebnisse aussehen, nachdem Ihre App eingerichtet ist, gehen Sie auf Suchergebnisse abrufen.
• Informationen zum Aktivieren von Benachrichtigungen für den Datenspeicher finden Sie unter Benachrichtigungen für Drittanbieter-Datenspeicher konfigurieren.