Jira koppelen aan AI: het bord bevragen zonder JQL te leren
Jira is aan AI te koppelen. IntraGPT zoekt issues op in de Jira-omgeving die je aanwijst en geeft de gegevens terug die bij de vraag horen. Op verzoek maakt de assistent een issue aan, werkt hij er een bij of plaatst hij een reactie. Wie zelf niet in Jira werkt, krijgt zo toch antwoord op de vraag waar iets staat en bij wie het ligt.
De vier dingen die de assistent doet
Zoeken in de taal van Jira
De assistent vertaalt je vraag naar een zoekopdracht op project, status, toegewezen persoon of laatste wijziging, en houdt het aantal resultaten beperkt. Hij haalt bovendien alleen de gegevens op die bij de vraag horen, niet elk veld van elk issue.
Een issue aanmaken
Een nieuw issue komt in het project terecht met een issuetype, een samenvatting en een beschrijving. Omdat issuetypes per project verschillen, kijkt de assistent eerst welke er in dat project bestaan voordat hij iets wegschrijft.
Een issue bijwerken
Met de issuesleutel erbij kan de assistent een status zetten, iemand toewijzen of een ander veld invullen. Dat gebeurt alleen op verzoek, want een bijgewerkt issue verschuift het werk van een team dat er zelf mee bezig is.
Een reactie plaatsen
De assistent kan een reactie onder een issue zetten. Die is zichtbaar voor iedereen met toegang tot het project, dus hij toont de tekst voordat hij hem wegschrijft en houdt interne overwegingen eruit.
Werken met de issuesleutel
Issues in Jira hebben een sleutel zoals ABC-123, en die is nodig om bij te werken of te reageren. De assistent verzint er nooit een: hij zoekt het issue eerst op en werkt met de sleutel die daaruit komt.
Wat teams ermee doen
Overheid
- Situatie
- Een informatiemanager moet weten welke meldingen over een dienstverleningsproces nog openstaan, maar werkt zelf niet in Jira.
- Wat de agent doet
- De assistent zoekt de openstaande issues in dat project op en geeft de sleutels met hun samenvatting terug.
- Resultaat
- Antwoord zonder een extra licentie en zonder uitleg over filters.
Klantenservice
- Situatie
- Een klantvraag hoort eigenlijk thuis bij het ontwikkelteam, maar niemand neemt hem over.
- Wat de agent doet
- Na akkoord maakt de assistent een issue aan in het juiste project, met een issuetype dat daar bestaat en een samenvatting die te begrijpen is.
- Resultaat
- Geen overtypwerk, en geen melding die in een mailbox blijft liggen.
Projectmanagement
- Situatie
- Aan het eind van de dag wil de projectleider weten wat er vandaag bewogen is.
- Wat de agent doet
- De assistent zoekt de issues die het laatst zijn bijgewerkt en houdt de lijst kort.
- Resultaat
- Een overzicht van wat er verandert, in plaats van een dashboard vol widgets.
Kwaliteit en compliance
- Situatie
- Bij een controle moet aantoonbaar zijn wat er met een geconstateerde afwijking is gedaan.
- Wat de agent doet
- De assistent zoekt het issue op de sleutel en geeft de status, de toegewezen persoon en de laatste reactie terug.
- Resultaat
- De gang van zaken is te reconstrueren zonder dat de controleur zelf in het systeem hoeft.
Inrichten: vier dingen regelen
-
1
Aanmelden met een eigen account
De koppeling gebruikt een Atlassian-account waarvan jullie zelf de toegang geven en weer kunnen intrekken. De rechten van dat account bepalen wat de koppeling te zien krijgt.
-
2
De Jira-omgeving aanwijzen
Je verbindt de koppeling met jullie eigen Jira-omgeving. Daarmee staat vast met welk Jira de assistent praat en welke projecten binnen bereik komen.
-
3
Schrijven bewust vrijgeven
Zoeken heeft geen gevolgen. Aanmaken, bijwerken en reageren geef je apart vrij, en je bepaalt welke rollen binnen IntraGPT ze mogen gebruiken.
-
4
Meekijken achteraf
Elke handeling wordt vastgelegd met het moment, het issue en het resultaat. Zo is later te zien waarom een status is veranderd of waar een reactie vandaan kwam.
Rechten, zichtbaarheid en het bord van het team
Een issue in Jira is intern overleg: klantnamen, inschattingen en soms een discussie die niet voor iedereen bedoeld is. Daarom ligt vast wie de koppeling mag gebruiken en wat er geschreven kan worden.
Waar de data staat: Nederland
Het account bepaalt het zicht
De koppeling ziet precies wat het gekoppelde Atlassian-account ziet, niet meer. Projecten waarop dat account geen rechten heeft, blijven onzichtbaar voor de assistent, ook als iemand er expliciet naar vraagt.
Een reactie is teamwerk, geen kladblok
Wat de assistent onder een issue zet, leest iedereen met toegang tot het project. Daarom plaatst hij een reactie alleen op expliciet verzoek en laat hij de tekst eerst zien.
Een status wijzigen verplaatst werk
Een statuswijziging schuift een kaart op het bord van een team dat er zelf mee werkt. De assistent doet dat niet uit zichzelf en nooit om een gesprek netjes af te ronden.
Draait in jullie eigen omgeving
Het model staat op een eigen server in Nederland. Samenvattingen, beschrijvingen en reacties uit Jira gaan niet naar een Amerikaanse modelaanbieder en worden niet voor training gebruikt.
Veelgestelde vragen over de Jira-koppeling
Waarom levert mijn zoekopdracht geen resultaten op?
Meestal omdat de zoekopdracht net niet aansluit op hoe dit project is ingericht. Een projectnaam die anders geschreven wordt, een status die hier niet Done heet maar iets anders, of een veld dat in dit project niet bestaat: Jira geeft dan netjes nul resultaten terug zonder te klagen. De assistent kijkt daarom eerst welke statussen en issuetypes er in het project bestaan en stemt de zoekopdracht daarop af.
Kan ik Jira koppelen aan ChatGPT?
Er is geen ingebouwde verbinding tussen ChatGPT en jullie Jira, en de inloggegevens van een Atlassian-account in een publieke chatbot zetten is onverstandig. IntraGPT geeft dezelfde manier van vragen, maar dan op jullie eigen Jira-omgeving, met de rechten van één account en met vastlegging van elke handeling.
Kan de assistent een issue sluiten?
Bijwerken kan, dus een status veranderen ook, maar alleen als die mogelijkheid is vrijgegeven en je er expliciet om vraagt. Wat sluiten betekent verschilt per project, dus de assistent leest de statussen af die dat project echt kent in plaats van te gokken. Een kaart schuift nooit op omdat iemand er terloops iets over zei.
Werkt IntraGPT met Jira?
Ja. Jira staat in de connectorcatalogus van IntraGPT, met zoeken, een issue aanmaken, een issue bijwerken en reageren onder een issue. De koppeling werkt binnen jullie eigen Jira-omgeving.
Wat is het verschil met GitHub-issues voor de assistent?
GitHub-issues horen bij een repository en gaan vooral over het werk van ontwikkelaars. Jira is het bord van de bredere organisatie, met projecten, issuetypes en statussen die per project zijn ingericht. Werk je met allebei, dan zet je beide koppelingen op: uit Jira komt waar iets in de planning staat, uit GitHub wat er in de code gebeurt.
Moet ik JQL kennen om dit te gebruiken?
Nee, je stelt de vraag in gewone taal en de assistent maakt de zoekopdracht. Het helpt wel om te zeggen om welk project het gaat, want zonder afbakening is de uitkomst te groot om er iets mee te kunnen.
Verzint de assistent issuenummers?
Dat is juist uitgesloten. Een sleutel als ABC-123 is nodig om bij te werken of te reageren, en die haalt de assistent uit een zoekopdracht. Vindt hij het issue niet, dan zegt hij dat, in plaats van een nummer te bedenken dat toevallig bestaat.
Hoe lang duurt het inrichten?
Het koppelen zelf kost een paar minuten. De rest van de tijd gaat naar de keuze welk Atlassian-account gebruikt wordt, want de rechten van dat account bepalen wat de assistent ziet en mag.
Wat kost een Jira-koppeling?
Het hoort bij het traject dat we samen doorlopen. Wat het werk bepaalt is het aantal bronnen dat aangesloten wordt, welke rechten daarbij horen en of de assistent ook mag bijwerken. We nemen dat door in een gesprek van dertig minuten.