Übersicht

Der Jira Cloud-Datenspeicher für Gemini Enterprise bietet Zugriff auf Ihre Jira Cloud-Daten, sodass Sie mit Ihren Projekten, Vorgängen und Nutzerinformationen interagieren können.

Unterstützte Jira Cloud-Versionen

Der Jira Cloud-Datenspeicher unterstützt Version 2 der Jira Cloud REST API.

Unterstützte Aktionen

Wenn der Jira Cloud-Datenspeicher aktiviert ist, können Endnutzer in Gemini Enterprise Befehle in natürlicher Sprache verwenden, um die folgenden Aktionen auszuführen.

Aktion Beschreibung
Kommentar erstellen Erstellen Sie einen neuen Kommentar zu einem bestimmten Jira-Vorgang, um Feedback, Updates oder Notizen hinzuzufügen.
Kommentar aktualisieren Text eines vorhandenen Kommentars bearbeiten
Problem erstellen Erstellen Sie einen neuen Vorgang in einem Jira Cloud-Projekt. Dazu müssen Sie eine Zusammenfassung, die Projekt-ID und die ID des Problemtyps angeben.
Probleme mit Update Vorhandenen Vorgang in Jira Cloud aktualisieren Sie müssen die Problem-ID angeben, um das Problem zu identifizieren. Außerdem können Sie verschiedene Felder wie die Zusammenfassung, die Beschreibung und den zugewiesenen Nutzer ändern.
Problemstatus ändern Ändern Sie den Status eines vorhandenen Vorgangs in Jira Cloud. Sie müssen die Problem-ID angeben, um das Problem zu identifizieren.
Anhang hochladen Hängen Sie eine Datei an ein vorhandenes Problem in Jira Cloud an.

Erforderliche Bereiche

Damit Gemini Enterprise Suchvorgänge und Aktionen mit dem Jira Cloud-Datenspeicher ausführen kann, benötigen Sie die folgenden Bereiche:

Verbindungsmodus Umfang Zweck
Föderierte Suche und Aktionen read:jira-user, read:jira-work Erforderlich, um Suchergebnisse und Nutzerdetails in Echtzeit abzurufen und anzuzeigen.
write:jira-work Ermöglicht dem Assistenten, Arbeitselemente zu ändern, z.B. indem er Problemfelder aktualisiert.
write:comment:jira Ermöglicht es dem Assistenten, neue Kommentare oder Antworten direkt über die Suchoberfläche zu posten.
write:issue:jira Erforderlich, um neue Probleme zu erstellen oder größere Änderungen an bestehenden Problemen vorzunehmen.
Nur föderierte Suche read:jira-user, read:jira-work Erforderlich, um nach Problemen, Projekten und Nutzerprofilen zu suchen und diese anzusehen.
Datenaufnahme und ‑aktionen read:jira-work, read:user:jira, read:group:jira, read:avatar:jira Erforderlich für die vollständige Datenerfassung und die Synchronisierung von Nutzer-/Gruppenmetadaten.
read:issue-security-level:jira, read:issue-security-scheme:jira Wichtig für die Zugriffssteuerung; sorgt dafür, dass die aufgenommenen Daten die Sicherheitsgrenzen von Jira einhalten.
read:audit-log:jira Wird verwendet, um Änderungen zu verfolgen und inkrementelle Synchronisierungen durchzuführen, damit aufgenommene Daten auf dem neuesten Stand bleiben.
write:jira-work Erforderlich, um Schreibvorgänge für Arbeitselemente in der aufgenommenen Umgebung auszuführen.
write:comment:jira Erforderlich, um mit dem Assistenten Kommentare zu Problemen hinzuzufügen.
write:issue:jira Ermöglicht das Erstellen oder Ändern von Problemen.
Datenaufnahme read:jira-work, read:user:jira, read:group:jira, read:avatar:jira Erforderlich, um Jira-Inhalte und Nutzerbeziehungen zu crawlen und zu indexieren.
read:issue-security-level:jira, read:issue-security-scheme:jira Erforderlich, um Berechtigungen zuzuordnen, damit nur autorisierte Nutzer die aufgenommenen Daten durchsuchen können.
read:audit-log:jira Erforderlich, damit die Synchronisierungs-Engine erkennen kann, welche Elemente aktualisiert oder gelöscht wurden.

Informationen zum Konfigurieren dieser Bereiche finden Sie unter Mindestbereich für Anwendungen konfigurieren.

Ratenlimits für die Datenaufnahme

Der Jira Cloud-Datenspeicher unterstützt ein Standardratenlimit von 12 Abfragen pro Sekunde (Queries per Second, QPS) für die Datenaufnahme. Diese Ratenbeschränkungen gelten ausschließlich für die Aufnahme von Daten aus dem Jira Cloud-Datenspeicher.

Beschränkungen

In diesem Abschnitt werden bekannte Probleme und Einschränkungen beschrieben, die sich auf die Verwendung des Jira Cloud-Datenspeichers auswirken können.

  • Wenn Sie eine neue Anwendung erstellen oder einer vorhandenen Anwendung einen Datenspeicher hinzufügen, empfehlen wir, nur einen Datenspeicher mit Aktionen zu verknüpfen, die zu einem einzelnen Connectortyp gehören.
  • Das Erzwingen eines VPC Service Controls-Perimeters für vorhandene Jira Cloud-Datenspeicher wird nicht unterstützt. Wenn Sie VPC Service Controls erzwingen möchten, müssen Sie die Datenspeicher löschen und neu erstellen. Weitere Informationen zu VPC Service Controls und zur Verwendung von Aktionen nach dem Aktivieren von VPC Service Controls finden Sie unter App mit VPC Service Controls schützen.

  • Der Jira Cloud-Datenspeicher unterstützt keine .xlsx-Dateien für die Upload-Aktion.

  • Der Jira Cloud-Datenspeicher wird nur an den Standorten Global, US und EU unterstützt.

Die folgenden Einschränkungen gelten für den Jira Cloud-Aufnahmedatenspeicher:

  • Für unstrukturierte Daten gelten für jeden Medientyp unterschiedliche Einschränkungen. Weitere Informationen finden Sie unter Daten für benutzerdefinierte Datenquellen vorbereiten.

  • Bei strukturierten Daten darf jedes Dokument nicht größer als 500 KB sein.

  • Anwendungsrollen mit bestimmten, nicht leeren Rollen können weder Browse project-Berechtigungen noch Berechtigungen auf Sicherheitsebene erhalten.

  • Dokumentberechtigungen, die durch benutzerdefinierte Nutzerfelder oder benutzerdefinierte Gruppenfelder bestimmt werden, werden nicht unterstützt.

  • In Jira Cloud sind Einschränkungen auf der Ebene von Arbeitslogs nicht möglich.

  • PDF-Anhänge mit mehr als 2.000 Seiten werden in Jira Cloud nicht indexiert.

  • Anhänge, die privaten Kommentaren hinzugefügt werden, übernehmen nicht die Zugriffsbeschränkungen (ACLs) für die Kommentare.

  • Es werden nur die letzten 20 Kommentare für ein Problem in Jira Cloud abgerufen.

  • Sprint-Tabellen können nicht aufgenommen werden.

  • Das alte Nutzerverwaltungsmodell wird für die Integration in Jira Cloud nicht unterstützt. Es wird nur das Modell der zentralen Nutzerverwaltung unterstützt. Weitere Informationen finden Sie im Leitfaden zur Konsolidierung von Atlassian-Organisationen.

  • Wenn Sie eine Jira-Entität abfragen, z. B. eine Ausgabe, werden zugehörige Daten wie Kommentare und Anhänge nicht automatisch berücksichtigt. Das liegt daran, dass sie als separate Entitäten gespeichert und indexiert werden. Die Suche nach dem übergeordneten Problem anhand des Inhalts eines Anhangs wird nicht unterstützt.

Nächste Schritte