Übersicht

Der Jira Cloud-Connector 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-Connector unterstützt Version 2 der Jira Cloud REST API.

Unterstützte Aktionen

Wenn der Jira Cloud-Connector 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.

Zusätzlich zu diesen sind weitere schreibgeschützte Aktionen verfügbar.

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 aufzurufen.
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-Connector 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 über den Jira Cloud-Connector.

Beschränkungen

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

  • 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 dazu, wie Sie Aktionen nach dem Aktivieren von VPC Service Controls verwenden, finden Sie unter App mit VPC Service Controls schützen.

  • Der Jira Cloud-Datenspeicher wird nur an globalen Standorten sowie in den USA und der EU unterstützt.

  • Wenn Sie eine neue Anwendung erstellen oder einer vorhandenen Anwendung einen Datenspeicher hinzufügen, empfehlen wir, einen Datenspeicher mit Aktionen hinzuzufügen, die zu einem einzelnen Connectortyp gehören. Verknüpfen Sie beispielsweise nicht zwei Jira Cloud-Datenspeicher mit aktivierten Aktionen mit derselben Anwendung.

Im Folgenden sind die Einschränkungen für den Jira Cloud-Aufnahmeconnector aufgeführt:

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

  • Bei strukturierten Daten darf ein einzelnes 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.

  • Einschränkungen auf Arbeitsprotokollebene sind in Jira Cloud 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.

  • In Jira Cloud werden nur die letzten 20 Kommentare für einen Vorgang abgerufen.

  • Sprint-Tabellen können nicht aufgenommen werden.

  • Das alte Nutzerverwaltungsmodell wird für die Einbindung 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 Einheiten gespeichert und indexiert werden. Die Suche nach dem übergeordneten Problem anhand des Inhalts eines Anhangs wird nicht unterstützt.

Nächste Schritte