Übersicht

Mit dem Jira Cloud-Datenspeicher für Gemini Enterprise können Sie Ihre Projekte, Probleme und Nutzerinformationen durchsuchen und Aktionen daran ausführen.

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 Erstellt einen neuen Kommentar zu einem angegebenen Jira-Vorgang, um Feedback, Updates oder Notizen hinzuzufügen.
Kommentar aktualisieren Bearbeitet den Text eines vorhandenen Kommentars.
Problem erstellen Erstellt 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 Aktualisiert einen vorhandenen Vorgang in Jira Cloud. 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 Problems in Jira Cloud. Sie müssen die Problem-ID angeben, um das Problem zu identifizieren.
Anhang hochladen Lädt einen Anhang in ein bestimmtes Jira-Ticket hoch.

Erforderliche Bereiche

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

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

Klassische Bereiche

Verbindungsmodus Berechtigung Zweck
Föderierte Suche und Aktionen read:jira-user, read:jira-work Ermöglicht es dem Assistenten, Suchergebnisse und Nutzerdetails in Echtzeit abzurufen und anzuzeigen.
write:jira-work Ermöglicht dem Assistenten, Arbeitselemente zu ändern (z. B. Problemfelder zu aktualisieren), Kommentare oder Probleme zu verwalten und Anhänge hochzuladen.
Nur föderierte Suche read:jira-user, read:jira-work Ermöglicht dem Assistenten, nach Problemen, Projekten und Nutzerprofilen zu suchen und diese aufzurufen.
Datenaufnahme und ‑aktionen read:jira-work Ermöglicht dem Assistenten, Arbeitsvorgänge umfassend zu crawlen und zu indexieren.
write:jira-work Ermöglicht dem Assistenten, Schreibvorgänge (Erstellung, Aktualisierungen, Kommentare und Anhänge) für Arbeitselemente in der aufgenommenen Umgebung auszuführen.
Datenaufnahme read:jira-work Ermöglicht dem Assistenten, Jira-Inhalte zu crawlen und zu indexieren, damit sie in der Suche verfügbar sind.

Detaillierte Bereiche

Verbindungsmodus Berechtigung Zweck
Föderierte Suche und Aktionen write:comment:jira Ermöglicht es dem Datenspeicher, neue Kommentare oder Antworten direkt über die Suchoberfläche zu posten.
write:issue:jira Ermöglicht es dem Datenspeicher, neue Probleme zu erstellen oder größere Änderungen an bestehenden vorzunehmen.
write:attachment:jira Ermöglicht dem Datenspeicher, Anhänge in Jira-Vorgänge hochzuladen.
read:issue:jira Ermöglicht dem Datenspeicher, Probleme zu lesen.
read:issue-type:jira Ermöglicht dem Datenspeicher, Problemtypen zu lesen.
read:comment:jira Ermöglicht dem Datenspeicher, Kommentare zu lesen.
read:comment.property:jira Ermöglicht dem Datenspeicher, Eigenschaften von Problemkommentaren zu lesen.
read:project:jira Ermöglicht dem Datenspeicher, Projekte zu lesen.
read:priority:jira Ermöglicht dem Datenspeicher, Prioritäten zu lesen.
read:issue.transition:jira Ermöglicht dem Datenspeicher, Vorgangsübergänge zu lesen.
read:issue-meta:jira Ermöglicht dem Datenspeicher, Problemmetadaten zu lesen.
read:board-scope.admin:jira-software Ermöglicht dem Datenspeicher, die Konfiguration, Projektfunktionen, Filter, Attribute und Schnellfilter für ein Board zu lesen.
read:board-scope:jira-software Ermöglicht dem Datenspeicher, Boards, Probleme auf einem Board, Probleme aus einem Backlog, Berichte und Versionen zu lesen.
read:issue-details:jira Ermöglicht dem Datenspeicher, Details zu Problemen zu lesen.
read:jql:jira Ermöglicht dem Datenspeicher, JQL-Abfragen (Jira Query Language) zu lesen.
Nur föderierte Suche read:issue:jira Ermöglicht dem Datenspeicher, Probleme zu lesen.
read:issue-type:jira Ermöglicht dem Datenspeicher, Problemtypen zu lesen.
read:comment:jira Ermöglicht dem Datenspeicher, Kommentare zu lesen.
read:comment.property:jira Ermöglicht dem Datenspeicher, Eigenschaften von Problemkommentaren zu lesen.
read:project:jira Ermöglicht dem Datenspeicher, Projekte zu lesen.
read:priority:jira Ermöglicht dem Datenspeicher, Prioritäten zu lesen.
read:issue.transition:jira Ermöglicht dem Datenspeicher, Vorgangsübergänge zu lesen.
read:issue-meta:jira Ermöglicht dem Datenspeicher, Problemmetadaten zu lesen.
read:board-scope.admin:jira-software Ermöglicht dem Datenspeicher, die Konfiguration, Projektfunktionen, Filter, Attribute und Schnellfilter für ein Board zu lesen.
read:board-scope:jira-software Ermöglicht dem Datenspeicher, Boards, Probleme auf einem Board, Probleme aus einem Backlog, Berichte und Versionen zu lesen.
read:issue-details:jira Ermöglicht dem Datenspeicher, Details zu Problemen zu lesen.
read:jql:jira Ermöglicht dem Datenspeicher, JQL-Abfragen (Jira Query Language) zu lesen.
Datenaufnahme und ‑aktionen read:user:jira, read:group:jira, read:avatar:jira Ermöglicht das Synchronisieren von Nutzer-/Gruppenmetadaten und das Anzeigen von Nutzerprofilen.
read:issue-security-level:jira, read:issue-security-scheme:jira Ermöglicht die Zugriffssteuerung, sodass die aufgenommenen Daten die Sicherheitsgrenzen von Jira einhalten.
read:audit-log:jira Ermöglicht das Erfassen von Änderungen und das Ausführen inkrementeller Synchronisierungen, um aufgenommene Daten auf dem neuesten Stand zu halten.
write:comment:jira Ermöglicht das Hinzufügen von Kommentaren zu Problemen über den Datenspeicher.
write:issue:jira Ermöglicht dem Assistenten, Probleme zu erstellen oder zu ändern.
Datenaufnahme read:user:jira, read:group:jira, read:avatar:jira Ermöglicht das Crawlen und Indexieren von Jira-Inhalten und Nutzerbeziehungen.
read:issue-security-level:jira, read:issue-security-scheme:jira Ermöglicht die Zuordnung von Berechtigungen, sodass nur autorisierte Nutzer die aufgenommenen Daten durchsuchen können.
read:audit-log:jira Ermöglicht der Synchronisierungs-Engine, zu erkennen, 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 App erstellen oder einer vorhandenen App 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 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