Intégration JIRA
Connectez votre assistant AI SmartTalk avec Atlassian JIRA pour activer des capacités intelligentes de gestion de projet et de suivi des problèmes. Cette intégration permet à votre assistant AI de rechercher, créer, mettre à jour des problèmes, enregistrer du temps et gérer des sprints directement via des interactions en langage naturel.
Aperçu
L'intégration JIRA permet à votre assistant AI de :
- Rechercher des problèmes : Trouver des problèmes en utilisant des requêtes en langage naturel
- Voir les détails des problèmes : Obtenir des informations complètes sur des problèmes spécifiques
- Créer des problèmes : Générer automatiquement de nouveaux tickets, tâches ou bogues
- Mettre à jour des problèmes : Modifier le statut, la priorité, l'assigné et d'autres champs des problèmes
- Suivi du temps : Enregistrer le temps de travail avec des commentaires et des descriptions détaillés
- Gestion des sprints : Lister les tableaux, les sprints et gérer la planification des sprints
- Gestion de projet : Accéder aux informations sur le projet et aux données de collaboration de l'équipe
Prérequis
Avant de commencer, assurez-vous d'avoir :
- Un compte AI SmartTalk actif avec accès à la configuration de l'assistant
- Une instance JIRA Cloud ou Server avec des privilèges d'administrateur
- L'accès API activé dans votre instance JIRA
- Des identifiants de compte utilisateur avec les permissions de projet appropriées
Configuration étape par étape
Étape 1 : Accéder à l'intégration JIRA
- Connectez-vous à votre compte AI SmartTalk
- Accédez à Administration → Mes assistants → [Nom de votre assistant]
- Cliquez sur Connecteurs dans la barre latérale gauche
- Localisez JIRA dans la liste des connecteurs disponibles
- Cliquez sur la tuile d'intégration JIRA
Étape 2 : Configurer la connexion JIRA
- URL JIRA : Entrez l'URL de votre instance JIRA (par exemple,
https://yourcompany.atlassian.net) - Nom d'utilisateur/Email : Fournissez l'adresse email de votre compte JIRA
- Jeton API : Générez et entrez votre jeton API JIRA
- Allez dans les paramètres de votre compte Atlassian
- Accédez à Sécurité → Créer et gérer des jetons API
- Générez un nouveau jeton pour l'intégration AI SmartTalk
- Cliquez sur Configurer pour établir la connexion
Étape 3 : Activer les capacités AI
Configurez les capacités AI que vous souhaitez activer :
Gestion des problèmes (4/4)
- ✅ JIRA_SEARCH_ISSUES : Rechercher et filtrer les problèmes en utilisant un langage naturel
- ✅ JIRA_GET_ISSUE : Récupérer des informations détaillées sur des problèmes spécifiques
- ✅ JIRA_CREATE_ISSUE : Créer de nouveaux problèmes, tâches et bogues
- ✅ JIRA_UPDATE_ISSUE : Modifier les problèmes existants et leurs propriétés
Suivi du temps (1/1)
- ✅ JIRA_LOG_TIME : Enregistrer le temps de travail avec des commentaires et des descriptions
Gestion des sprints (2/2)
- ✅ JIRA_LIST_BOARDS_AND_SPRINTS : Voir les tableaux disponibles et les sprints actifs
- ✅ JIRA_CREATE_SPRINT : Créer de nouveaux sprints et gérer la planification des sprints
Étape 4 : Synchronisation des projets
- Cliquez sur Synchroniser les projets pour récupérer vos projets JIRA
- Sélectionnez les projets auxquels vous souhaitez que votre assistant AI accède
- Configurez les autorisations et niveaux d'accès spécifiques aux projets
- Attendez que la synchronisation initiale soit terminée
Capacités de l'Assistant IA
Recherche et Gestion des Problèmes
Votre assistant IA peut gérer des requêtes en langage naturel telles que :
Exemples de Recherche :
- "Trouvez tous les problèmes liés aux cookies"
- "Montrez-moi les bugs de haute priorité assignés à John"
- "Listez toutes les tâches dans le sprint actuel"
- "Quels sont les problèmes ouverts pour le projet CCS ?"
Détails du Problème :
User: "Parlez-moi du problème CCS-11"
AI: Voici les détails pour CCS-11 :
- Titre : Préparer des cookies au chocolat avec un contenu détaillé
- Statut : À faire
- Priorité : Faible
- Assigné à : Non assigné
- Description : [Description complète du problème]
Création de Problèmes
Créez des problèmes par le biais de commandes conversationnelles :
Exemples de Création :
- "Créez un rapport de bug pour le problème de connexion"
- "Ajoutez une tâche pour implémenter l'authentification des utilisateurs"
- "Créez une histoire pour la nouvelle fonctionnalité du tableau de bord"
Journalisation du Temps
Enregistrez le temps de travail avec un langage naturel :
Exemples de Suivi du Temps :
User: "@PO Bot Je confirme que les cookies sont dans le four pour CCS-11, et j'enregistre 2 heures de thermostat 200"
AI Response:
✅ Temps enregistré avec succès pour CCS-11 :
- Temps Passé : 2 heures
- Commentaire : Cookies dans le four à thermostat 200°C
- Date de Début : 14 novembre 2025, 12:00 PM
Gestion des Sprints
Gérez les sprints et les tableaux de manière conversationnelle :
Exemples de Sprint :
- "Qu'est-ce qu'il y a dans notre sprint actuel ?"
- "Créez un nouveau sprint pour la semaine prochaine"
- "Montrez-moi tous les tableaux disponibles"
- "Déplacez CCS-11 vers le sprint actif"
Fonctionnalités JIRA Supportées
Types de Problèmes
| Type | Supporté | Capacités de l'IA |
|---|---|---|
| Epic | ✅ | Créer, mettre à jour, lier des problèmes enfants |
| Story | ✅ | Opérations CRUD complètes, estimation des points d'histoire |
| Task | ✅ | Gestion et suivi complets des tâches |
| Bug | ✅ | Rapport de bug, attribution de gravité, suivi de résolution |
| Subtask | ✅ | Création de sous-tâches et liaison avec le problème parent |
Champs et Propriétés
| Champ | Lire | Écrire | Compréhension de l'IA |
|---|---|---|---|
| Résumé | ✅ | ✅ | Traitement du langage naturel |
| Description | ✅ | ✅ | Support de texte enrichi et de formatage |
| Statut | ✅ | ✅ | Gestion de l'état du flux de travail |
| Priorité | ✅ | ✅ | Attribution intelligente de priorité |
| Assigné à | ✅ | ✅ | Reconnaissance des membres de l'équipe |
| Rapporteur | ✅ | ✅ | Cartographie automatique des utilisateurs |
| Étiquettes | ✅ | ✅ | Suggestions d'étiquettes intelligentes |
| Composants | ✅ | ✅ | Organisation basée sur les composants |
| Version de Correction | ✅ | ✅ | Intégration de la planification des versions |
Dépannage
Problèmes Courants
Problèmes de Connexion
- Échec de l'Authentification :
- Vérifiez le format de l'URL JIRA (inclure https://)
- Vérifiez la validité du jeton API
- Assurez-vous que le compte dispose des autorisations appropriées
- Délai d'Attente du Réseau :
- Vérifiez l'accessibilité de l'instance JIRA
- Vérifiez les paramètres du pare-feu
- Testez la connexion depuis les serveurs AI SmartTalk
Erreurs de Permission
- Permissions Insuffisantes :
- Examinez les permissions du projet JIRA pour votre compte
- Vérifiez les permissions de navigation dans le projet et de création d'incidents
- Vérifiez l'accès administrateur pour la configuration du projet
- Accès au Projet Refusé :
- Assurez-vous que l'utilisateur est ajouté aux projets cibles
- Vérifiez les paramètres de visibilité du projet
- Validez l'orthographe de la clé du projet
Problèmes de Synchronisation
- Projets Non Chargés :
- Rafraîchissez la synchronisation des projets
- Vérifiez la performance de l'instance JIRA
- Vérifiez les limites de taux de l'API
- Échecs de Mise à Jour des Incidents :
- Vérifiez les permissions du flux de travail des incidents
- Vérifiez les exigences de champ et les règles de validation
- Assurez-vous que l'incident est dans un état modifiable
Optimisation des Performances
Limites de Taux de l'API
- Surveiller l'Utilisation : Suivez les appels API et les limites de taux
- Opérations par Lots : Regroupez plusieurs opérations lorsque c'est possible
- Stratégie de Mise en Cache : Mettez en œuvre une mise en cache intelligente pour les données fréquemment accessibles
Gestion des Grandes Instances
- Filtrage des Projets : Synchronisez uniquement les projets pertinents
- Pagination des Incidents : Gérez efficacement les ensembles de résultats volumineux
- Synchronisation Sélective : Choisissez des types d'incidents et des statuts spécifiques
Meilleures Pratiques
Organisation des Projets
- Nommage Clair : Utilisez des noms de projet et d'incidents descriptifs
- Étiquetage Cohérent : Maintenez une taxonomie d'étiquettes cohérente
- Nettoyage Régulier : Archivez les projets et incidents terminés
Cas d'Utilisation et Exemples
Automatisation de la Réunion Quotidienne
Membre de l'Équipe : "Montre-moi ce sur quoi j'ai travaillé hier et ce qui est prévu pour aujourd'hui"
AI : "Hier, vous avez terminé CCS-9 (2 heures enregistrées) et CCS-10 (1,5 heure).
Aujourd'hui, vous avez CCS-11 et CCS-12 assignés dans le sprint actuel."
Planification de Sprint
Scrum Master : "Créez un nouveau sprint commençant lundi pour 2 semaines"
AI : "✅ Nouveau sprint 'Sprint 24' créé, commençant le 18 novembre 2025 pour 2 semaines.
Prêt à ajouter des incidents du backlog."
Rapport de Bug
Testeur QA : "Créez un bug : Le formulaire de connexion ne valide pas correctement le format de l'email, priorité élevée"
AI : "✅ Bug CCS-15 créé : 'Problème de validation de l'email du formulaire de connexion'
- Priorité : Élevée
- Assigné à : Équipe de Développement
- Ajouté au sprint actuel pour une attention immédiate"
Suivi des Progrès
Propriétaire de Produit : "Comment se passe le projet de préparation des cookies ?"
AI : "Statut du projet de cookies (CCS) :
- 5 incidents complétés (CCS-1 à CCS-5)
- 3 en cours (CCS-7, CCS-9, CCS-11)
- 2 à faire (CCS-12, CCS-13)
- Achèvement du sprint : 67% sur la bonne voie"