JIRA-integratie

Verbind uw AI SmartTalk-assistent met Atlassian JIRA om intelligente projectmanagement- en probleemopsporingsmogelijkheden mogelijk te maken. Deze integratie stelt uw AI-assistent in staat om problemen te zoeken, te creëren, bij te werken, tijd te registreren en sprints te beheren via natuurlijke taalinteracties.

Overzicht

De JIRA-integratie stelt uw AI-assistent in staat om:

• Problemen Zoeken: Vind problemen met behulp van natuurlijke taalvragen
• Probleemdetails Bekijken: Krijg uitgebreide informatie over specifieke problemen
• Problemen Creëren: Genereer automatisch nieuwe tickets, taken of bugs
• Problemen Bijwerken: Wijzig de status, prioriteit, verantwoordelijke en andere velden van een probleem
• Tijdregistratie: Registreer werktijd met gedetailleerde opmerkingen en beschrijvingen
• Sprintbeheer: Lijst borden, sprints en beheer sprintplanning
• Projectbeheer: Toegang tot projectinformatie en gegevens over team samenwerking

Vereisten

Voordat je begint, zorg ervoor dat je:

• Een actief AI SmartTalk-account hebt met toegang tot assistentconfiguratie
• Een JIRA Cloud- of Server-instance met beheerdersrechten
• API-toegang ingeschakeld in je JIRA-instance
• Gebruikersaccountgegevens met de juiste projectmachtigingen

Stap-voor-stap Setup

Stap 1: Toegang tot JIRA-integratie

1. Log in op je AI SmartTalk-account
2. Navigeer naar Administratie → Mijn Assistenten → [Jouw Assistent Naam]
3. Klik op Connectoren in de linkerzijbalk
4. Zoek JIRA in de lijst met beschikbare connectoren
5. Klik op de JIRA-integratie tegel

Stap 2: Configureer JIRA-verbinding

1. JIRA URL: Voer de URL van je JIRA-instantie in (bijv. https://yourcompany.atlassian.net)
2. Gebruikersnaam/E-mail: Geef je JIRA-account e-mailadres op
3. API-token: Genereer en voer je JIRA API-token in
   • Ga naar je Atlassian-accountinstellingen
   • Navigeer naar Beveiliging → Maak en beheer API-tokens
   • Genereer een nieuw token voor de AI SmartTalk-integratie
4. Klik op Configureren om de verbinding tot stand te brengen

Stap 3: Schakel AI-mogelijkheden in

Configureer de AI-mogelijkheden die je wilt inschakelen:

Probleembeheer (4/4)

• ✅ JIRA_SEARCH_ISSUES: Zoek en filter problemen met natuurlijke taal
• ✅ JIRA_GET_ISSUE: Haal gedetailleerde informatie over specifieke problemen op
• ✅ JIRA_CREATE_ISSUE: Maak nieuwe problemen, taken en bugs aan
• ✅ JIRA_UPDATE_ISSUE: Wijzig bestaande problemen en hun eigenschappen

Tijdregistratie (1/1)

• ✅ JIRA_LOG_TIME: Registreer werktijd met opmerkingen en beschrijvingen

Sprintbeheer (2/2)

• ✅ JIRA_LIST_BOARDS_AND_SPRINTS: Bekijk beschikbare borden en actieve sprints
• ✅ JIRA_CREATE_SPRINT: Maak nieuwe sprints aan en beheer sprintplanning

Stap 4: Project Synchronisatie

1. Klik op Sync Projects om je JIRA-projecten op te halen
2. Selecteer de projecten waartoe je AI-assistent toegang moet hebben
3. Configureer project-specifieke machtigingen en toegangslevels
4. Wacht tot de initiële synchronisatie is voltooid

AI Assistant Capaciteiten

Probleemzoek en Beheer

Je AI-assistent kan natuurlijke taalvragen verwerken zoals:

Zoekvoorbeelden:

• "Vind alle problemen gerelateerd aan cookies"
• "Toon me hoge prioriteit bugs toegewezen aan John"
• "Lijst alle taken in de huidige sprint"
• "Wat zijn de openstaande problemen voor het CCS-project?"

Probleemdetails:

User: "Vertel me over probleem CCS-11"
AI: Hier zijn de details voor CCS-11:
- Titel: Bereid chocolade koekjes voor met gedetailleerde inhoud
- Status: Te Doen
- Prioriteit: Laag
- Toegewezen aan: Niet toegewezen
- Beschrijving: [Volledige probleemomschrijving]

Probleemcreatie

Creëer problemen via conversatiecommando's:

Creëervoorbeelden:

• "Maak een bugrapport voor het inlogprobleem"
• "Voeg een taak toe om gebruikersauthenticatie te implementeren"
• "Creëer een verhaal voor de nieuwe dashboardfunctie"

Tijdregistratie

Log werkuren met natuurlijke taal:

Voorbeelden van Tijdregistratie:

User: "@PO Bot Ik bevestig dat de koekjes in de oven zijn voor CCS-11, en ik log 2 uur op thermostaat 200"

AI Response:
✅ Tijd succesvol gelogd voor CCS-11:
- Tijd besteed: 2 uur
- Opmerking: Koekjes in de oven op 200°C thermostaat
- Startdatum: 14 november 2025, 12:00 PM

Sprintbeheer

Beheer sprints en borden op een converserende manier:

Voorbeelden van Sprints:

• "Wat staat er in onze huidige sprint?"
• "Maak een nieuwe sprint voor volgende week"
• "Toon me alle beschikbare borden"
• "Verplaats CCS-11 naar de actieve sprint"

Ondersteunde JIRA-functies

Probleemtypen

Type	Ondersteund	AI-mogelijkheden
Epic	✅	Maak, werk bij, koppel kindproblemen
Story	✅	Volledige CRUD-bewerkingen, schatting van story points
Task	✅	Volledige taakbeheer en -tracking
Bug	✅	Bugrapportage, toewijzing van ernst, tracking van oplossingen
Subtask	✅	Aanmaak van subtaken en koppeling aan bovenliggend probleem

Velden en Eigenschappen

Veld	Lezen	Schrijven	AI-begrip
Samenvatting	✅	✅	Natuurlijke taalverwerking
Beschrijving	✅	✅	Ondersteuning voor rijke tekst en opmaak
Status	✅	✅	Beheer van workflowstatus
Prioriteit	✅	✅	Slimme toewijzing van prioriteiten
Toegewezen aan	✅	✅	Herkenning van teamleden
Melder	✅	✅	Automatische gebruikersmapping
Labels	✅	✅	Intelligente labelsuggesties
Componenten	✅	✅	Component-gebaseerde organisatie
Fixversie	✅	✅	Integratie van releaseplanning

Probleemoplossing

Veelvoorkomende Problemen

Verbindingsproblemen

• Authenticatie Mislukt:
  • Controleer het JIRA URL-formaat (inclusief https://)
  • Controleer de geldigheid van de API-token
  • Zorg ervoor dat het account de juiste machtigingen heeft
• Netwerk Timeout:
  • Controleer de toegankelijkheid van de JIRA-instantie
  • Controleer de firewallinstellingen
  • Test de verbinding vanaf de AI SmartTalk-servers

Machtigingsfouten

• Onvoldoende Machtigingen:
  • Bekijk de JIRA-projectmachtigingen voor uw account
  • Controleer de machtigingen voor het doorbladeren van projecten en het aanmaken van issues
  • Controleer de admin-toegang voor projectconfiguratie
• Projecttoegang Geweigerd:
  • Zorg ervoor dat de gebruiker is toegevoegd aan de doelprojecten
  • Controleer de zichtbaarheid van projecten
  • Valideer de spelling van de projectcode

Synchronisatieproblemen

• Projecten Laden Niet:
  • Vernieuw de project-synchronisatie
  • Controleer de prestaties van de JIRA-instantie
  • Controleer de API-snelheidslimieten
• Probleemupdates Mislukken:
  • Controleer de machtigingen voor de workflow van het probleem
  • Controleer de vereisten voor velden en validatieregels
  • Zorg ervoor dat het probleem in een bewerkbare staat is

Prestatieoptimalisatie

API-snelheidslimieten

• Gebruik Monitoren: Houd API-aanroepen en snelheidslimieten bij
• Batchbewerkingen: Groepeer meerdere bewerkingen waar mogelijk
• Cachingstrategie: Implementeer intelligente caching voor vaak geraadpleegde gegevens

Behandeling van Grote Instanties

• Projectfiltering: Synchroniseer alleen relevante projecten
• Probleempagina's: Behandel grote resultaatsets efficiënt
• Selectieve Synchronisatie: Kies specifieke probleemtypen en statussen

Best Practices

Project Organization

• Duidelijke Naamgeving: Gebruik beschrijvende project- en probleemnamen
• Consistente Labeling: Behoud een consistente labeltaxonomie
• Regelmatige Opschoning: Archiveer voltooide projecten en problemen

Use Cases and Examples

Daily Standup Automation

Team Member: "Show me what I worked on yesterday and what's planned for today"
AI: "Gisteren heb je CCS-9 (2 uur geregistreerd) en CCS-10 (1,5 uur) voltooid. 
Vandaag heb je CCS-11 en CCS-12 toegewezen in de huidige sprint."

Sprint Planning

Scrum Master: "Create a new sprint starting Monday for 2 weeks"
AI: "✅ Nieuwe sprint 'Sprint 24' aangemaakt die begint op 18 november 2025 voor 2 weken. 
Klaar om issues uit de backlog toe te voegen."

Bug Reporting

QA Tester: "Create a bug: Login form doesn't validate email format properly, high priority"
AI: "✅ Bug CCS-15 aangemaakt: 'Probleem met e-mailvalidatie in het loginformulier'
- Prioriteit: Hoog
- Toegewezen aan: Ontwikkelteam
- Toegevoegd aan de huidige sprint voor onmiddellijke aandacht"

Voortgangsregistratie

Product Owner: "Hoe gaat het met het koekjesbereidingsproject?"
AI: "Koekjesproject (CCS) status:
- 5 voltooide problemen (CCS-1 tot CCS-5)
- 3 in uitvoering (CCS-7, CCS-9, CCS-11)  
- 2 te doen (CCS-12, CCS-13)
- Sprint voltooiing: 67% op schema"