Übersicht

Mit dem Jira Cloud-Datenspeicher für Gemini Enterprise können Sie in Ihren Projekten, Problemen und Nutzerinformationen suchen und Aktionen 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 bestimmten Jira-Problem, um Feedback, Updates oder Notizen hinzuzufügen.
Kommentar aktualisieren Bearbeitet den Text eines vorhandenen Kommentars.
Problem erstellen Erstellt ein neues Problem in einem Jira Cloud-Projekt. Dazu müssen Sie eine Zusammenfassung, die Projekt-ID und die Problemtyp-ID angeben.
Problem aktualisieren Aktualisiert ein vorhandenes Problem in Jira Cloud. Sie müssen die Problem-ID angeben, um es zu identifizieren. Außerdem können Sie verschiedene Felder wie die Zusammenfassung, die Beschreibung und den Verantwortlichen ändern.
Problemstatus ändern Ändert den Status eines vorhandenen Problems in Jira Cloud. Sie müssen die Problem-ID angeben, um es zu identifizieren.
Anhang hochladen Lädt einen Anhang zu einem bestimmten Jira-Problem hoch.

Erforderliche Bereiche

Damit Gemini Enterprise mit dem Jira Cloud-Datenspeicher suchen und Aktionen 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 dem Assistant, Suchergebnisse und Nutzerdetails in Echtzeit abzurufen und anzuzeigen.
write:jira-work Ermöglicht dem Assistant, 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 Assistant, nach Problemen, Projekten und Nutzerprofilen zu suchen und diese aufzurufen.
Datenaufnahme und Aktionen read:jira-work Ermöglicht dem Assistant, eine umfassende Datenerfassung und ‑indexierung von Arbeitselementen durchzuführen.
write:jira-work Ermöglicht dem Assistant, Schreibaktionen (Erstellung, Aktualisierungen, Kommentare und Anhänge) für Arbeitselemente in der aufgenommenen Umgebung auszuführen.
Datenaufnahme read:jira-work Ermöglicht dem Assistant, 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 dem Datenspeicher, neue Kommentare oder Antworten direkt über die Suchoberfläche zu posten.
write:issue:jira Ermöglicht dem Datenspeicher, neue Probleme zu erstellen oder größere Änderungen an vorhandenen Problemen vorzunehmen.
write:attachment:jira Ermöglicht dem Datenspeicher, Anhänge zu Jira-Problemen 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, Problemübergänge zu lesen.
read:issue-meta:jira Ermöglicht dem Datenspeicher, Metadaten zu Problemen zu lesen.
read:board-scope.admin:jira-software Ermöglicht dem Datenspeicher, die Konfiguration, Projektfunktionen, Filter, Eigenschaften 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, Abfragen in der Jira Query Language (JQL) 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, Problemübergänge zu lesen.
read:issue-meta:jira Ermöglicht dem Datenspeicher, Metadaten zu Problemen zu lesen.
read:board-scope.admin:jira-software Ermöglicht dem Datenspeicher, die Konfiguration, Projektfunktionen, Filter, Eigenschaften 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:sprint:jira-software Ermöglicht dem Datenspeicher, Sprintdetails zu lesen.
read:issue-details:jira Ermöglicht dem Datenspeicher, Details zu Problemen zu lesen.
read:jql:jira Ermöglicht dem Datenspeicher, Abfragen in der Jira Query Language (JQL) zu lesen.
Datenaufnahme und Aktionen read:user:jira, read:group:jira, read:avatar:jira Ermöglicht die Synchronisierung von Nutzer-/Gruppenmetadaten und die Anzeige von Nutzerprofilen.
read:issue-security-level:jira, read:issue-security-scheme:jira Ermöglicht die Zugriffssteuerung und sorgt dafür, dass die aufgenommenen Daten die Sicherheitsgrenzen von Jira einhalten.
read:audit-log:jira Ermöglicht das Nachverfolgen von Änderungen und das Ausführen inkrementeller Synchronisierungen, um die aufgenommenen Daten auf dem neuesten Stand zu halten.
write:comment:jira Ermöglicht das Hinzufügen von Kommentaren zu Problemen mit dem Datenspeicher.
write:issue:jira Ermöglicht dem Assistant, 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 das Zuordnen 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.
read:sprint:jira-software Ermöglicht dem Datenspeicher, Sprintdetails zu lesen.

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 Ratenlimits 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, sollten Sie nur einen Datenspeicher mit Aktionen 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 in den global, us, und eu Standorten unterstützt.

Die folgenden Einschränkungen gelten für den Jira Cloud-Datenspeicher für die Aufnahme:

  • 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 anhand des Inhalts eines Anhangs, um das übergeordnete Problem zu finden, wird nicht unterstützt.

Nächste Schritte