Intégration de Devin avec Jira

Il existe deux manières de connecter Jira Cloud à Devin. Toutes deux permettent de confier des éléments de travail Jira à Devin et de recevoir des pull requests en retour, mais elles diffèrent par leur installation et leur mode de déclenchement.

​

Quelle option choisir ?

• Les fonctionnalités d’agent de Jira Cloud sont activées dans votre espace de travail → utilisez l’agent Rovo. Devin apparaît dans le sélecteur de responsable et dans les @mentions comme n’importe quel autre agent, et rend compte de son travail sur la carte d’agent de l’élément de travail. L’association du site permet également d’utiliser les événements de ses éléments de travail Jira comme déclencheurs pour les automatisations Devin.
• Rovo est désactivé dans votre espace de travail Jira → utilisez un utilisateur de service. Devin agit via un compte de service Jira que vous créez et rend compte de son travail au moyen de commentaires et de liens distants.

Les deux options lancent des sessions Devin classiques, sont compatibles avec les automatisations Devin, sont soumises aux mêmes prérequis et sont facturées de la même manière.

​

Automatisations Devin

Les automatisations Devin permettent de démarrer Devin automatiquement depuis Jira, et elles fonctionnent avec les deux options. Une fois qu’un site Jira est connecté — lié via l’application Devin for Jira ou connecté avec un compte administrateur —, les événements de ses éléments de travail deviennent disponibles comme déclencheurs Jira. Choisissez-en un lors de la création de l’automatisation :

• Issue created — un élément de travail est créé.
• Issue updated — un champ quelconque d’un élément de travail est modifié ; les champs modifiés sont accessibles dans les conditions de l’automatisation.
• Label added — un libellé est ajouté à un élément de travail (un événement par libellé).
• Status changed — le statut d’un élément de travail change, ou un élément de travail est créé avec un statut.
• Assigned — un élément de travail est créé avec un responsable, ou son responsable change.
• Comment created — un commentaire est publié sur un élément de travail. Les commentaires publiés par Devin lui-même ne déclenchent pas l’automatisation.

Les conditions permettent de filtrer par projet, libellé, statut, responsable, epic (le parent de l’élément de travail) et résumé. À la fin de la session de l’automatisation, son message final est publié en commentaire sur l’élément de travail — depuis l’application Devin pour un site lié via l’application, ou via la connexion service-user pour un site connecté avec un compte administrateur. Si un site dispose des deux connexions, chaque événement n’est transmis qu’une seule fois, via la connexion service-user.

​

Option 1 : agent Rovo Devin dans Jira

Devin for Jira est une application Atlassian Forge reposant sur le connecteur d’agents Rovo. Une fois l’application installée et associée, Devin devient un agent de votre site Jira Cloud : assignez un élément de travail à Devin ou mentionnez @Devin dans un commentaire, et Devin planifie le travail, écrit le code, ouvre une pull request, puis rend compte de son travail dans l’élément de travail.

​

Configuration

La configuration se déroule en deux étapes : l’application est d’abord installée sur votre site Jira, puis un administrateur Devin associe ce site à un compte Devin.

​

1. Installer l’application sur votre site

1. Un administrateur Jira ouvre Devin sur l’Atlassian Marketplace et l’installe sur votre site Jira Cloud (your-site.atlassian.net).
2. L’administrateur Jira passe en revue les autorisations demandées par l’application, puis confirme. L’application lit et modifie les éléments de travail et les commentaires, lit les utilisateurs Jira et leurs adresses e-mail (afin de les associer aux utilisateurs Devin) et vérifie les autorisations des projets.

Une fois l’application installée, Devin apparaît en tant qu’agent sur le site, mais il ne peut pas se voir attribuer de tâches tant que le site n’est pas associé à un compte Devin.

​

2. Associer le site Jira à votre compte Devin

1. Dans Jira, accédez à Settings > Apps et ouvrez la page Devin ajoutée par l’application. Elle affiche « This site is not connected to a Devin account yet. »
2. Cliquez sur Connect to Devin. Une page Devin s’ouvre dans un nouvel onglet. Connectez-vous à Devin si vous y êtes invité.
3. Vérifiez que le site Jira affiché est bien le vôtre, choisissez le compte Devin auquel l’associer, puis cliquez sur Link site.
4. De retour dans Jira, cliquez sur Check again. La page affiche désormais le compte Devin auquel le site est connecté.

Le site associé apparaît dans Devin sous Settings > Connections > Jira sous le nom Devin app for Jira · installed from Jira, avec un badge Linked. Pour le déconnecter, ouvrez le menu Actions du site sur cette page, choisissez Unlink site…, puis confirmez avec Unlink site : Devin cesse immédiatement d’accepter de nouvelles tâches provenant de ce site Jira, mais les sessions déjà en cours dans Devin ne sont pas interrompues. Pour l’associer de nouveau, un administrateur Jira doit recliquer sur Connect to Devin dans Jira.

​

Déclencheurs

Pour démarrer Devin automatiquement à partir d’événements liés aux éléments de travail, utilisez les automatisations Devin. Il existe également deux façons de démarrer manuellement une session Devin à partir d’un élément de travail avec l’agent Rovo.

​

Assigner l’élément de travail à Devin

Sélectionnez Devin dans le champ Responsable de l’élément de travail. Devin démarre une session et traite l’élément de travail en s’appuyant sur son résumé et sa description pour définir la tâche.

• Les attributions répétées effectuées par une même personne dans un délai de cinq minutes sont considérées comme des doublons tant que la tâche reste active. Si l’élément de travail est réassigné plus tard, ou par une autre personne, une nouvelle session peut démarrer, même si la première est toujours en cours d’exécution.
• Le réassigner à Devin une fois que Devin a terminé démarre une nouvelle session.

​

@mentionner Devin dans un commentaire

Mentionnez @Devin dans un commentaire en donnant des instructions précises. Devin démarre une session qui traite votre commentaire comme la tâche à accomplir et la description de l’élément de travail comme contexte. Lorsque Devin a terminé ou s’interrompt pour vous poser une question, il publie son dernier message en commentaire sur l’élément de travail, en vous l’adressant. Chaque commentaire qui mentionne Devin démarre une session distincte. Pour poursuivre une session déjà en cours, répondez plutôt dans le panneau de l’agent.

​

Le panneau de l’agent

Pendant que Devin travaille, sa progression s’affiche dans le panneau de l’agent Jira de l’élément de travail :

• Statut en direct : le panneau de l’agent affiche la progression de Devin en temps réel.
• Lien vers la session : le premier message de Devin est un lien vers la session Devin dans la webapp, où vous pouvez suivre son travail ou prendre le relais.
• Messages de Devin : les réponses de Devin restent affichées sur la carte, mises en forme et avec des liens cliquables.
• Questions : si Devin a besoin de vous, la carte affiche sa question. Répondez via le chat de la tâche dans le panneau de l’agent Jira ; votre réponse est transmise à la même session Devin.
• Annulation : annuler la tâche depuis Jira arrête Devin et met la session en veille.

Seul l’utilisateur Jira qui a lancé une tâche Devin peut lui envoyer des messages ou l’annuler depuis Jira. Si Devin ne peut pas accepter un élément de travail, la carte en indique la raison : par exemple, le site Jira n’est pas encore lié à un compte Devin, votre compte Atlassian n’a pas pu être associé à un utilisateur Devin, ou l’organisation ou votre compte utilisateur ne peut plus consommer d’Agent Compute Units (ACU) pour le moment. Corrigez le problème, puis attribuez de nouveau l’élément de travail à Devin.

​

Liens de pull request

Les réponses de Devin dans le panneau d’agent Jira contiennent des liens vers les pull requests, et toute pull request ouverte par Devin mais non mentionnée est répertoriée sous Pull requests à la fin de la réponse. Pour les sessions lancées par une @mention, le message final de Devin est également publié en commentaire sur l’élément de travail ; il ne contient le lien de la pull request que si Devin l’y a ajouté.

​

Option 2 : utilisateur de service dans Jira

Avec cette option, Devin se connecte à votre site Jira via OAuth et agit par l’intermédiaire d’un compte de service Jira. Aucune installation n’est requise dans Jira : un administrateur Jira autorise Devin depuis les paramètres de Devin, puis vous créez dans Atlassian un compte de service qui devient l’identité de Devin dans Jira, c’est-à-dire l’utilisateur à qui vous assignez des éléments de travail et l’auteur des commentaires de Devin. Choisissez cette option lorsque Rovo est désactivé dans votre espace de travail Jira.

​

Configuration

​

1. Se connecter avec un compte administrateur

1. Dans Devin, accédez à Settings > Connections > Jira, cliquez sur Connect account, puis choisissez Connect with an admin account.
2. Connectez-vous à Atlassian en tant qu’administrateur Jira et accordez l’accès. Devin enregistre ses webhooks sur le site via ce compte.

Tant que vous n’avez pas ajouté de compte de service, les commentaires de Devin sont publiés sous le compte administrateur ayant connecté Jira, et les éléments de travail ne peuvent pas être assignés à Devin.

​

2. Ajouter un compte de service

1. Configurez un compte de service Atlassian avec des credentials OAuth 2.0 et les périmètres suivants :
   • read:me
   • read:jira-user
   • read:jira-work
   • write:jira-work
2. Accordez au compte de service l’accès à l’application Jira, ainsi que l’autorisation de parcourir les projets concernés, d’ajouter des commentaires, de modifier et de supprimer ses propres commentaires et de lier des tickets. Lorsque vous enregistrez les credentials, Devin les valide et signale les autorisations manquantes.
3. Dans Settings > Connections > Jira, ouvrez le menu de la connexion, choisissez Add service-account credentials, puis saisissez le Client ID et le Client Secret.

Dès lors, les commentaires de Devin sont publiés sous le nom du compte de service, et l’attribution d’un élément de travail à ce compte démarre une session. Vos webhooks sont conservés si vous remplacez ou supprimez les credentials. En temps normal, Devin publie via le compte de service configuré. S’il ne parvient pas à obtenir le token d’accès de ce compte, Devin peut se rabattre sur le token OAuth de l’administrateur qui a connecté Jira ; les commentaires peuvent alors apparaître sous le nom de cet administrateur.

​

3. Créer une automatisation

Pour lancer Devin automatiquement à partir d’événements sur les éléments de travail, créez une automatisation Devin avec un déclencheur Jira (voir Automatisations Devin).

​

Déclencheurs

Pour démarrer Devin automatiquement lorsque des éléments de travail sont créés ou modifiés, utilisez les automatisations Devin. Vous pouvez également démarrer Devin manuellement sur un élément de travail :

• Assignez l’élément de travail au compte de service. Devin démarre une session sur l’élément de travail. Nécessite un compte de service.
• Ajoutez le libellé devin. Lorsque vous ajoutez le libellé à un élément de travail existant, la correspondance ne tient pas compte de la casse et porte sur des mots entiers : Devin, devin-workshop et devin-task déclenchent Devin, contrairement à devinworkshop et devin_workshop. Lorsqu’un élément de travail est créé avec des libellés déjà définis, le déclencheur par libellé ne s’active que pour un libellé strictement identique à devin (sans tenir compte de la casse) ; devin-workshop n’est pas pris en compte.
• @mentionnez le compte de service dans un commentaire. Devin démarre une session sur l’élément de travail et ajoute le texte de votre commentaire à la tâche. Si Devin a déjà une session active pour cet élément de travail, votre commentaire est transmis à cette session au lieu d’en démarrer une nouvelle.

Tant que Devin a une session en cours pour un élément de travail, les nouvelles attributions et les nouveaux libellés sur cet élément sont ignorés, et les @mentions sont transmises à cette session. Ce lien est conservé pendant 30 jours, ou jusqu’à ce qu’une @mention révèle que la session est terminée ou en erreur.

​

Sous quelle identité la session s’exécute

Devin associe l’utilisateur Jira à l’origine du déclenchement à un membre du compte Devin connecté :

1. En priorité, via un compte Atlassian lié. Les membres peuvent lier le leur dans Settings > Connections > Atlassian, ce qui permet à Devin de lire Jira au nom de cette personne.
2. À défaut, via l’adresse e-mail : un utilisateur Jira dont l’adresse e-mail correspond à un seul et unique membre du compte est associé à ce membre, et cette association est mémorisée.

La session s’exécute sous l’identité de l’utilisateur Devin associé : elle apparaît dans sa liste de sessions et est soumise à ses autorisations. Si aucun membre ne correspond, ou si le membre associé n’est pas autorisé à utiliser les sessions Devin dans l’organisation, la session s’exécute alors sous l’identité de l’utilisateur bot Jira partagé de Devin. Si Devin ne parvient pas à déterminer l’organisation à utiliser pour l’élément de travail, il le signale dans un commentaire.

​

Commentaires et liens vers les pull requests

Au démarrage d’une session, Devin publie le commentaire « Devin is working on your request » et ajoute un lien vers la session. Lorsque Devin crée une pull request, son URL est ajoutée comme lien distant à l’élément de travail et publiée en commentaire, accompagnée du lien vers la session Devin.

​

Prérequis

Pour les deux options :

• Jira Cloud. Devin for Jira est une application Forge et la connexion OAuth repose sur Atlassian Cloud OAuth ; les deux nécessitent donc un site Jira Cloud. Pour Jira auto-hébergé, consultez connecter un système de tickets personnalisé via l’API.
• Un administrateur Jira pour installer l’application ou autoriser la connexion OAuth, et un administrateur Devin (une personne pouvant gérer les intégrations du compte Devin) pour associer le site ou configurer la connexion.
• Un seul site Jira par compte Devin. Un site Jira ne peut être associé qu’à un seul compte Devin, et un compte Devin ne peut être associé qu’à un seul site Jira à la fois. Dissociez le site actuel avant d’en associer un autre.
• Des repositories connectés, afin que Devin puisse pousser des branches et ouvrir des pull requests. Devin ne peut ouvrir des pull requests que dans les repositories auxquels il a accès ; connectez d’abord votre fournisseur de code source, par exemple via l’intégration GitHub.

Pour l’agent Rovo :

• L’application Devin for Jira installée depuis l’Atlassian Marketplace, avec les fonctionnalités d’agent de Jira Cloud activées dans l’espace de travail. Consultez l’Option 1.
• Un forfait Devin Core, Team ou Enterprise, avec l’autorisation de gérer les intégrations, ainsi que l’autorisation et un quota d’utilisation suffisant pour démarrer des sessions.
• Chaque personne qui déclenche Devin doit disposer d’un compte utilisateur Devin. Devin fait correspondre l’utilisateur Jira à un membre du compte Devin associé, via son compte Atlassian lié ou son adresse e-mail. En l’absence de correspondance, la personne peut lier son compte dans Settings > Connections > Atlassian. À défaut, un administrateur doit vérifier que la personne appartient bien au compte Devin associé et que son adresse e-mail vérifiée correspond. Les éléments de travail provenant d’utilisateurs Jira sans correspondance sont refusés.
• L’autorisation de démarrer des sessions. L’utilisateur Devin correspondant doit être autorisé à utiliser les sessions Devin dans son organisation. Pour les personnes appartenant à plusieurs organisations, Devin utilise en priorité leur organisation de travail par défaut, à choisir dans Settings > Preferences. Si Devin ne parvient pas à sélectionner une organisation, il demande à la personne d’en définir une par défaut.

Pour l’utilisateur de service :

• Un compte de service Jira disposant des périmètres et de l’accès applicatif décrits dans Ajouter un compte de service, afin que des éléments de travail puissent être assignés à Devin et que ses commentaires soient publiés au nom du bot.
• Un compte administrateur Jira pour autoriser la connexion. Une reconnexion ultérieure actualise l’autorisation sans perdre les credentials du compte de service ni les webhooks.

​

Billing

Les sessions lancées depuis Jira sont des sessions Devin standard. Elles consomment des ACU de l’organisation Devin dans laquelle elles s’exécutent, au même tarif que les sessions lancées depuis la webapp ou toute autre intégration, et sont décomptées des limites d’utilisation de cette organisation. Si l’organisation ne peut plus lancer de nouvelles sessions parce qu’elle a atteint sa limite d’utilisation, Devin refuse l’élément de travail dans Jira : sur sa carte pour l’agent Rovo, ou dans un commentaire pour l’utilisateur de service. L’installation de l’application est gratuite. L’utilisation de Devin est facturée dans le cadre de votre plan Devin, et Devin traite le contenu Jira en dehors d’Atlassian.