Passer au contenu principal

​
Configurer l’intégration

  1. Dans votre compte Devin sur app.devin.ai, accédez à Settings > Integrations > Jira, puis cliquez sur « Connect ».
  2. Vous serez redirigé vers Jira pour vérifier les autorisations et accorder l’accès à Devin.
  3. Une fois la connexion établie, configurez vos libellés de playbook et, si vous le souhaitez, définissez des déclencheurs d’automatisation dans la page Settings.
Une fois la connexion établie, nous vous recommandons de connecter un compte de service afin que les commentaires de Devin apparaissent au nom du bot, et non de votre compte personnel. Consultez Connecter un compte de service ci-dessous.

​
Comment lancer Devin depuis Jira

Il existe quatre façons de démarrer une session Devin à partir d’un ticket Jira :

​
Affecter le ticket à Devin

Affectez directement le ticket au compte de service Devin dans Jira. Devin utilisera le playbook par défaut configuré dans les paramètres de l’intégration Jira pour commencer à travailler sur le ticket.

​
Ajouter un libellé de playbook

Ajoutez un libellé de playbook (p. ex. !plan, !implement, !triage) au ticket. Devin démarrera une session avec le playbook spécifique correspondant à ce libellé. Ces libellés correspondent aux libellés de playbook configurés dans les paramètres de votre intégration. Vous devez créer manuellement ces libellés dans votre projet Jira — copiez le nom du libellé depuis les paramètres de l’intégration.

​
Ajoutez le libellé “devin”

Ajoutez le libellé devin à n’importe quel problème Jira (vous devrez peut-être d’abord créer ce libellé dans votre projet Jira). Devin utilisera le playbook par défaut pour commencer à travailler sur le ticket.
L’intégration utilise une correspondance sur les limites des mots (insensible à la casse). Ainsi, tout libellé contenant devin comme mot autonome la déclenchera — par exemple, devin, Devin, devin-workshop ou devin-task. En revanche, les libellés dans lesquels « devin » fait partie d’un mot plus long, comme devinworkshop ou devin_workshop, ne la déclencheront pas.

​
Mentionner @Devin dans un commentaire

Mentionnez @Devin dans un commentaire sur un ticket avec des instructions spécifiques. Devin démarrera une session et utilisera votre commentaire comme instruction pour la tâche, sans appliquer de playbook. Si une session existe déjà pour le ticket, votre message sera transmis à la session existante.

​
Configuration de l’intégration

​
Mode de session

Le commutateur du mode de session détermine comment Devin répond aux déclencheurs Jira :
  • Création directe de session (activée par défaut) : Devin crée une session complète et traite le problème, puis publie des mises à jour dans Jira.
  • Cadrage uniquement (désactivé) : Devin analyse uniquement le ticket et publie un commentaire de cadrage avec un résumé, un plan de mise en œuvre et une estimation du niveau de confiance. Vous pouvez ensuite cliquer sur le lien fourni pour démarrer une session manuellement.

​
Libellés de playbook

Les libellés de playbook vous permettent de contrôler quels playbooks Devin sont disponibles comme libellés Jira. Lorsque vous ajoutez un playbook, sa macro (p. ex. !plan) devient un libellé que vous pouvez attribuer à des problèmes Jira pour déclencher Devin avec ce playbook. Les libellés doivent être créés manuellement dans votre projet Jira — copiez le nom du libellé depuis les paramètres de l’intégration.
  • Playbook par défaut: Un playbook est défini comme playbook par défaut. Lorsqu’un ticket est déclenché sans libellé de playbook spécifique (p. ex. avec seulement le libellé devin ou en attribuant le ticket à Devin), Devin utilise ce playbook par défaut.
  • Ajout de playbooks: Cliquez sur “Add playbook” pour ajouter d’autres playbooks. Seuls les playbooks dotés d’une macro peuvent être ajoutés.
  • Suppression de playbooks: Supprimez un playbook pour que son libellé ne soit plus utilisé comme déclencheur.

​
Déclencheurs d’automatisation

Les déclencheurs d’automatisation permettent à Devin de commencer automatiquement à traiter des tickets lorsqu’ils remplissent certaines conditions, sans attribution manuelle ni ajout de libellés. Vous pouvez configurer des déclencheurs selon les critères suivants :
  • Projects : Activer uniquement pour les tickets des projets Jira spécifiques.
  • Labels : Activer uniquement lorsqu’un ticket possède des libellés spécifiques.
  • Statuses : Activer uniquement lorsqu’un ticket atteint un statut spécifique (p. ex. “To Do”, “In Progress”).
  • Playbook : Vous pouvez éventuellement préciser quel playbook Devin doit utiliser pour la session ainsi déclenchée.
Les déclencheurs utilisent la détection de transition : ils ne s’activent que lorsqu’un ticket passe d’un état ne correspondant pas aux conditions du déclencheur à un état qui y correspond (p. ex. lorsqu’un libellé est ajouté ou qu’un statut change), et non pour les tickets qui correspondent déjà à ces conditions.

​
Enterprise : association des projets Jira

Pour les déploiements Enterprise avec plusieurs organisations Devin, les administrateurs peuvent associer des projets Jira à des organisations Devin spécifiques. Cela garantit que les tickets de chaque projet Jira sont acheminés vers la bonne organisation Devin. Une association est requise pour que l’intégration Jira fonctionne dans une configuration Enterprise.

​
Interagir avec Devin dans Jira

Dès que Devin commence à travailler sur un ticket, il communique dans Jira :
  • Liens vers les PR : Lorsque Devin crée une pull request (PR), l’URL de la PR est automatiquement ajoutée en tant que lien distant sur le problème Jira et également publiée dans un commentaire.
  • Lien de session : Un lien direct vers la session Devin dans l’application web est fourni pour vous permettre de suivre l’avancement en temps réel.
  • Messages de suivi : Mentionnez @Devin dans un commentaire pour donner à Devin des instructions supplémentaires ou lui poser des questions.

​
Connecter un compte de service

Après avoir connecté Jira avec votre compte administrateur, vous pouvez, si vous le souhaitez, connecter un compte de service à l’aide des identifiants client OAuth 2.0. Les commentaires de Devin apparaîtront alors sous une identité de bot dédiée plutôt que sous votre compte personnel.
  1. Dans les paramètres d’administration de votre organisation Atlassian, créez un compte de service OAuth 2.0 avec les Classic scopes suivants :
    • read:me
    • read:jira-user
    • read:jira-work
    • write:jira-work
  2. Dans Settings > Integrations > Jira, cliquez sur Connect service account, puis saisissez l’ID client et le secret client.