Intégration de Copilot agent cloud à Jira

L’intégration GitHub Copilot dans Jira vous permet d’appeler Agent cloud Copilot sans quitter votre espace de travail Jira. Depuis Jira, vous pouvez initier des sessions agent de cloud et ouvrir des pull requests, à partir du contexte fourni par le titre, la description, les libellés, les commentaires et les champs personnalisés Atlassian, tels que les critères d’acceptation.

Prerequisites

• Vous devez disposer d’un compte GitHub ayant accès à Copilot via un forfait payant Copilot.
• Vous devez disposer d’un compte Jira Cloud, Jira doit être une application compatible avec l’IA, et Rovo doit être activé pour votre organisation. Consultez Activer l’IA pour les applications dans la documentation Atlassian.
• L’installation et l’authentification doivent être effectuées pour Jira et GitHub.

Installation

Pour installer l’application GitHub Copilot Jira et l’autoriser pour votre organisation ou compte GitHub d’entreprise, vous avez besoin des éléments suivants :

• Autorisation d’administrateur pour votre site Jira.
• Autorisations pour le propriétaire ou le gestionnaire d’applications de votre organisation GitHubGitHub.

Cette intégration s’appuie sur une application Atlassian Forge et une GitHub application. Les deux sont nécessaires pour l’intégration. Une fois l’installation réussie, les utilisateurs autorisés de l’espace de travail Jira disposant d’un accès en écriture à un GitHub référentiel pourront déclencher l’agent à partir de Jira.

Installation de l'application Jira GitHub Copilot pour GitHub.com

1. Accédez à la GitHub Copilot page d’installation de Jira sur atlassian Marketplace.

2. Cliquez sur Obtenir maintenant.

3. Sélectionnez le site Atlassian dans lequel vous souhaitez installer l’application GitHub .

4. Cliquez sur Vérifier pour vérifier les détails de l’installation, puis cliquez sur Obtenir maintenant.

   Une fois GitHub Copilot installé sur votre instance Jira, vous devez autoriser l’application à accéder à votre organisation GitHub et à vos dépôts.

5. Cliquez sur Configurer dans le message de confirmation dans Jira après l’installation.

   • Si vous n’êtes pas redirigé automatiquement, accédez à la GitHub Copilot page d’installation de Jira sur le GitHub Marketplace. Cliquez sur Installer.

6. Si vous n’êtes pas encore connecté à GitHub, cliquez sur Se connecter à GitHub et suivez les instructions pour vous connecter à votre compte GitHub et autoriser l’application.

   • Si votre organisation ou entreprise utilise l’authentification unique (SSO), vous devrez peut-être démarrer une session SAML active pour votre organisation et effectuer une étape d’autorisation supplémentaire.

7. Cliquez sur Installer l’application pour autoriser l’application à accéder aux informations sur votre compte GitHub.

8. Choisissez l’organisation et les référentiels auxquels l’application a accès. Vos GitHub organisations sont activées par défaut pour votre espace de travail Jira. Si vous le souhaitez, dans la page Installer GitHub Copilot pour Jira , désélectionnez l’organisation et les dépôts auxquels vous ne souhaitez pas que l’application ait accès.

9. Cliquez sur Installer.

10. Une fois l’installation terminée, vous verrez une liste d’organisations connectées sur la GitHub Copilot page de configuration de l’application Jira dans Jira.

Installation de l'application Jira GitHub Copilot pour GHE.com

1. Accédez à la GitHub Copilot page d’installation de Jira (GHEC with Data Residency) sur Atlassian Marketplace.

2. À droite du nom de l’application, cliquez sur , puis entrez votre SUBDOMAIN.ghe.com dans la zone de texte. Remplacez SUBDOMAIN par le sous-domaine de votre entreprise de GHE.com.

3. Cliquez sur Enregistrer la configuration.

4. Cliquez sur Obtenir maintenant.

5. Sélectionnez le site Atlassian dans lequel vous souhaitez installer l’application GitHub .

6. Cliquez sur Vérifier pour vérifier les détails de l’installation, puis cliquez sur Obtenir maintenant.

   Une fois GitHub Copilot installé sur votre instance Jira, vous devez autoriser l’application à accéder à votre organisation GitHub et à vos dépôts.

7. Cliquez sur Configurer dans le message de confirmation dans Jira après l’installation.

   • Si vous n’êtes pas redirigé automatiquement, recherchez l’application GitHub Copilot Jira dans la liste des applications disponibles pour votre entreprise à l’adresse SUBDOMAIN.ghe.com/apps/external-app/github-copilot-for-jira. Cliquez sur Installer.

8. Si vous n’êtes pas déjà connecté à GitHub, cliquez sur le lien en surbrillance Se connecter à GitHub, puis suivez les instructions pour vous connecter à votre compte GitHub et autoriser l’application.

   • Si votre organisation ou votre entreprise utilise l’authentification unique, vous devrez peut-être démarrer une session SAML active pour votre organisation et effectuer une étape d’autorisation supplémentaire.

9. Cliquez sur Installer l’application pour autoriser l’application à accéder aux informations sur votre compte GitHub.

10. Choisissez l’organisation et les référentiels auxquels l’application a accès. Vos GitHub organisations sont activées par défaut pour votre espace de travail Jira. Si vous le souhaitez, dans la page Installer GitHub Copilot pour Jira , désélectionnez l’organisation et les dépôts auxquels vous ne souhaitez pas que l’application ait accès.

11. Cliquez sur Installer.

12. Une fois l’installation terminée, vous verrez une liste d’organisations connectées sur la GitHub Copilot page de configuration de l’application Jira dans Jira.

Utilisation de l’application GitHub Copilot dans Jira

L’application Copilot doit être activée pour une GitHub organisation dont vous êtes membre, avant de pouvoir commencer à l’utiliser.

La première fois que vous utilisez Agent cloud Copilot dans Jira, vous devez le connecter à votre GitHub compte.

Seuls les utilisateurs disposant d’un accès en écriture à un référentiel peuvent déclencher Agent cloud Copilot pour travailler dans ce référentiel.

Vous pouvez déclencher Agent cloud Copilot de plusieurs façons :

• AttribuerGitHub Copilot à un élément de travail à l’aide du champ Assignee.
• Mentionner@GitHub Copilot dans un commentaire sur un élément de travail.
• Utilisez une automatisation Jira. Dans vos règles d’automatisation Jira, sélectionnez l’action Utiliser GitHub Copilot et configurez votre flux pour utiliser un déclencheur personnalisé basé sur des événements Jira, tels que lorsqu’un élément de travail est créé ou transféré, ou qu’une étiquette est appliquée. Pour plus d’informations, consultez Utiliser des agents IA dans Jira dans la documentation Atlassian.

Exemple : Déclenchement de Agent cloud Copilot à partir d’un élément de travail Jira

1. Dans Jira, ouvrez ou créez un élément de travail qui contient des exigences claires auxquelles vous souhaitez déléguer Agent cloud Copilot.

2. Pour spécifier un référentiel dans lequel vous souhaitez travailler, mentionnez-le Copilot dans la description de l’élément de travail ou dans un commentaire.

3. Affectez GitHub Copilot à l’élément de travail ou mentionnez @GitHub Copilot dans un commentaire. Par exemple:

   @GitHub Copilot create a new API endpoint for user authentication in octo-org/octorepo
   

4. Si vous n’avez pas précédemment connecté l’application GitHub dans Jira à votre compte GitHub, suivez les invites pour autoriser l'application pour GitHub et Atlassian.

5. Lorsque Agent cloud Copilot commencera à travailler sur la pull request, un commentaire apparaîtra dans le panneau de discussion de Jira. L’utilisateur qui a lancé la session de l’agent peut afficher la progression là-bas.

6. Vous pouvez ensuite donner des instructions supplémentaires pour Copilot :

   • Utilisez le bouton Poursuivre dans le chat sous l’en-tête Agents pour discuter directement avec Copilot afin d’apporter des mises à jour à la pull request actuelle.
   • Mentionnez @GitHub Copilot dans un commentaire de l’élément de travail pour que les mises à jour soient effectuées dans une nouvelle pull request.

Affichage de l’activité de l’agent dans Jira

Pendant que agent de cloud diffuse ses flux d’activité en direct dans le panneau de chat de Jira, vous pouvez ainsi suivre ce que fait l’agent sans quitter votre élément de travail. Le flux d’activité inclut un lien vers la session d’agent associée sur GitHub.

Redirection Copilot depuis Jira après la session

Lorsque Agent cloud Copilot a terminé une session, par exemple lorsqu’une pull request est prête à être revue, vous pouvez demander à Copilot de poursuivre le travail :

• Dans le panneau de conversation de Jira, sélectionnez le lien vers la session d’agent associée sur GitHub. Cela ouvre le panneau des agents dans GitHub, où vous pouvez consulter la session et envoyer des instructions de suivi pour mettre à jour la pull request existante.
• Ajoutez une mention de suivi @GitHub Copilot ou un commentaire sur l’élément de travail Jira. Cela démarre une nouvelle session et ouvre une nouvelle pull request au lieu de mettre à jour la pull request existante.

Personnalisation de Agent cloud Copilot dans Jira

Vous pouvez personnaliser le Agent cloud Copilot fonctionnement de votre espace de travail Jira en spécifiant des modèles, des agents et des instructions personnalisées.

Spécification d’un modèle

Spécifiez un modèle lorsque vous souhaitez qu’une tâche s’exécute sur un modèle spécifique plutôt que sur la valeur par défaut. Par exemple, vous pouvez choisir un modèle plus léger pour des modifications courantes et bien définies. Pour modifier le modèle utilisé par Agent cloud Copilot pour une tâche particulière, incluez le nom du modèle dans vos instructions à Copilot ; consultez Modification du modèle IA pour GitHub Copilot agent cloud.

Spécification d’un agent personnalisé

Spécifiez un agent personnalisé pour adapter agent de cloudle comportement d’un flux de travail ou d’un référentiel particulier. Vous pouvez spécifier un agent personnalisé à partir de votre GitHub référentiel directement dans le ticket Jira. Pour plus d’informations, consultez « Création d’agents personnalisés pour Agent cloud Copilot ».

Utilisation d’instructions personnalisées

Utilisez des instructions personnalisées pour définir des valeurs par défaut qui s’appliquent à chaque session, comme le référentiel cible, afin que Copilot n’ait pas à s’interrompre pour vous demander des informations en cours de session. Vous pouvez définir des instructions personnalisées au niveau de l’espace de travail Jira qui s’appliquent chaque fois que Agent cloud Copilot est déclenché.

Coûts d’utilisation

Agent cloud Copilot utilise GitHub Actions minutes et AI credits.

Pour plus d’informations, consultez « Facturation basée sur l’utilisation pour les organisations et les entreprises ».

Ajout ou suppression d’une organisation à l’application GitHub Copilot Jira

Un administrateur Jira et GitHub un propriétaire de l’organisation peuvent activer ou désactiver des organisations pour l’intégration.

Pour modifier les autorisations d’accès à l’application GitHub Copilot pour Jira pour une organisation :

1. Dans Jira, accédez à la page des paramètres de votre espace de travail.
2. Accédez à la page des paramètres des applications pour l’application GitHub Copilot .
3. Si vous le souhaitez, cliquez sur Connecter d’autres GitHub organisations pour ajouter de nouvelles organisations à la liste.
4. Activez ou désactivez l’application Copilot pour une ou plusieurs des organisations répertoriées.

Résolution des problèmes

Si vous rencontrez des problèmes, essayez les solutions suivantes.

Vous ne pouvez pas voir le Agent cloud Copilot et il n’est pas possible de l’affecter à un élément de travail Jira

Dans Jira, vérifiez que vos paramètres d’administration Atlassian pour votre organisation sont définis comme suit.

1. Jira est une application compatible avec l’IA, consultez Activer l’IA pour les applications dans la documentation Atlassian.

Vous pouvez voir Agent cloud Copilot, mais il n’est pas possible de l’affecter à un élément de travail Jira.

Vérifiez que vous avez connecté votre compte GitHub personnel à l’application GitHub Copilot Jira.

1. Dans Jira, accédez à la page paramètres de votre compte personnel.
2. Sous vos paramètres généraux, sélectionnez l’application GitHub Copilot Jira .
3. Si vous n’êtes pas déjà connecté avec GitHub, suivez les invites pour vous connecter et autoriser l’application.

Lorsque vous discutez avec GitHub Copilot, vous êtes invité à vous connecter

Pour vous connecter à l’application Jira GitHub Copilot, suivez les étapes ci-dessus indiquées dans Vous pouvez voir le Agent cloud Copilot, mais il n’est pas possible de l’assigner à un élément de travail Jira.

D’autres utilisateurs de votre espace de travail peuvent affecter Agent cloud Copilot à un élément de travail Jira, mais vous ne pouvez pas

Si Agent cloud Copilot ne peut pas voir ou utiliser les ressources de votre organisation dans Jira et que votre organisation utilise l’authentification unique (SSO) dans GitHub, vous devrez peut-être réautoriser l’application GitHub Copilot pour Jira pour votre compte GitHub. Pour plus d’informations, consultez « À propos de l’authentification unique ».

Pour résoudre ce problème, procédez comme suit pour démarrer une nouvelle session d’authentification unique active pour votre organisation :

1. Accédez aux paramètres de votre organisation dans GitHub.
2. Sous « Authentification unique », recherchez l’organisation à laquelle vous devez vous authentifier, puis cliquez sur Se déconnecter, puis connectez-vous.
   • Si votre entreprise gère l’authentification unique pour votre organisation, la connexion à une organisation de l’entreprise fonctionne comme une session d’authentification unique pour toutes les organisations de l’entreprise.
3. Revenez à Jira et actualisez la page dans laquelle vous travaillez.
4. Réessayez d’utiliser Agent cloud Copilot dans Jira.

GitHub Copilot ne répond pas

• Vérifiez la GitHub de pour tout incident actif.
• Vérifiez la page d’état Atlassian pour tous les incidents actifs.
• Vérifiez que Agent cloud Copilot a accès au référentiel en testant si vous pouvez assigner Copilot à un problème dans GitHub.
• Vérifiez que l'application Jira GitHub Copilot a accès au référentiel. Consultez « Révision et modification des applications GitHub installées ».

Lectures complémentaires

• À propos de GitHub Copilot agent cloud
• Gestion de l’accès à GitHub Copilot agent cloud
• Configurer des serveurs MCP pour votre référentiel
• Collaborer sur des éléments de travail avec des agents IA dans la documentation Atlassian