Skip to main content

​
Überblick

Mit dem Jira-Toolset können Agenten live in Jira Cloud arbeiten: Vorgänge und Projekte abrufen, mit JQL suchen, Vorgänge erstellen oder ändern und Kommentare hinzufügen. Eine Workspace-Administration richtet die gemeinsame Instanz unter Workspace Settings → Actions ein. Jede Person verbindet danach ihr eigenes Atlassian-Konto unter Your actions. Für die Suche in bereits synchronisierten Daten verwenden Sie den Jira-Konnektor. Diese Anleitung gilt für Jira Cloud. Wenn Ihre Organisation Jira auf eigenen Servern betreibt, verwenden Sie stattdessen das Jira-Data-Center-Toolset. Prüfen Sie vor dem Erstellen eines Vorgangs oder dem Wechsel des Vorgangstyps mit get_create_issue_fields die Pflichtfelder und zulässigen Werte. Fragen Sie fehlende Pflichtangaben bei der betreffenden Person nach, statt Werte zu erfinden.
Das Toolset kann Vorgänge und Kommentare im Namen der angemeldeten Person ändern. Prüfen Sie Projekt, Vorgangsschlüssel und beabsichtigte Änderung, bevor Sie eine schreibende Agentenaktion ausführen lassen.

​
Authentifizierung wählen

​
OAuth 2.0 einrichten

  1. Öffnen Sie die Atlassian Developer Console und erstellen Sie eine OAuth 2.0 integration mit Resource-level als Zugriffstyp. Bei Account-level funktioniert die in der Quellanleitung beschriebene Site-Auswahl nicht.
  2. Öffnen Sie in Novaplan AI Workspace Settings → Actions, wählen Sie bei Jira + Setup und kopieren Sie die dort angezeigte Redirect URI.
  3. Öffnen Sie in der Atlassian-App Authorization → OAuth 2.0 (3LO). Hinterlegen Sie die exakt kopierte URI als Callback URL. Schon ein anderer Schrägstrich oder Host kann die Anmeldung verhindern.
  4. Wählen Sie unter Permissions die für Ihre freigegebenen Aktionen nötigen Rechte für User Identity API und Jira API. Die Liste aus der Integrationsanleitung steht unten. Prüfen Sie diese mit Ihrer Atlassian-Administration und gewähren Sie nur die benötigten Rechte.
  5. Kopieren Sie unter Settings → Authentication details die Client ID und das Secret. Tragen Sie beide in der Jira-Instanz unter Workspace Settings → Actions ein, vergeben Sie einen Instance Name und wählen Sie Create.
  6. Eine Workspace-Administration kann die gemeinsame Instanz direkt unter Workspace Settings → Actions authentifizieren. Alle anderen Personen öffnen Your actions → Jira im Bereich Personal und authentifizieren ihren eigenen Zugang. Wählen Sie Authenticate with OAuth, die richtige Jira-Site und bestätigen Sie die Berechtigungen. Verwenden Sie laut Quellanleitung dieselbe E-Mail-Adresse wie für das Novaplan-Konto.
Client ID und Client Secret gehören zur gemeinsamen Atlassian-App. Persönliche OAuth-Tokens werden erst ausgestellt, wenn sich jede Person selbst anmeldet. Eine Atlassian-App kann auch für das Confluence-Toolset verwendet werden, sofern die nötigen Berechtigungen für beide APIs hinzugefügt wurden.

​
Berechtigungsliste aus der Integrationsanleitung

Die Liste beschreibt die dokumentierten Funktionen. Ob einzelne granulare Rechte für Ihre konkrete App nötig sind, hängt von den freigegebenen Aktionen ab; prüfen Sie dies vor der Freigabe. Das Schreibrecht write:jira-work ist für das Erstellen oder Ändern von Vorgängen und Kommentaren relevant.

​
API Token einrichten

  1. Jede Person erstellt unter Atlassian API Tokens einen eigenen Token und kopiert ihn sofort; Atlassian zeigt ihn nur einmal an.
  2. Die Workspace-Administration öffnet Workspace Settings → Actions → Jira → + Setup, wählt API Token, trägt einen Instance Name sowie die Atlassian Site URL ohne abschließenden Schrägstrich ein und wählt Create. Persönliche Zugangsdaten gehören nicht in diese gemeinsame Konfiguration.
  3. Jede Person öffnet Your actions → Jira, trägt die E-Mail-Adresse des Atlassian-Kontos und den dazugehörigen API Token ein und wählt Save credentials. Andere Personen wiederholen diesen Schritt mit ihren eigenen Zugangsdaten.

​
In einem Agenten verwenden

Öffnen Sie auf der Startseite Agents → +, erstellen Sie einen Agenten und ziehen Sie das Jira-Toolset auf die Arbeitsfläche. Verbinden Sie es mit Agent Core und speichern Sie den Agenten. Nennen Sie beim Erstellen eines Vorgangs Projektkürzel, Titel und Vorgangstyp. Geben Sie bei Suchen möglichst einen Zeitraum und eindeutige JQL-Kriterien an. Für Statusänderungen oder Zuweisungen nennen Sie den konkreten Vorgangsschlüssel und die gewünschte Person beziehungsweise den Zielstatus. Bei einer Zuweisung kann der Agent eine Person anhand ihres Namens oder ihrer E-Mail-Adresse suchen und anschließend die passende Atlassian-Konto-ID verwenden. Prüfen Sie vor der Änderung, dass die gefundene Person und der Zielvorgang stimmen. Der Jira-Konnektor synchronisiert Vorgänge für die spätere Suche; das Toolset greift live auf Jira zu und kann Inhalte verändern. Wenn die Verbindung fehlschlägt, prüfen Sie je nach Methode Callback URL, Atlassian-Site, Scope-Freigaben, abgelaufenes Secret oder die Kombination aus E-Mail-Adresse und API Token. Novaplan Support hilft bei weiteren Fragen.