Übersicht

Mit dem Jira Cloud-Datenspeicher für Gemini Enterprise können Sie in Ihren Projekten, Vorgängen 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-Vorgang, um Feedback, Updates oder Notizen hinzuzufügen.
Kommentar aktualisieren Bearbeitet den Text eines vorhandenen Kommentars.
Vorgang erstellen Erstellt einen neuen Vorgang in einem Jira Cloud-Projekt. Dazu müssen Sie eine Zusammenfassung, die Projekt-ID und die Vorgangstyp-ID angeben.
Vorgang aktualisieren Aktualisiert einen vorhandenen Vorgang in Jira Cloud. Sie müssen die Vorgangs-ID angeben, um ihn zu identifizieren. Außerdem können Sie verschiedene Felder wie die Zusammenfassung, die Beschreibung und den Verantwortlichen ändern.
Vorgangsstatus ändern Ändert den Status eines vorhandenen Vorgangs in Jira Cloud. Sie müssen die Vorgangs-ID angeben, um ihn zu identifizieren.
Anhang hochladen Lädt einen Anhang zu einem bestimmten Jira-Vorgang hoch.
Vorgang zuweisen Weist einen vorhandenen Jira-Vorgang einem bestimmten Nutzer zu.
Vorgänge verknüpfen Erstellt eine Verknüpfung zwischen zwei Jira-Vorgängen (z. B. „blockiert“, „wird blockiert von“, „bezieht sich auf“).
Projekt erstellen Erstellt ein neues Jira-Projekt mit einem bestimmten Namen, Schlüssel, Projekttyp und einer bestimmten Vorlage.
Projekt aktualisieren Aktualisiert die Einstellungen eines vorhandenen Jira-Projekts, z. B. Name, Schlüssel, Beschreibung oder Verantwortlicher.
Arbeitslog erstellen Fügt einem Jira-Vorgang einen Arbeitslogeintrag für die Zeiterfassung hinzu.
Arbeitslog aktualisieren Aktualisiert einen vorhandenen Arbeitslogeintrag für einen Jira-Vorgang.
Board abrufen Ruft ein Board in Jira ab.
Vorgänge für Board abrufen Ruft Vorgänge für ein Board in Jira ab.
Boards auflisten Listet Boards in Jira auf.

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. Vorgangsfelder zu aktualisieren), Kommentare oder Vorgänge zu verwalten und Anhänge hochzuladen.
manage:jira-project Ermöglicht dem Assistant, Jira-Projekteinstellungen zu verwalten und neue Objekte auf Projektebene zu erstellen, z. B. Versionen und Komponenten. Erforderlich für die Aktionen zum Erstellen und Aktualisieren von Projekten.
Nur föderierte Suche read:jira-user, read:jira-work Ermöglicht dem Assistant, nach Vorgängen, 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 Gemini Enterprise-Oberfläche zu posten.
write:issue:jira Ermöglicht dem Datenspeicher, neue Vorgänge zu erstellen oder größere Änderungen an vorhandenen Vorgängen vorzunehmen.
write:attachment:jira Ermöglicht dem Datenspeicher, Anhänge zu Jira-Vorgängen hochzuladen.
write:project:jira Ermöglicht dem Datenspeicher, Jira-Projekte zu erstellen und zu aktualisieren.
write:issue-worklog:jira Ermöglicht dem Datenspeicher, Arbeitslogs für Vorgänge zu erstellen und zu aktualisieren.
write:issue-link:jira Ermöglicht dem Datenspeicher, Verknüpfungen zwischen Vorgängen zu erstellen und zu aktualisieren.
read:issue:jira Ermöglicht dem Datenspeicher, Vorgänge zu lesen.
read:issue-type:jira Ermöglicht dem Datenspeicher, Vorgangstypen zu lesen.
read:comment:jira Ermöglicht dem Datenspeicher, Kommentare zu lesen.
read:comment.property:jira Ermöglicht dem Datenspeicher, Eigenschaften von Vorgangskommentaren 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, Vorgangsmetadaten 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, Vorgänge auf einem Board, Vorgänge aus einem Backlog, Berichte und Versionen zu lesen.
read:issue-details:jira Ermöglicht dem Datenspeicher, Vorgangsdetails 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, Vorgänge zu lesen.
read:issue-type:jira Ermöglicht dem Datenspeicher, Vorgangstypen zu lesen.
read:comment:jira Ermöglicht dem Datenspeicher, Kommentare zu lesen.
read:comment.property:jira Ermöglicht dem Datenspeicher, Eigenschaften von Vorgangskommentaren 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, Vorgangsmetadaten 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, Vorgänge auf einem Board, Vorgänge 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, Vorgangsdetails 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 stellt sicher, 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 Vorgängen über den Datenspeicher.
write:issue:jira Ermöglicht dem Assistant, Vorgänge 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 der Anwendung konfigurieren.

Ratenlimits für die Datenaufnahme

Der Jira Cloud-Datenspeicher unterstützt eine Standard-Ratenbegrenzung von 12 Abfragen pro Sekunde (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 einem vorhandenen Datenspeicher einen Datenspeicher hinzufügen, empfiehlt es sich, 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 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 den übergeordneten Vorgang zu finden, wird nicht unterstützt.

Nächste Schritte