Integrazione JIRA
Collega il tuo assistente AI SmartTalk con Atlassian JIRA per abilitare capacità intelligenti di gestione dei 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 problemi utilizzando query in linguaggio naturale
- Visualizzare Dettagli dei Problemi: Ottenere informazioni complete su problematiche specifiche
- Creare Problemi: Generare automaticamente nuovi ticket, attività o bug
- Aggiornare Problemi: Modificare stato, priorità, assegnatario e altri campi dei problemi
- Tracciamento del Tempo: Registrare il tempo di lavoro con commenti e descrizioni dettagliate
- Gestione degli Sprint: Elencare bacheche, sprint e gestire la pianificazione degli sprint
- Gestione dei Progetti: Accedere alle informazioni di progetto e ai dati di collaborazione del team
Prerequisiti
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 permessi di progetto appropriati
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
- Individua JIRA nell'elenco dei connettori disponibili
- Clicca sulla tile dell'integrazione JIRA
Passo 2: Configura la Connessione JIRA
- URL JIRA: Inserisci l'URL della tua istanza JIRA (ad esempio,
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: Abilitare le capacità AI
Configura le capacità AI che desideri abilitare:
Gestione delle Issue (4/4)
- ✅ JIRA_SEARCH_ISSUES: Cerca e filtra le issue utilizzando il linguaggio naturale
- ✅ JIRA_GET_ISSUE: Recupera informazioni dettagliate su specifiche issue
- ✅ JIRA_CREATE_ISSUE: Crea nuove issue, attività e bug
- ✅ JIRA_UPDATE_ISSUE: Modifica le issue 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 bacheche disponibili e gli sprint attivi
- ✅ JIRA_CREATE_SPRINT: Crea nuovi sprint e gestisci la pianificazione degli sprint
Step 4: Sincronizzazione del Progetto
- Clicca su Sync Projects per recuperare i tuoi progetti JIRA
- Seleziona i progetti ai quali vuoi che il tuo assistente AI acceda
- Configura le autorizzazioni specifiche del progetto e i livelli di accesso
- 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 attraverso comandi conversazionali:
Esempi di Creazione:
- "Crea un rapporto di bug per il problema di accesso"
- "Aggiungi un compito per implementare l'autenticazione utente"
- "Crea una storia per la nuova funzionalità della 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 Trascorso: 2 ore
- Commento: Biscotti nel forno a 200°C di termostato
- 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 | ✅ | Creazione, aggiornamento, collegamento di problemi secondari |
| Story | ✅ | Operazioni CRUD complete, stima dei punti storia |
| Task | ✅ | Gestione e tracciamento completo dei task |
| Bug | ✅ | Segnalazione bug, assegnazione della gravità, tracciamento delle risoluzioni |
| Subtask | ✅ | Creazione di sottotask e collegamento al problema principale |
Campi e Proprietà
| Campo | Leggi | Scrivi | 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 |
| Segnalatore | ✅ | ✅ | Mappatura automatica degli utenti |
| Etichette | ✅ | ✅ | Suggerimenti intelligenti per le etichette |
| Componenti | ✅ | ✅ | Organizzazione basata sui 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 Permesso
- Permessi Insufficienti:
- Rivedi i permessi del progetto JIRA per il tuo account
- Controlla i permessi di navigazione del progetto e di creazione di problemi
- Verifica l'accesso amministrativo 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 i permessi del flusso di lavoro dei problemi
- Verifica i requisiti dei campi e le regole di convalida
- Assicurati che il problema sia in uno stato modificabile
Ottimizzazione delle Prestazioni
Limiti di Frequenza API
- Monitoraggio dell'Uso: Traccia le chiamate API e i 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 delle Issue: Gestisci set di risultati grandi in modo efficiente
- Sincronizzazione Selettiva: Scegli tipi di issue e stati specifici
Migliori Pratiche
Organizzazione del Progetto
- Nomenclatura Chiara: Utilizza 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 su cosa ho lavorato 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 nel 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 al sprint attuale per attenzione immediata"
Monitoraggio dei Progressi
Product Owner: "Come stiamo andando 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"