Integrazione JIRA
Collega il tuo assistente AI SmartTalk con Atlassian JIRA per abilitare capacità intelligenti di gestione progetti e tracciamento delle problematiche. Questa integrazione consente al tuo assistente AI di cercare, creare, aggiornare problematiche, registrare tempo e gestire sprint direttamente attraverso interazioni in linguaggio naturale.
Panoramica
L'integrazione JIRA consente al tuo assistente AI di:
- Cercare Problemi: Trovare problematiche utilizzando query in linguaggio naturale
- Visualizzare Dettagli Problema: Ottenere informazioni complete su problematiche specifiche
- Creare Problemi: Generare automaticamente nuovi ticket, compiti o bug
- Aggiornare Problemi: Modificare stato, priorità, assegnatario e altri campi delle problematiche
- Tracciamento del Tempo: Registrare il tempo di lavoro con commenti e descrizioni dettagliate
- Gestione Sprint: Elencare bacheche, sprint e gestire la pianificazione degli sprint
- Gestione Progetti: Accedere alle informazioni di progetto e ai dati di collaborazione del team
Requisiti
Prima di iniziare, assicurati di avere:
- Un account AI SmartTalk attivo con accesso alla configurazione dell'assistente
- Un'istanza JIRA Cloud o Server con privilegi di amministratore
- Accesso API abilitato nella tua istanza JIRA
- Credenziali dell'account utente con le appropriate autorizzazioni di progetto
Configurazione Passo-Passo
Passo 1: Accedi all'Integrazione JIRA
- Accedi al tuo account AI SmartTalk
- Naviga su Amministrazione → I Miei Assistenti → [Nome del Tuo Assistente]
- Clicca su Connettori nella barra laterale sinistra
- Trova JIRA nell'elenco dei connettori disponibili
- Clicca sulla tile di integrazione JIRA
Passo 2: Configura la Connessione JIRA
- URL JIRA: Inserisci l'URL della tua istanza JIRA (es.
https://yourcompany.atlassian.net) - Nome Utente/Email: Fornisci l'indirizzo email del tuo account JIRA
- Token API: Genera e inserisci il tuo token API JIRA
- Vai alle impostazioni del tuo account Atlassian
- Naviga su Sicurezza → Crea e gestisci token API
- Genera un nuovo token per l'integrazione con AI SmartTalk
- Clicca su Configura per stabilire la connessione
Passo 3: Abilita le Capacità AI
Configura le capacità AI che desideri abilitare:
Gestione dei Problemi (4/4)
- ✅ JIRA_SEARCH_ISSUES: Cerca e filtra i problemi utilizzando il linguaggio naturale
- ✅ JIRA_GET_ISSUE: Recupera informazioni dettagliate su problemi specifici
- ✅ JIRA_CREATE_ISSUE: Crea nuovi problemi, attività e bug
- ✅ JIRA_UPDATE_ISSUE: Modifica problemi esistenti e le loro proprietà
Tracciamento del Tempo (1/1)
- ✅ JIRA_LOG_TIME: Registra il tempo di lavoro con commenti e descrizioni
Gestione degli Sprint (2/2)
- ✅ JIRA_LIST_BOARDS_AND_SPRINTS: Visualizza le board disponibili e gli sprint attivi
- ✅ JIRA_CREATE_SPRINT: Crea nuovi sprint e gestisci la pianificazione degli sprint
Passo 4: Sincronizzazione del Progetto
- Clicca su Sincronizza Progetti per recuperare i tuoi progetti JIRA
- Seleziona i progetti a cui desideri che il tuo assistente AI acceda
- Configura permessi e livelli di accesso specifici per il progetto
- Attendi il completamento della sincronizzazione iniziale
Capacità dell'Assistente AI
Ricerca e Gestione dei Problemi
Il tuo assistente AI può gestire query in linguaggio naturale come:
Esempi di Ricerca:
- "Trova tutti i problemi relativi ai cookie"
- "Mostrami i bug ad alta priorità assegnati a John"
- "Elenca tutti i compiti nello sprint attuale"
- "Quali sono i problemi aperti per il progetto CCS?"
Dettagli del Problema:
User: "Parlami del problema CCS-11"
AI: Ecco i dettagli per CCS-11:
- Titolo: Preparare biscotti al cioccolato con contenuto dettagliato
- Stato: Da Fare
- Priorità: Bassa
- Assegnatario: Non assegnato
- Descrizione: [Descrizione completa del problema]
Creazione di Problemi
Crea problemi tramite comandi conversazionali:
Esempi di Creazione:
- "Crea un rapporto di bug per il problema di accesso"
- "Aggiungi un compito per implementare l'autenticazione degli utenti"
- "Crea una storia per la nuova funzionalità del dashboard"
Registrazione del Tempo
Registra il tempo di lavoro con linguaggio naturale:
Esempi di Tracciamento del Tempo:
User: "@PO Bot confermo che i biscotti sono nel forno per CCS-11, e registro 2 ore di termostato 200"
AI Response:
✅ Tempo registrato con successo per CCS-11:
- Tempo Speso: 2 ore
- Commento: Biscotti nel forno a 200°C
- Data di Inizio: 14 novembre 2025, 12:00 PM
Gestione degli Sprint
Gestisci sprint e bacheche in modo conversazionale:
Esempi di Sprint:
- "Cosa c'è nel nostro sprint attuale?"
- "Crea un nuovo sprint per la prossima settimana"
- "Mostrami tutte le bacheche disponibili"
- "Sposta CCS-11 nello sprint attivo"
Funzionalità JIRA Supportate
Tipi di Problemi
| Tipo | Supportato | Capacità AI |
|---|---|---|
| Epic | ✅ | Creare, aggiornare, collegare problemi secondari |
| Story | ✅ | Operazioni CRUD complete, stima dei punti storia |
| Task | ✅ | Gestione e tracciamento completi dei compiti |
| Bug | ✅ | Segnalazione di bug, assegnazione di gravità, tracciamento delle risoluzioni |
| Subtask | ✅ | Creazione di sotto-compiti e collegamento al problema principale |
Campi e Proprietà
| Campo | Lettura | Scrittura | Comprensione AI |
|---|---|---|---|
| Riepilogo | ✅ | ✅ | Elaborazione del linguaggio naturale |
| Descrizione | ✅ | ✅ | Supporto per testo ricco e formattazione |
| Stato | ✅ | ✅ | Gestione dello stato del flusso di lavoro |
| Priorità | ✅ | ✅ | Assegnazione intelligente della priorità |
| Assegnatario | ✅ | ✅ | Riconoscimento dei membri del team |
| Reporter | ✅ | ✅ | Mappatura automatica degli utenti |
| Etichette | ✅ | ✅ | Suggerimenti intelligenti per le etichette |
| Componenti | ✅ | ✅ | Organizzazione basata su componenti |
| Versione di Correzione | ✅ | ✅ | Integrazione della pianificazione delle versioni |
Risoluzione dei Problemi
Problemi Comuni
Problemi di Connessione
- Autenticazione Fallita:
- Verifica il formato dell'URL di JIRA (includi https://)
- Controlla la validità del token API
- Assicurati che l'account abbia le autorizzazioni appropriate
- Timeout di Rete:
- Verifica l'accessibilità dell'istanza JIRA
- Controlla le impostazioni del firewall
- Testa la connessione dai server di AI SmartTalk
Errori di Autorizzazione
- Autorizzazioni Insufficienti:
- Rivedi le autorizzazioni del progetto JIRA per il tuo account
- Controlla le autorizzazioni di navigazione del progetto e di creazione di problemi
- Verifica l'accesso da amministratore per la configurazione del progetto
- Accesso al Progetto Negato:
- Assicurati che l'utente sia aggiunto ai progetti target
- Controlla le impostazioni di visibilità del progetto
- Valida l'ortografia della chiave del progetto
Problemi di Sincronizzazione
- Progetti Non Caricati:
- Aggiorna la sincronizzazione del progetto
- Controlla le prestazioni dell'istanza JIRA
- Verifica i limiti di frequenza dell'API
- Aggiornamenti dei Problemi Non Riusciti:
- Controlla le autorizzazioni del flusso di lavoro dei problemi
- Verifica i requisiti dei campi e le regole di validazione
- Assicurati che il problema sia in uno stato modificabile
Ottimizzazione delle Prestazioni
Limiti di Frequenza dell'API
- Monitora l'Uso: Tieni traccia delle chiamate API e dei limiti di frequenza
- Operazioni in Batch: Raggruppa più operazioni quando possibile
- Strategia di Caching: Implementa un caching intelligente per i dati frequentemente accessibili
Gestione di Grandi Istanze
- Filtraggio dei Progetti: Sincronizza solo i progetti rilevanti
- Paginazione dei Problemi: Gestisci set di risultati grandi in modo efficiente
- Sincronizzazione Selettiva: Scegli tipi di problemi e stati specifici
Migliori Pratiche
Organizzazione del Progetto
- Nomenclatura Chiara: Usa nomi descrittivi per progetti e problemi
- Etichettatura Coerente: Mantieni una tassonomia delle etichette coerente
- Pulizia Regolare: Archivia progetti e problemi completati
Casi d'Uso ed Esempi
Automazione del Daily Standup
Team Member: "Mostrami cosa ho fatto ieri e cosa è pianificato per oggi"
AI: "Ieri hai completato CCS-9 (2 ore registrate) e CCS-10 (1.5 ore).
Oggi hai CCS-11 e CCS-12 assegnati nello sprint attuale."
Pianificazione dello Sprint
Scrum Master: "Crea un nuovo sprint che inizia lunedì per 2 settimane"
AI: "✅ Creato nuovo sprint 'Sprint 24' che inizia il 18 novembre 2025 per 2 settimane.
Pronto per aggiungere problemi dal backlog."
Segnalazione di Bug
QA Tester: "Crea un bug: Il modulo di accesso non convalida correttamente il formato dell'email, alta priorità"
AI: "✅ Creato bug CCS-15: 'Problema di convalida dell'email nel modulo di accesso'
- Priorità: Alta
- Assegnato a: Team di Sviluppo
- Aggiunto allo sprint attuale per attenzione immediata"
Monitoraggio dei Progressi
Product Owner: "Come stiamo procedendo con il progetto di preparazione dei biscotti?"
AI: "Stato del progetto biscotti (CCS):
- 5 problemi completati (CCS-1 a CCS-5)
- 3 in corso (CCS-7, CCS-9, CCS-11)
- 2 da fare (CCS-12, CCS-13)
- Completamento dello sprint: 67% in linea"