> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Jira

> Attribuez des tickets Jira à Devin et transformez-les en PR

<div id="setting-up-the-integration">
  ## Configurer l’intégration
</div>

1. Dans votre compte Devin sur app.devin.ai, accédez à [Settings > Connections > Jira](https://app.devin.ai/settings/connections/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.

<Tip>
  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](#connecting-a-service-account) ci-dessous.
</Tip>

<div id="how-to-trigger-devin-from-jira">
  ## Comment lancer Devin depuis Jira
</div>

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

<div id="assign-the-ticket-to-devin">
  ### Affecter le ticket à Devin
</div>

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](https://app.devin.ai/settings/connections/jira) pour commencer à travailler sur le ticket.

<div id="add-a-playbook-label">
  ### Ajouter un libellé de playbook
</div>

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.

<div id="add-the-devin-label">
  ### Ajoutez le libellé "devin"
</div>

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.

<Note>
  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.
</Note>

<div id="mention-devin-in-a-comment">
  ### Mentionner `@Devin` dans un commentaire
</div>

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.

<div id="configuring-the-integration">
  ## Configuration de l’intégration
</div>

<div id="session-mode">
  ### Mode de session
</div>

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.

<div id="playbook-labels">
  ### Libellés de playbook
</div>

Les libellés de playbook vous permettent de contrôler quels [playbooks](/fr/product-guides/using-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.

<div id="automation-triggers">
  ### Déclencheurs d’automatisation
</div>

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.

<div id="enterprise-jira-project-mapping">
  ### Enterprise : association des projets Jira
</div>

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.

<div id="interacting-with-devin-in-jira">
  ## Interagir avec Devin dans Jira
</div>

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.

<div id="connecting-a-service-account">
  ## Connecter un compte de service
</div>

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. Assurez-vous que le compte de service dispose du rôle d’application **User** pour Jira. Dans [Atlassian Admin](https://admin.atlassian.com), accédez à **Directory > Service accounts**, sélectionnez le compte de service, cliquez sur **⋯ > Allow access**, puis définissez le rôle Jira sur **User**. Vous pouvez également le définir lors de la création du compte de service. Sans ce rôle, le compte de service ne pourra pas accéder aux ressources Jira.
3. Dans [Settings > Connections > Jira](https://app.devin.ai/settings/connections/jira), cliquez sur **Connect service account**, puis saisissez l’ID client et le secret client.