Jira Integration

Mittels Jira Integration können Sie Ihr unternehmenseigenes Jira Datacenter als Datenquelle an Business GPT anbinden. Mittels dieser Integration liest Business GPT Jira-Ticketinhalte und speichert und indexiert diese intern, sodass anschließend mit diesen Ticketinhalten gechattet werden kann. Die Organisation und Verwaltung von Jira-Ticketinhalten erfolgt projektbasiert. Das heißt, dass Sie eines oder mehrere Jira-Projekte importieren und unterschiedlichen Nutzergruppen diese Projektinhalte zugänglich machen können. Je Jira-Projekt können Sie jeweils eine Jira-Integration anlegen.

Jira Integration einrichten

Um ein neues Jira-Projekt mit Business GPT zu synchronisieren, wählen Sie in der Administration unter Integrationen in der Übersicht Neue Integration anlegen (Typ Jira Datacenter). Die Einstellungen sind auf drei Tabs verteilt: Konfiguration, Zugriff und Zeitplanung.

Tab „Konfiguration"

Hier konfigurieren Sie Verbindung, Zugangsdaten und Einstellungen für die Integration.

Feld	Beschreibung
Name	Legen Sie hier die Bezeichnung für die Integration bzw. das Jira Projekt fest
Beschreibung	Beschreiben Sie optional das Projekt
JIRA Verbindungs-Einstellungen	Geben Sie hier den JIRA Zugriffstoken des zu verwendenden (Service-) Accounts sowie JIRA Endpunkt (URL) und den JIRA Projekt(schlüssel) an.

Tab „Zugriff"

Hier legen Sie fest, zu welchem Bereich die Integration gehört und welche Benutzergruppen sie verwenden dürfen.

Feld	Beschreibung
Bereich	Nur sichtbar, wenn die Funktion Bereiche aktiviert ist. Legt fest, welchem Bereich die Integration zugeordnet ist und damit, welche Bereichsadministratoren sie verwalten dürfen — unabhängig von der Benutzergruppen-Einschränkung. Die Auswahl ist beim Anlegen nur relevant, wenn Sie die Integration als Bereichsadministrator erstellen (dann Pflichtfeld, beschränkt auf Ihre eigenen Bereiche). Ein Administrator (Rolle admin) legt Integrationen ohne Bereichszuweisung an.
Benutzergruppen-Einschränkung	Legen Sie hier fest, welche Benutzergruppen die Jira-Integration im Chat verwenden dürfen. Wird keine Gruppe zugewiesen (Anzeige „Keine Benutzergruppen-Einschränkung"), ist die Integration für alle Nutzer:Innen nutzbar; sind eine oder mehrere Gruppen ausgewählt, können nur deren Mitglieder die Integration verwenden. Bitte beachten Sie, dass Business GPT keine Berechtigungsgruppen oder -strukturen aus Ihrem Jira Datacenter synchronisiert.

Bereich nachträglich zuweisen oder zurückgeben

Ist die Funktion Bereiche aktiviert, erfolgt die Bereichszuordnung beim Bearbeiten der Integration rollenabhängig: Ein Administrator (Rolle admin) weist eine noch nicht zugewiesene Integration einem Bereich zu und übergibt sie damit an dessen Bereichsadministratoren (danach für den Administrator schreibgeschützt). Ein Bereichsadministrator kann die Bereichszuweisung entfernen und die Integration so in den nicht zugewiesenen Zustand zurückgeben oder sie in einen anderen seiner Bereiche verschieben. Details siehe Inhalte einem Bereich zuweisen.

Tab „Zeitplanung"

Hier richten Sie optional automatische Synchronisierungszeitpläne ein. Die Synchronisierung läuft außerhalb der üblichen Geschäftszeiten zwischen Mitternacht und 5 Uhr morgens.

Option	Beschreibung
Kein Zeitplan	Import und Indizierung müssen manuell gestartet werden (Standard).
Täglich	Der Import wird jeden Tag ausgeführt.
Wöchentlich	Der Import wird an ausgewählten Wochentagen ausgeführt.
Monatlich	Der Import wird an einem bestimmten Tag des Monats ausgeführt.

Verbindung testen

Um zu prüfen, ob Ihre Jira-Verbindungsdaten korrekt sind, können Sie die Verbindung vorab testen. Stellen Sie zunächst sicher, dass Sie die Integrationsdaten vorab gespeichert haben.

Import und Indizierung starten

Um den Import- und Indizierungsvorgang zu starten wählen Sie Import und Indizierung starten. Anschließend werden die Ticketdaten des ausgewählten Jira-Projekts importiert.

Import-Dauer

Die Dauer des Imports ist von der Gesamtanzahl von Jira-Tickets abhängig. Je mehr Tickets importiert werden, desto länger dauert der intiale Importvorgang.

Die Gesamtanzahl an Jira-Tickets können Sie über die Statusanzeige nachvollziehen.

Jira Integration verwenden

Um eine Jira Integration zum Chatten mit den Projektinhalten zu verwenden, können Sie entweder den Standard Assistenten Dokumenten Chatverwenden oder einen indiviudellen Assistenten erstellen und diesem die gewünschte Jira-Integration zuweisen (siehe Assistenten).

Wenn Sie die Jira-Integration im Dokumenten Chatverwenden, können Sie über Wissen filtern direkt auf den Jira-Inhalt zugreifen.

Funktionsweise

Die Jira Integration liest Ticketinhalte aus den konfigurierten Jira-Projekten über die Jira API aus. Die importierten Ticketinhalte werden anschließend in kleinere Abschnitte (Chunks) aufgeteilt, als Vektoren indexiert und in der internen Wissensdatenbank von Business GPT gespeichert. Bei einer Chatanfrage durchsucht Business GPT diese Wissensdatenbank nach relevanten Inhalten und übergibt die passenden Treffer als Kontext an das Sprachmodell (RAG – Retrieval Augmented Generation). Auf diese Weise können Nutzer:Innen gezielt mit den Jira-Projektinhalten interagieren, ohne dass der gesamte Ticketbestand bei jeder Anfrage verarbeitet werden muss.

Häufige Fragen zur Jira Integration

Welche Kosten verursacht der Import von Jira-Inhalten?

Beim Import und der anschließenden Indexierung der Jira-Ticketinhalte werden Embedding-Token (Index-Token, text-embedding-ada-002) verbraucht. Pro 1 Mio Token betragen die Kosten 0,1 €. Als Näherungswert können Sie im Mittel in etwa von 300 Token pro Ticket ausgehen. Basierend auf diesem Näherungswert würden sich die Kosten bei 10.000 Tickets auf ca. 0,30 Cent belaufen.

Werden Ticketanhänge wie Dokumente oder Bilder ebenfalls importiert?

Nein, der Import verarbeitet aktuell keine Ticket-Anhänge.

Kann ich mit der Jira-Integration Tickets erstellen?

Nein, bei der Jira Integration handelt es sich um eine Datenquellen-Integration, bei der ausschließlich lesend auf die Ticketdaten in Ihrem Jira zugegriffen wird. Sie können jedoch für diesen Fall Function Calling verwenden.

Wird das gesamte Jira-System importiert?

Nein, Sie können die Jira-Inhalte projektweise importieren und somit nur ausgewählte und gewünschte Projekte in Business GPT verfügbar machen.

Werden die Berechtigungen auf Jira-Seite beim Import berücksichtigt und übernommen?

Nein, Berechtigungen in Ihrem Jira werden nicht automatisch übernommen. Stattdessen können Sie ausgewählten Benutzergruppen die Jira-Integration erlauben, indem Sie die gewünschten Gruppen der Jira-Integration zuweisen.