JIRA-integraatio

Yhdistä AI SmartTalk -avustajasi Atlassian JIRA:an mahdollistamaan älykäs projektinhallinta ja ongelmien seuranta. Tämä integraatio mahdollistaa AI-avustajasi etsiä, luoda, päivittää ongelmia, kirjata aikaa ja hallita sprintejä suoraan luonnollisen kielen vuorovaikutusten kautta.

Yleiskatsaus

JIRA-integraatio mahdollistaa AI-avustajasi:

• Etsi ongelmia: Löydä ongelmia luonnollisen kielen kyselyillä
• Näytä ongelman tiedot: Hanki kattavat tiedot tietyistä ongelmista
• Luo ongelmia: Luo uusia lippuja, tehtäviä tai bugeja automaattisesti
• Päivitä ongelmia: Muokkaa ongelman tilaa, prioriteettia, vastuuhenkilöä ja muita kenttiä
• Ajan seuranta: Kirjaa työaikaa yksityiskohtaisilla kommenteilla ja kuvauksilla
• Sprintinhallinta: Listaa tauluja, sprintejä ja hallitse sprinttisuunnittelua
• Projektinhallinta: Pääsy projektitietoihin ja tiimin yhteistyötietoihin

Esivaatimukset

Ennen kuin aloitat, varmista, että sinulla on:

• Aktiivinen AI SmartTalk -tili, jolla on pääsy avustajan asetuksiin
• JIRA Cloud- tai Server-instanssi, jolla on järjestelmänvalvojan oikeudet
• API-pääsy otettuna käyttöön JIRA-instanssissasi
• Käyttäjätilin tunnistetiedot, joilla on asianmukaiset projektioikeudet

Vaiheittainen asennus

Vaihe 1: Pääsy JIRA-integraatioon

1. Kirjaudu sisään AI SmartTalk -tilillesi
2. Siirry kohtaan Hallinta → Omat avustajat → [Avustajasi nimi]
3. Napsauta Liittimiä vasemmassa sivupalkissa
4. Etsi JIRA saatavilla olevien liittimien listasta
5. Napsauta JIRA-integraation laatikkoa

Vaihe 2: JIRA-yhteyden määrittäminen

1. JIRA URL: Syötä JIRA-instanssisi URL-osoite (esim. https://yourcompany.atlassian.net)
2. Käyttäjänimi/Sähköposti: Anna JIRA-tilisi sähköpostiosoite
3. API-tunnus: Luo ja syötä JIRA API -tunnuksesi
   • Siirry Atlassian-tilisi asetuksiin
   • Siirry kohtaan Turvallisuus → Luo ja hallinnoi API-tunnuksia
   • Luo uusi tunnus AI SmartTalk -integraatiota varten
4. Napsauta Määritä ottaaksesi yhteyden käyttöön

Vaihe 3: AI-ominaisuuksien aktivointi

Määritä AI-ominaisuudet, jotka haluat aktivoida:

Ongelmanhallinta (4/4)

• ✅ JIRA_SEARCH_ISSUES: Etsi ja suodata ongelmia luonnollisella kielellä
• ✅ JIRA_GET_ISSUE: Hae yksityiskohtaisia tietoja tietyistä ongelmista
• ✅ JIRA_CREATE_ISSUE: Luo uusia ongelmia, tehtäviä ja bugeja
• ✅ JIRA_UPDATE_ISSUE: Muokkaa olemassa olevia ongelmia ja niiden ominaisuuksia

Ajan seuranta (1/1)

• ✅ JIRA_LOG_TIME: Kirjaa työtunnit kommenttien ja kuvauksien kanssa

Sprintinhallinta (2/2)

• ✅ JIRA_LIST_BOARDS_AND_SPRINTS: Näytä saatavilla olevat taulut ja aktiiviset sprintit
• ✅ JIRA_CREATE_SPRINT: Luo uusia sprinttejä ja hallinnoi sprintin suunnittelua

Vaihe 4: Projektin synkronointi

1. Napsauta Synkronoi projektit noutaaksesi JIRA-projektisi
2. Valitse projektit, joihin AI-avustajasi saa pääsyn
3. Määritä projektikohtaiset käyttöoikeudet ja pääsytasot
4. Odota, että alkuperäinen synkronointi valmistuu

AI-avustajan kyvyt

Ongelman haku ja hallinta

AI-avustajasi voi käsitellä luonnollisen kielen kyselyitä, kuten:

Haku Esimerkit:

• "Etsi kaikki ongelmat, jotka liittyvät evästeisiin"
• "Näytä korkean prioriteetin bugit, jotka on osoitettu Johnille"
• "Listaa kaikki tehtävät nykyisessä sprintissä"
• "Mitkä ovat avoimet ongelmat CCS-projektissa?"

Ongelman tiedot:

User: "Kerro minulle ongelmasta CCS-11"
AI: Tässä ovat tiedot CCS-11:stä:
- Otsikko: Valmista suklaakeksejä yksityiskohtaisella sisällöllä
- Tila: Tehtävä
- Prioriteetti: Matala
- Vastaanottaja: Ei osoitettu
- Kuvaus: [Koko ongelman kuvaus]

Ongelman luominen

Luo ongelmia keskustelukäskyjen avulla:

Luonti Esimerkit:

• "Luo bugiraportti kirjautumisongelmasta"
• "Lisää tehtävä käyttäjäautentikoinnin toteuttamiseksi"
• "Luo tarina uuden ohjauspaneelin ominaisuudesta"

Työajan kirjaaminen

Kirjaa työaika luonnollisella kielellä:

Ajan seuranta Esimerkit:

User: "@PO Bot Vahvistan, että evästeet ovat uunissa CCS-11:lle, ja kirjaan 2 tuntia termostaatilla 200"

AI-vastaus:
✅ Aika kirjattu onnistuneesti CCS-11:lle:
- Kulutettu aika: 2 tuntia
- Kommentti: Evästeet uunissa 200°C termostaatilla
- Aloituspäivämäärä: 14. marraskuuta 2025, klo 12:00

Sprintin hallinta

Hallitse sprinttejä ja tauluja keskustelemalla:

Sprintti Esimerkit:

• "Mitä on nykyisessä sprintissämme?"
• "Luo uusi sprintti ensi viikolle"
• "Näytä kaikki saatavilla olevat taulut"
• "Siirrä CCS-11 aktiiviseen sprinttiin"

Tuetut JIRA-ominaisuudet

Ongelmatyypit

Tyyppi	Tuettu	AI-kyvyt
Epic	✅	Luo, päivitä, linkitä alatehtäviä
Tarina	✅	Täydet CRUD-toiminnot, tarinapisteiden arviointi
Tehtävä	✅	Täydellinen tehtävien hallinta ja seuranta
Bug	✅	Bugiraportointi, vakavuuden määrittäminen, ratkaisun seuranta
Alatehtävä	✅	Alatehtävien luominen ja pääongelman linkittäminen

Kentät ja ominaisuudet

Kenttä	Lue	Kirjoita	AI:n ymmärrys
Yhteenveto	✅	✅	Luonnollisen kielen käsittely
Kuvaus	✅	✅	Rikas teksti ja muotoilutuki
Tila	✅	✅	Työnkulun tilan hallinta
Prioriteetti	✅	✅	Älykäs prioriteettien määrittäminen
Vastaanottaja	✅	✅	Tiimin jäsenten tunnistus
Raportoija	✅	✅	Automaattinen käyttäjän kartoitus
Tunnisteet	✅	✅	Älykkäät tunnisteehdotukset
Komponentit	✅	✅	Komponenttipohjainen organisointi
Korjausversio	✅	✅	Julkaisusuunnittelun integrointi

Vianetsintä

Yleisimmät ongelmat

Yhteysongelmat

• Todennus epäonnistui:
  • Varmista JIRA-URL-muoto (sisällytä https://)
  • Tarkista API-tunnuksen voimassaolo
  • Varmista, että tilillä on tarvittavat käyttöoikeudet
• Verkko-aika loppui:
  • Varmista JIRA-instanssin saavutettavuus
  • Tarkista palomuuriasetukset
  • Testaa yhteys AI SmartTalk -palvelimilta

Käyttöoikeusvirheet

• Riittämättömät käyttöoikeudet:
  • Tarkista JIRA-projektin käyttöoikeudet tilillesi
  • Tarkista projektin selaus- ja ongelmanluontioikeudet
  • Varmista pääkäyttäjäpääsy projektin konfigurointiin
• Projektin pääsy evätty:
  • Varmista, että käyttäjä on lisätty kohdeprojekteihin
  • Tarkista projektin näkyvyysasetukset
  • Varmista projektin avaimen oikeinkirjoitus

Synkronointiongelmat

• Projektit eivät lataudu:
  • Päivitä projektin synkronointi
  • Tarkista JIRA-instanssin suorituskyky
  • Varmista API-käyttörajoitukset
• Ongelmapäivitykset epäonnistuvat:
  • Tarkista ongelman työnkulkuoikeudet
  • Varmista kenttävaatimukset ja validointisäännöt
  • Varmista, että ongelma on muokattavassa tilassa

Suorituskyvyn optimointi

API-käyttörajoitukset

• Seuraa käyttöä: Seuraa API-kutsuja ja käyttörajoituksia
• Erätoiminnot: Ryhmittele useita toimintoja mahdollisuuksien mukaan
• Välimuististrategia: Ota käyttöön älykäs välimuisti usein käytettävälle datalle

Suurten instanssien käsittely

• Projektin suodatus: Synkronoi vain relevantit projektit
• Ongelmapaginoiminen: Käsittele suuria tulosjoukkoja tehokkaasti
• Valikoiva synkronointi: Valitse tietyt ongelmatyypit ja -tilat

Parhaat käytännöt

Projektin organisointi

• Selkeä nimeäminen: Käytä kuvaavia projektin ja ongelman nimiä
• Johdonmukainen merkintä: Säilytä johdonmukainen etikettitaksonomia
• Säännöllinen siivous: Arkistoi valmiit projektit ja ongelmat

Käyttötapaukset ja esimerkit

Päivittäinen seisokki-automaatiot

Tiimin jäsen: "Näytä minulle, mitä tein eilen ja mitä on suunniteltu tänään"
AI: "Eilen viimeistelit CCS-9 (2 tuntia kirjattu) ja CCS-10 (1.5 tuntia). 
Tänään sinulla on CCS-11 ja CCS-12 määrätty nykyiseen sprinttiin."

Sprintin suunnittelu

Scrum Master: "Luo uusi sprintti, joka alkaa maanantaina kahdeksi viikoksi"
AI: "✅ Luotu uusi sprintti 'Sprint 24', joka alkaa 18. marraskuuta 2025 kahdeksi viikoksi. 
Valmis lisäämään ongelmia backlogista."

Virheiden raportointi

QA-testaaja: "Luo virhe: Kirjautumislomake ei validoi sähköpostimuotoa oikein, korkea prioriteetti"
AI: "✅ Luotu virhe CCS-15: 'Kirjautumislomakkeen sähköpostin validointiongelma'
- Prioriteetti: Korkea
- Määrätty: Kehitystiimille
- Lisätty nykyiseen sprinttiin välitöntä huomiota varten"

Edistymisen seuranta

Tuoteomistaja: "Miten meillä menee keksinvalmistusprojektissa?"
AI: "Keksiprojektin (CCS) tila:
- 5 ongelmaa valmis (CCS-1 - CCS-5)
- 3 kesken (CCS-7, CCS-9, CCS-11)  
- 2 tekemättä (CCS-12, CCS-13)
- Sprintin valmistuminen: 67% aikataulussa"