Linear et Jira
Transformez un problème en un ticket dans Linear ou Jira Cloud, et gardez les deux synchronisés jusqu'à la correction du bug.
Quand des exécutions trouvent un défaut dans votre produit, Autonomy le conserve comme problème dans le projet, et rattache au même problème chaque exécution qui le revoit. Linear et Jira Cloud transforment ce problème en un ticket dans votre outil de suivi, et maintiennent les deux en phase pendant toute la vie du bug.
Ce que vous obtenez
| Événement | Ce qui se passe |
|---|---|
| Vous cliquez sur Create in Linear ou Create in Jira sur un problème (ou la création automatique est activée) | Un ticket est créé avec le titre du problème, ses détails, le résultat attendu et le résultat obtenu, l'environnement, et des liens vers le problème et vers chaque exécution qui l'a montré. |
| Une exécution ultérieure revoit le même problème | Un commentaire sur le ticket : « Seen again. Seen in N runs now. » Jamais un deuxième ticket. |
| Une exécution revoit le problème après sa résolution | Le problème est rouvert, et le ticket reçoit « Seen again after being resolved. Seen in N runs now. » |
| Vous fermez ou annulez le ticket | Le problème passe à Resolved. |
| Vous rouvrez le ticket | Le problème repasse à Open. |
| Vous supprimez le ticket | Le problème est détaché, garde son statut et peut être de nouveau transformé en ticket. |
Seul le statut revient dans Autonomy. La personne assignée, la priorité, les labels et le titre restent dans l'outil de suivi. Les problèmes Ignored ne sont jamais modifiés par l'outil de suivi, et un ticket ne modifie jamais une exécution ni son résultat.
Un ticket montre ce que montre la page du problème. Il ne contient jamais de prompts, de détails sur le modèle d'IA, de coûts, d'arborescences de page brutes ni d'identifiants.
Connecter un outil de suivi
Chaque outil de suivi est connecté une seule fois pour l'organisation. Réservé aux propriétaires et aux administrateurs.
Linear
- Ouvrez Organization → Integrations → Linear et connectez-vous à Linear. Les tickets et les commentaires sont publiés par l'application Autonomy, et non par la personne qui l'a connectée.
- Choisissez les équipes à partager, puis choisissez l'équipe de chaque projet.
La synchronisation du statut depuis Linear fonctionne d'elle-même. Il n'y a rien à ajouter dans Linear.
Jira Cloud
- Ouvrez Organization → Integrations → Jira et connectez-vous à Jira. Choisissez le site.
- Choisissez les projets Jira à partager, puis choisissez le projet Jira de chaque projet. Les tickets utilisent le type de ticket Bug du projet Jira, ou son premier type de ticket s'il n'a pas de type Bug.
- Configurez la synchronisation du statut. Dans la ligne Status sync, « Add a webhook in Jira so ticket status changes come back to issues. », cliquez sur Show setup. Une URL et un secret s'affichent, et Open Jira ouvre la page des webhooks de votre site.
- Dans Jira, créez un webhook avec cette URL et ce secret, cochez Issue: updated et Issue: deleted, puis enregistrez. Cette étape nécessite un administrateur Jira.
Sans l'étape 4, la création de tickets et de commentaires fonctionne toujours ; seuls les changements de statut effectués dans Jira ne reviennent pas. Reconnecter Jira conserve le même secret : le webhook continue donc de fonctionner.
Choisir où vont les tickets
Les tickets vont vers la destination du projet du problème :
- Linear : une équipe.
- Jira : un projet Jira.
Choisissez-la à l'un de ces deux endroits :
- Organization → Integrations → Linear ou Jira : un tableau de tous les projets avec leur équipe ou leur projet Jira. Choisissez Not used pour un projet qui ne doit pas y créer de tickets.
- Settings → Integrations du projet : les lignes Linear et Jira.
Choisir une destination nécessite un propriétaire ou un administrateur. Si un environnement avait sa propre équipe ou son propre projet Jira avant l'arrivée des projets, il les conserve : les tickets issus des problèmes de cet environnement y vont toujours.
Créer un ticket à partir d'un problème
- Ouvrez le problème sur la page Issues du projet.
- Sous Linked tickets, cliquez sur Create in Linear · TEAM ou Create in Jira · KEY.
Le ticket apparaît sous Linked tickets avec son statut. Si le projet n'a pas encore de destination, la ligne l'indique et les administrateurs obtiennent un lien pour en choisir une dans les paramètres du projet.
Vous pouvez aussi coller le lien d'un ticket existant avec Link a ticket. Un lien collé sert uniquement de référence : il masque le bouton Create de cet outil de suivi, et son statut n'est pas synchronisé.
Créer des tickets automatiquement
Par défaut, aucun ticket n'est créé tant que personne ne clique sur Create. Pour créer des tickets sans intervention :
- Ouvrez Settings → Integrations du projet.
- Activez File tickets for new bugs automatically, sous la ligne Jira.
« When a run finds a new bug, a ticket is created in the team or project above. Off by default: otherwise someone creates it from the issue. » L'option nécessite d'abord une équipe Linear ou un projet Jira (« Choose a Linear team or Jira project above first. »), et seuls les propriétaires et les administrateurs peuvent la modifier.
Une fois l'option activée, chaque nouveau Bug trouvé par une exécution devient un ticket dans chaque outil de suivi connecté pour lequel le projet a une destination. Les risques ne sont jamais transformés automatiquement en tickets. Une exécution qui revoit un bug existant se contente toujours d'ajouter un commentaire. Si vous désactivez l'option, les exécutions continuent de trouver des problèmes ; ils ne sont simplement plus transformés en tickets.
Si seuls certains environnements créent des tickets automatiquement, par exemple à cause d'une ancienne configuration, la ligne indique « On for Production and Staging only. Switch it off and on again to use it in every environment. »
Dépannage
L'outil de suivi affiche de nouveau Connect
L'outil de suivi a révoqué l'accès d'Autonomy ou celui-ci a expiré, par exemple parce que la personne qui l'avait connecté est partie ou que l'application a été désinstallée. Un administrateur le connecte de nouveau ; les liens vers les tickets existants continuent de fonctionner.
La connexion à l'outil de suivi échoue
« Couldn't connect Linear: access wasn't allowed. » signifie que l'autorisation a été refusée : réessayez et choisissez Allow. Sinon, réessayez ou demandez de l'aide à un administrateur de votre espace Linear ou Jira.
Aucun bouton Create sur un problème
Le projet n'a pas d'équipe ou de projet Jira pour cet outil de suivi, ou le problème y a déjà un ticket, créé ou collé. Choisissez une destination, ou retirez le lien collé.
Fermer le ticket Jira ne résout pas le problème
Vérifiez le webhook dans Jira : il doit utiliser exactement l'URL et le secret indiqués dans Status sync, avec Issue: updated coché.
Le problème est resté ignoré après la réouverture du ticket
C'est voulu. Un problème Ignored est connu et accepté, et l'outil de suivi ne le modifie jamais.
Vous n’avez pas trouvé ?