Aller au contenu principal

Intégration JIRA

Connectez votre assistant IA 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 IA de rechercher, créer, mettre à jour des problèmes, enregistrer du temps et gérer des sprints directement via des interactions en langage naturel.

Intégration JIRA

Vue d'ensemble

L'intégration JIRA permet à votre assistant IA de :

  • Rechercher des problèmes : Trouver des problèmes en utilisant des requêtes en langage naturel
  • Afficher 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 bugs
  • Mettre à jour des problèmes : Modifier le statut, la priorité, l'assigné et d'autres champs
  • Suivi du temps : Enregistrer le temps de travail avec des commentaires et descriptions détaillés
  • Gestion des sprints : Lister les tableaux, sprints et gérer la planification des sprints
  • Gestion de projet : Accéder aux informations du projet et aux données de collaboration d'é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 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

  1. Connectez-vous à votre compte AI SmartTalk
  2. Naviguez vers AdministrationMes assistants[Nom de votre assistant]
  3. Cliquez sur Connecteurs dans la barre latérale gauche
  4. Localisez JIRA dans la liste des connecteurs disponibles
  5. Cliquez sur la tuile d'intégration JIRA

Étape 2 : Configurer la connexion JIRA

  1. URL JIRA : Entrez l'URL de votre instance JIRA (ex : https://votreentreprise.atlassian.net)
  2. Nom d'utilisateur/Email : Fournissez l'adresse email de votre compte JIRA
  3. Token API : Générez et entrez votre token API JIRA
    • Allez dans les paramètres de votre compte Atlassian
    • Naviguez vers Sécurité → Créer et gérer les tokens API
    • Générez un nouveau token pour l'intégration AI SmartTalk
  4. Cliquez sur Configurer pour établir la connexion

Étape 3 : Activer les capacités IA

Outils JIRA

Configurez les capacités IA que vous souhaitez activer :

Gestion des problèmes (4/4)

  • JIRA_SEARCH_ISSUES : Rechercher et filtrer des problèmes en utilisant le 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 bugs
  • 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 commentaires et descriptions

Gestion des sprints (2/2)

  • JIRA_LIST_BOARDS_AND_SPRINTS : Afficher 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

Synchronisation JIRA

  1. Cliquez sur Synchroniser les projets pour récupérer vos projets JIRA
  2. Sélectionnez les projets auxquels vous voulez que votre assistant IA ait accès
  3. Configurez les permissions et niveaux d'accès spécifiques aux projets
  4. Attendez que la synchronisation initiale soit terminée

Capacités de l'assistant IA

Recherche et gestion des problèmes

Votre assistant IA peut traiter des requêtes en langage naturel comme :

Exemples de recherche :

  • "Trouve tous les problèmes liés aux cookies"
  • "Montre-moi les bugs haute priorité assignés à Jean"
  • "Liste toutes les tâches du sprint actuel"
  • "Quels sont les problèmes ouverts pour le projet CCS ?"

Détails des problèmes :

Utilisateur : "Parle-moi du problème CCS-11"
IA : Voici les détails pour CCS-11 :
- Titre : Préparer des cookies au chocolat avec 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 via des commandes conversationnelles :

Exemples de création :

  • "Crée un rapport de bug pour le problème de connexion"
  • "Ajoute une tâche pour implémenter l'authentification utilisateur"
  • "Crée une story pour la nouvelle fonctionnalité de tableau de bord"

Enregistrement du temps

Enregistrez le temps de travail en langage naturel :

Exemples de suivi du temps :

Utilisateur : "@PO Bot je confirme que les cookies sont au four pour CCS-11, et je log 2h de thermostat 200"

Réponse IA :
✅ Temps enregistré avec succès pour CCS-11 :
- Temps passé : 2 heures
- Commentaire : Cookies au four à 200°C thermostat
- Date de début : 14 novembre 2025, 12:00

Gestion des sprints

Gérez les sprints et tableaux de manière conversationnelle :

Exemples de sprint :

  • "Qu'est-ce qu'il y a dans notre sprint actuel ?"
  • "Crée un nouveau sprint pour la semaine prochaine"
  • "Montre-moi tous les tableaux disponibles"
  • "Déplace CCS-11 vers le sprint actif"

Fonctionnalités JIRA supportées

Types de problèmes

TypeSupportéCapacités IA
EpicCréer, mettre à jour, lier les problèmes enfants
StoryOpérations CRUD complètes, estimation des story points
TâcheGestion et suivi complets des tâches
BugRapport de bugs, assignation de sévérité, suivi de résolution
Sous-tâcheCréation de sous-tâches et liaison au problème parent

Champs et propriétés

ChampLectureÉcritureCompréhension IA
RésuméTraitement du langage naturel
DescriptionSupport de texte riche et formatage
StatutGestion des états de workflow
PrioritéAssignation intelligente de priorité
AssignéReconnaissance des membres d'équipe
RapporteurMappage automatique des utilisateurs
ÉtiquettesSuggestions intelligentes d'étiquettes
ComposantsOrganisation basée sur les composants
Version de correctionIntégration de planification de release

Dépannage

Problèmes courants

Problèmes de connexion

  • Échec d'authentification :
    • Vérifiez le format de l'URL JIRA (incluez https://)
    • Vérifiez la validité du token API
    • Assurez-vous que le compte a les permissions appropriées
  • Timeout réseau :
    • Vérifiez l'accessibilité de l'instance JIRA
    • Vérifiez les paramètres de pare-feu
    • Testez la connexion depuis les serveurs AI SmartTalk

Erreurs de permissions

  • Permissions insuffisantes :
    • Examinez les permissions de projet JIRA pour votre compte
    • Vérifiez les permissions de navigation et création de problèmes
    • Vérifiez l'accès admin 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 ne se chargent pas :
    • Actualisez la synchronisation des projets
    • Vérifiez les performances de l'instance JIRA
    • Vérifiez les limites de taux API
  • Échec de mise à jour des problèmes :
    • Vérifiez les permissions de workflow des problèmes
    • Vérifiez les exigences et règles de validation des champs
    • Assurez-vous que le problème est dans un état modifiable

Optimisation des performances

Limites de taux API

  • Surveiller l'utilisation : Suivre les appels API et limites de taux
  • Opérations par lots : Grouper plusieurs opérations quand possible
  • Stratégie de cache : Implémenter un cache intelligent pour les données fréquemment consultées

Gestion d'instances importantes

  • Filtrage de projets : Synchroniser seulement les projets pertinents
  • Pagination des problèmes : Gérer efficacement les grands ensembles de résultats
  • Synchronisation sélective : Choisir des types et statuts de problèmes spécifiques

Bonnes pratiques

Organisation des projets

  • Nommage clair : Utilisez des noms descriptifs pour les projets et problèmes
  • Étiquetage cohérent : Maintenez une taxonomie d'étiquettes cohérente
  • Nettoyage régulier : Archivez les projets et problèmes terminés

Cas d'usage et exemples

Automatisation de standup quotidien

Membre d'équipe : "Montre-moi ce sur quoi j'ai travaillé hier et ce qui est prévu pour aujourd'hui"
IA : "Hier tu as terminé CCS-9 (2 heures enregistrées) et CCS-10 (1,5 heures).
Aujourd'hui tu as CCS-11 et CCS-12 assignés dans le sprint actuel."

Planification de sprint

Scrum Master : "Crée un nouveau sprint commençant lundi pour 2 semaines"
IA : "✅ Nouveau sprint 'Sprint 24' créé commençant le 18 novembre 2025 pour 2 semaines.
Prêt à ajouter des problèmes depuis le backlog."

Rapport de bugs

Testeur QA : "Crée un bug : Le formulaire de connexion ne valide pas correctement le format email, priorité haute"
IA : "✅ Bug CCS-15 créé : 'Problème de validation email du formulaire de connexion'
- Priorité : Haute
- Assigné à : Équipe de développement
- Ajouté au sprint actuel pour attention immédiate"

Suivi de progression

Product Owner : "Comment ça se passe sur le projet de préparation des cookies ?"
IA : "Statut du projet cookies (CCS) :
- 5 problèmes terminé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% dans les temps"