Réviseur de code IA pour Bitbucket

miniOrange AI Code Reviewer est une solution avancée conçue pour automatiser et optimiser les flux de travail de revue de code sur les dépôts Bitbucket de votre organisation. Elle s'intègre aux principaux fournisseurs d'IA, tels qu'OpenAI, Google Gemini, Anthropic, Microsoft Copilot et AWS Bedrock, afin de proposer une analyse automatisée et contextuelle des demandes de fusion, des règles de codage personnalisables et un retour d'information instantané.

Conditions préalables

Pour configurer l'outil d'analyse de code par IA pour Bitbucket, vous avez besoin des éléments suivants :

• Bitbucket doit être installé et configuré.
• Les informations d'identification de l'administrateur sont configurées dans Bitbucket.
• Une clé API valide de votre fournisseur d'IA choisi (par exemple, OpenAI, Google Gemini, Anthropic).

1 : Configuration du modèle d'IA (Configuration globale)

Avant de procéder à toute revue de code, l'application nécessite une connexion à un fournisseur LLM actif.

• Dans la barre latérale gauche, accédez à Modèles d'IA sous le Commencer .


• Cliquez sur + Ajouter un modèle bouton dans le coin supérieur droit de la page.
• Une boîte de dialogue « Connecter le modèle AI » s’affiche. Remplissez les champs suivants :


• Fournisseur : Sélectionnez votre fournisseur LLM préféré dans la liste déroulante (par exemple, Google Gemini, OpenAI, Anthropic, Microsoft Copilot, AWS Bedrock).
• Clé API: Saisissez la clé API fournie par la console développeur de votre fournisseur. Votre clé est stockée sous forme chiffrée. Cliquez sur « Détails » pour en savoir plus sur le stockage et la sécurité des clés.
• Modèle: Sélectionnez la version spécifique du modèle que vous souhaitez utiliser dans la liste déroulante (par exemple, Gemini 3 Pro – 1.0M).
• Avancé (facultatif) : Développez cette section pour configurer les paramètres avancés supplémentaires si nécessaire.
• Cliquez à nouveau Test de connexion pour vérifier que la clé API et la sélection du modèle sont valides.
• Une fois réussi, cliquez Connexion pour finaliser la configuration.
• Le modèle apparaîtra sous Modèles connectés avec Connectée et Active statut confirmant que l'application est prête à traiter les revues de code.

2 : Configuration des directives globales

Les directives globales définissent les normes de codage appliquées à tous les dépôts et doivent être configurées avant que les paramètres spécifiques à chaque dépôt ne soient disponibles.

• Dans la barre latérale gauche, accédez à Lignes directrices mondiales sous le Configuration .


• Cliquez sur + Ajouter une directive bouton dans le coin supérieur droit de la page.
• An Ajouter une directive de codage Une boîte de dialogue s'affiche. Choisissez comment définir votre ligne directrice en utilisant l'une des trois méthodes de saisie :


• Texte : Saisissez manuellement votre directive en remplissant les champs suivants :
• Titre: Saisissez un nom descriptif pour la directive (par exemple, « Normes de codage Java »).
• Langue / Portée : Sélectionnez le langage de programmation auquel s'applique cette directive, ou choisissez « Tous les langages » pour l'appliquer à tous.
• Contenu des lignes directrices : Saisissez les consignes de codage dans la zone de texte (par exemple : « Tout le code doit respecter les contrôles de sécurité stricts de l’OWASP. »).
• URL: Fournissez une URL renvoyant vers un document de directives hébergé en externe.
• Confluence: Créez un lien direct vers une page Confluence contenant vos normes de codage.
• Cliquez à nouveau Ajouter une directive économiser, ou Annuler pour supprimer et fermer le dialogue.
• La nouvelle directive ajoutée apparaîtra sous le Lignes directrices actives onglet, confirmant que la modification est active et appliquée à tous les dépôts.

3 : Configuration et remplacement du référentiel

Une fois les directives globales définies, le comportement de revue de code peut être affiné pour chaque dépôt directement dans Bitbucket.

• Accédez à votre dépôt dans Bitbucket et cliquez sur Paramètres du référentiel en bas de la barre latérale gauche.


• Dans le panneau Paramètres du référentiel, faites défiler vers le bas jusqu'à Applications Forge et cliquez sur miniOrange AI Code Reviewer pour ouvrir la page de configuration de l'application.


• En vertu des Normes sur l’information et les communications, les organismes doivent rendre leurs sites et applications Web accessibles. Ils y parviennent en conformant leurs sites Web au niveau AA des Web Content Accessibility Guidelines (WCAG). Vérifier la configuration onglet, recherchez le Révision automatisée du code section et activez la Analyse de code par IA et scanner de vulnérabilités pour Bitbucket dans ce dépôt Activer/désactiver cette option. Une fois activée, l'IA examinera automatiquement les demandes de fusion en fonction de votre configuration.


• Cliquez sur Lignes directrices et logique Onglet permettant de configurer les normes d'examen pour ce dépôt :
• Consignes de codage : En vertu des Normes sur l’information et les communications, les organismes doivent rendre leurs sites et applications Web accessibles. Ils y parviennent en conformant leurs sites Web au niveau AA des Web Content Accessibility Guidelines (WCAG). Lignes directrices mondiales Dans cette section, sélectionnez les directives globales qui doivent s'appliquer à ce dépôt en cochant les cases correspondantes (par exemple, Directives générales de sécurité, Forge). Les directives non sélectionnées ne seront pas appliquées aux revues de ce dépôt.


• Examen de la logique métier : Activez la Activer l'analyse de la logique métier Activez cette option pour permettre à l'IA d'analyser les demandes d'extraction afin de vérifier la conformité de la logique métier, les violations des règles du domaine et les incohérences du flux de travail. Contexte d'affaires Dans ce champ, décrivez les règles métier clés, les contraintes de domaine ou la logique de flux de travail dont l'IA doit être consciente (par exemple : « Les montants des paiements ne doivent jamais être négatifs. Les remboursements nécessitent l'approbation du responsable pour les montants supérieurs à 500 $. »).


• Cliquez à nouveau Enregistrer les modifications en haut à droite pour appliquer la configuration à toutes les révisions ultérieures de ce dépôt.

4 : Réaliser une revue de code

Les revues de code peuvent être déclenchées directement depuis la vue Pull Request dans Bitbucket.

• Ouvrir toute activité Demande de tirage dans un référentiel configuré.
• Localisez le Panel de révision de code IA miniOrange Intégré sur le côté droit de la vue RP.


• Cliquez à nouveau Préparer la révisionLe système effectuera une vérification préalable, analysant les différences pour calculer la taille des jetons et énumérer les fichiers modifiés.
• On vous présentera un Sélection de fichier Interface. Par défaut, les fichiers volumineux en termes de contexte ou non pertinents (par exemple, package-lock.json, les fichiers générés automatiquement) peuvent être marqués ou désélectionnés afin d'optimiser l'utilisation de la fenêtre de contexte.


• Ajustez la sélection de fichiers si nécessaire.
• Assurez-vous que le nombre de jetons reste dans les limites de votre modèle.
• Cliquez à nouveau Commencer l'évaluation pour lancer l'analyse.

5 : Analyse des résultats et des indicateurs

L'IA traite les différences sélectionnées par lots afin de préserver le contexte. Les mises à jour en temps réel sont affichées dans le panneau PR pendant le traitement.

Commentaires en ligne

• Une fois le processus terminé, l'IA publie des commentaires exploitables et intégrés directement dans la vue RP, identiques aux évaluations par les pairs classiques.

Tableau de bord Analytics

• Accédez à la Tableau de bord pour examiner les données de télémétrie agrégées de tous les référentiels.
• Le tableau de bord fournit des informations sur :
• Temps moyen d'exécution des révisions à travers les référentiels.
• Problèmes identifiés au total, classées par gravité, sécurité, qualité et performance.
• Scores de santé de l'IA, reflétant la confiance du modèle et la conservation du contexte lors du traitement par lots.
• Utilisez le bouton intervalle de temps Des filtres sont disponibles dans le tableau de bord pour analyser les performances de l'équipe et identifier les vulnérabilités récurrentes sur des plages de dates personnalisées.

Pratiques d'excellence

• Définir des lignes directrices claires : Assurez-vous que votre consigne aux réviseurs soit conforme aux normes internes de votre organisation en matière de rétroaction cohérente et précise.
• Examinez régulièrement les données télémétriques : Surveillez régulièrement les analyses du tableau de bord pour maintenir une vue d'ensemble de la santé du code, des temps d'exécution et de la compréhension du contexte par l'IA.

Ressources supplémentaires

• Réviseur de code IA conçu pour Bitbucket