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 kyselyiden avulla
• Näytä ongelman tiedot: Hanki kattavaa tietoa tietyistä ongelmista
• Luo ongelmia: Luo automaattisesti uusia lippuja, tehtäviä tai bugeja
• Päivitä ongelmia: Muokkaa ongelman tilaa, prioriteettia, vastuuhenkilöä ja muita kenttiä
• Ajan seuranta: Kirjaa työaikaa yksityiskohtaisilla kommenteilla ja kuvauksilla
• Sprintinhallinta: Listaa taulut, sprintit ja hallitse sprinttisuunnittelua
• Projektinhallinta: Pääsy projektitietoihin ja tiimin yhteistyötietoihin

Esivaatimukset

Ennen kuin aloitat, varmista, että sinulla on:

• Aktiivinen AI SmartTalk -tili, jossa on pääsy avustajan konfigurointiin
• JIRA Cloud- tai Server-instanssi, jossa on järjestelmänvalvojan oikeudet
• API-pääsy otettu 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 luettelosta
5. Napsauta JIRA-integraation laattaa

Vaihe 2: JIRA-yhteyden Konfigurointi

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

Vaihe 3: AI-ominaisuuksien Aktivointi

Konfiguroi 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öaika kommenttien ja kuvausten kanssa

Sprintin Hallinta (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ä ensimmä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ä korkeaprioriteettiset 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 uudelle ohjauspaneelitoiminnolle"

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 termostaatti 200"

AI-vastaus:
✅ Aika kirjattu onnistuneesti CCS-11:lle:
- Kulunut 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ä alaoikeudet
Tarina	✅	Täydet CRUD-toiminnot, tarinapisteiden arviointi
Tehtävä	✅	Täydellinen tehtävien hallinta ja seuranta
Bugi	✅	Bugiraportointi, vakavuuden määrittäminen, ratkaisun seuranta
Ala-tehtävä	✅	Ala-tehtä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 tunnistaminen
Raportoija	✅	✅	Automaattinen käyttäjän kartoitus
Tunnisteet	✅	✅	Älykkäät tunnistesuositukset
Komponentit	✅	✅	Komponenttipohjainen organisointi
Korjausversio	✅	✅	Julkaisusuunnittelun integrointi

Vianetsintä

Yleiset ongelmat

Yhteysongelmat

• Todennus epäonnistui:
  • Varmista JIRA-URL-muoto (sisällytä https://)
  • Tarkista API-tunnuksen voimassaolo
  • Varmista, että tilillä on tarvittavat oikeudet
• Verkko-aikakatkaisu:
  • Varmista JIRA-instanssin saavutettavuus
  • Tarkista palomuurin asetukset
  • Testaa yhteys AI SmartTalk -palvelimilta

Oikeusvirheet

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

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: Toteuta ä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 merkintätaksonomia
• Säännöllinen siivous: Arkistoi valmiit projektit ja ongelmat

Käyttötapaukset ja esimerkit

Päivittäinen seisokki-automaation

Tiimin jäsen: "Näytä mitä tein eilen ja mitä on suunniteltu tänään"
AI: "Eilen suoristit 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: "✅ Luotiin 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: "✅ Luotiin 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 edistymme 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"