JIRA-Integration

Verbinden Sie Ihren AI SmartTalk-Assistenten mit Atlassian JIRA, um intelligente Projektmanagement- und Issue-Tracking-Funktionen zu ermöglichen. Diese Integration erlaubt es Ihrem AI-Assistenten, Issues zu suchen, zu erstellen, zu aktualisieren, Arbeitszeiten zu protokollieren und Sprints direkt über natürliche Sprachinteraktionen zu verwalten.

Übersicht

Die JIRA-Integration ermöglicht es Ihrem AI-Assistenten:

• Issues suchen: Finden Sie Issues mit natürlichen Sprachabfragen
• Issue-Details anzeigen: Erhalten Sie umfassende Informationen zu spezifischen Issues
• Issues erstellen: Generieren Sie automatisch neue Tickets, Aufgaben oder Bugs
• Issues aktualisieren: Ändern Sie den Status, die Priorität, den Zuweisenden und andere Felder von Issues
• Zeiterfassung: Protokollieren Sie Arbeitszeiten mit detaillierten Kommentaren und Beschreibungen
• Sprint-Management: Listen Sie Boards, Sprints auf und verwalten Sie die Sprintplanung
• Projektmanagement: Greifen Sie auf Projektinformationen und Team-Kollaborationsdaten zu

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie:

• Ein aktives AI SmartTalk-Konto mit Zugriff auf die Assistentenkonfiguration haben
• Eine JIRA Cloud- oder Serverinstanz mit Administratorrechten besitzen
• API-Zugriff in Ihrer JIRA-Instanz aktiviert ist
• Benutzerkonten-Anmeldeinformationen mit entsprechenden Projektberechtigungen haben

Schritt-für-Schritt Einrichtung

Schritt 1: Zugriff auf die JIRA-Integration

1. Melden Sie sich bei Ihrem AI SmartTalk-Konto an
2. Navigieren Sie zu Verwaltung → Meine Assistenten → [Ihr Assistentenname]
3. Klicken Sie in der linken Seitenleiste auf Connectoren
4. Suchen Sie JIRA in der Liste der verfügbaren Connectoren
5. Klicken Sie auf das JIRA-Integrationsfeld

Schritt 2: JIRA-Verbindung konfigurieren

1. JIRA URL: Geben Sie die URL Ihrer JIRA-Instanz ein (z. B. https://yourcompany.atlassian.net)
2. Benutzername/E-Mail: Geben Sie die E-Mail-Adresse Ihres JIRA-Kontos an
3. API-Token: Generieren und geben Sie Ihr JIRA-API-Token ein
   • Gehen Sie zu den Kontoeinstellungen Ihres Atlassian-Kontos
   • Navigieren Sie zu Sicherheit → API-Token erstellen und verwalten
   • Generieren Sie ein neues Token für die AI SmartTalk-Integration
4. Klicken Sie auf Konfigurieren, um die Verbindung herzustellen

Schritt 3: KI-Funktionen aktivieren

Konfigurieren Sie die KI-Funktionen, die Sie aktivieren möchten:

Issue-Management (4/4)

• ✅ JIRA_SEARCH_ISSUES: Suchen und filtern Sie Issues mit natürlicher Sprache
• ✅ JIRA_GET_ISSUE: Abrufen detaillierter Informationen zu bestimmten Issues
• ✅ JIRA_CREATE_ISSUE: Neue Issues, Aufgaben und Bugs erstellen
• ✅ JIRA_UPDATE_ISSUE: Vorhandene Issues und deren Eigenschaften ändern

Zeiterfassung (1/1)

• ✅ JIRA_LOG_TIME: Arbeitszeit mit Kommentaren und Beschreibungen protokollieren

Sprint-Management (2/2)

• ✅ JIRA_LIST_BOARDS_AND_SPRINTS: Verfügbare Boards und aktive Sprints anzeigen
• ✅ JIRA_CREATE_SPRINT: Neue Sprints erstellen und die Sprintplanung verwalten

Schritt 4: Projektsynchronisierung

1. Klicken Sie auf Projekte synchronisieren, um Ihre JIRA-Projekte abzurufen
2. Wählen Sie die Projekte aus, auf die Ihr KI-Assistent zugreifen soll
3. Konfigurieren Sie projektspezifische Berechtigungen und Zugriffsrechte
4. Warten Sie, bis die erste Synchronisierung abgeschlossen ist

KI-Assistent-Fähigkeiten

Problem-Suche und -Verwaltung

Ihr KI-Assistent kann natürliche Sprachabfragen wie folgt verarbeiten:

Suchbeispiele:

• "Finde alle Probleme im Zusammenhang mit Cookies"
• "Zeige mir hochpriorisierte Bugs, die John zugewiesen sind"
• "Liste alle Aufgaben im aktuellen Sprint auf"
• "Was sind die offenen Probleme für das CCS-Projekt?"

Problemdetails:

User: "Erzähle mir von dem Problem CCS-11"
AI: Hier sind die Details zu CCS-11:
- Titel: Bereite Schokoladenkekse mit detailliertem Inhalt vor
- Status: To Do
- Priorität: Niedrig
- Zuweisung: Nicht zugewiesen
- Beschreibung: [Vollständige Problembeschreibung]

Problemerstellung

Erstellen Sie Probleme durch konversationale Befehle:

Erstellungsbeispiele:

• "Erstelle einen Bug-Report für das Anmeldeproblem"
• "Füge eine Aufgabe zur Implementierung der Benutzerauthentifizierung hinzu"
• "Erstelle eine Story für das neue Dashboard-Feature"

Zeiterfassung

Protokollieren Sie Arbeitszeiten mit natürlicher Sprache:

Zeiterfassungsbeispiele:

User: "@PO Bot Ich bestätige, dass die Kekse im Ofen für CCS-11 sind, und ich protokolliere 2 Stunden bei 200 Grad Thermostat"

AI-Antwort:
✅ Zeit erfolgreich für CCS-11 protokolliert:
- Aufgewendete Zeit: 2 Stunden
- Kommentar: Kekse im Ofen bei 200°C Thermostat
- Startdatum: 14. November 2025, 12:00 Uhr

Sprint-Management

Verwalten Sie Sprints und Boards konversationell:

Sprint-Beispiele:

• "Was ist in unserem aktuellen Sprint?"
• "Erstelle einen neuen Sprint für nächste Woche"
• "Zeige mir alle verfügbaren Boards"
• "Verschiebe CCS-11 in den aktiven Sprint"

Unterstützte JIRA-Funktionen

Problemtpyen

Typ	Unterstützt	KI-Fähigkeiten
Epic	✅	Erstellen, aktualisieren, untergeordnete Probleme verlinken
Story	✅	Vollständige CRUD-Operationen, Schätzung der Story-Punkte
Task	✅	Vollständige Aufgabenverwaltung und -verfolgung
Bug	✅	Bug-Berichterstattung, Schweregradzuweisung, Verfolgung der Lösung
Subtask	✅	Erstellung von Unteraufgaben und Verlinkung mit übergeordneten Problemen

Felder und Eigenschaften

Feld	Lesen	Schreiben	KI-Verständnis
Zusammenfassung	✅	✅	Verarbeitung natürlicher Sprache
Beschreibung	✅	✅	Unterstützung für Rich Text und Formatierung
Status	✅	✅	Verwaltung des Workflow-Zustands
Priorität	✅	✅	Intelligente Prioritätszuweisung
Zuweisung	✅	✅	Erkennung von Teammitgliedern
Reporter	✅	✅	Automatische Benutzerzuordnung
Labels	✅	✅	Intelligente Vorschläge für Labels
Komponenten	✅	✅	Komponentenbasierte Organisation
Fix-Version	✅	✅	Integration der Release-Planung

Fehlerbehebung

Häufige Probleme

Verbindungsprobleme

• Authentifizierung fehlgeschlagen:
  • Überprüfen Sie das JIRA-URL-Format (einschließlich https://)
  • Überprüfen Sie die Gültigkeit des API-Tokens
  • Stellen Sie sicher, dass das Konto über die entsprechenden Berechtigungen verfügt
• Netzwerk-Timeout:
  • Überprüfen Sie die Zugänglichkeit der JIRA-Instanz
  • Überprüfen Sie die Firewall-Einstellungen
  • Testen Sie die Verbindung von den AI SmartTalk-Servern

Berechtigungsfehler

• Unzureichende Berechtigungen:
  • Überprüfen Sie die JIRA-Projektberechtigungen für Ihr Konto
  • Überprüfen Sie die Berechtigungen zum Durchsuchen des Projekts und zum Erstellen von Problemen
  • Bestätigen Sie den Admin-Zugriff für die Projektkonfiguration
• Projektzugriff verweigert:
  • Stellen Sie sicher, dass der Benutzer zu den Zielprojekten hinzugefügt wurde
  • Überprüfen Sie die Sichtbarkeitseinstellungen des Projekts
  • Überprüfen Sie die Schreibweise des Projektschlüssels

Synchronisationsprobleme

• Projekte werden nicht geladen:
  • Aktualisieren Sie die Projektsynchronisation
  • Überprüfen Sie die Leistung der JIRA-Instanz
  • Überprüfen Sie die API-Durchsatzgrenzen
• Fehleraktualisierungen schlagen fehl:
  • Überprüfen Sie die Berechtigungen für den Workflow von Problemen
  • Überprüfen Sie die Anforderungen an Felder und Validierungsregeln
  • Stellen Sie sicher, dass das Problem in bearbeitbarem Zustand ist

Leistungsoptimierung

API-Durchsatzgrenzen

• Nutzung überwachen: Verfolgen Sie API-Aufrufe und Durchsatzgrenzen
• Batch-Operationen: Gruppieren Sie mehrere Operationen, wenn möglich
• Caching-Strategie: Implementieren Sie intelligentes Caching für häufig abgerufene Daten

Umgang mit großen Instanzen

• Projektfilterung: Synchronisieren Sie nur relevante Projekte
• Problempaginierung: Verarbeiten Sie große Ergebnismengen effizient
• Selektive Synchronisation: Wählen Sie spezifische Problemtypen und -status aus

Best Practices

Projektorganisation

• Klare Benennung: Verwenden Sie beschreibende Projekt- und Problemtitel
• Konsistente Kennzeichnung: Halten Sie eine konsistente Label-Taxonomie ein
• Regelmäßige Bereinigung: Archivieren Sie abgeschlossene Projekte und Probleme

Anwendungsfälle und Beispiele

Automatisierung des täglichen Standups

Teammitglied: "Zeig mir, woran ich gestern gearbeitet habe und was für heute geplant ist"
AI: "Gestern haben Sie CCS-9 (2 Stunden erfasst) und CCS-10 (1,5 Stunden) abgeschlossen. 
Heute haben Sie CCS-11 und CCS-12 im aktuellen Sprint zugewiesen."

Sprint-Planung

Scrum Master: "Erstelle einen neuen Sprint, der am Montag für 2 Wochen beginnt"
AI: "✅ Neuer Sprint 'Sprint 24' wurde erstellt, der am 18. November 2025 für 2 Wochen beginnt. 
Bereit, Probleme aus dem Backlog hinzuzufügen."

Fehlerberichterstattung

QA-Tester: "Erstelle einen Fehler: Das Anmeldeformular validiert das E-Mail-Format nicht richtig, hohe Priorität"
AI: "✅ Fehler CCS-15 erstellt: 'Problem mit der E-Mail-Validierung im Anmeldeformular'
- Priorität: Hoch
- Zugewiesen an: Entwicklungsteam
- Dem aktuellen Sprint zur sofortigen Bearbeitung hinzugefügt"

Fortschrittsverfolgung

Produktinhaber: "Wie steht es um das Projekt zur Zubereitung von Keksen?"
AI: "Status des Keksprojekts (CCS):
- 5 Probleme abgeschlossen (CCS-1 bis CCS-5)
- 3 in Bearbeitung (CCS-7, CCS-9, CCS-11)  
- 2 zu erledigen (CCS-12, CCS-13)
- Sprint-Abschluss: 67% im Plan"