Créer et gérer des tickets

Ce guide vous montre comment créer et gérer des tickets.

Créer un ticket

Depuis l’interface

Cliquez sur Tickets dans la barre latérale de l’espace de travail.
Appuyez sur Nouveau ticket.
Renseignez :
- Titre — bref résumé. C’est le seul champ obligatoire.
- Description — markdown, avec une barre d’outils de mise en forme.
- Statut — À faire (la valeur par défaut) ou Backlog. Les états démarrés et terminaux s’atteignent par le cycle de vie, pas à la création.
- Priorité — aucune, urgente, élevée, moyenne ou basse.
- Assigné à — vous-même ou tout agent de l’espace de travail.
- Projet — regroupement facultatif.
Appuyez sur Créer, ou activez d’abord En créer d’autres pour garder la boîte de dialogue ouverte et saisir plusieurs tickets rapidement.

La boîte de dialogue ne comporte aucun sélecteur de fournisseur. Le ticket est créé auprès du fournisseur de tickets actif de l’espace de travail.

Depuis un agent

Demandez à un agent dans un espace :

Créez un ticket pour corriger le problème d’expiration de connexion sur les connexions lentes.

Il appelle l’outil MCP create_ticket. La priorité de cet outil est un entier, pas un nom :

create_ticket(
  workspace_id: "...",
  title: "Fix login timeout on slow connections",
  description: "...",
  priority: 2
)

Valeur	Priorité
`0`	Aucune
`1`	Urgent
`2`	Élevée
`3`	Moyenne
`4`	Basse

Seuls workspace_id et title sont obligatoires ; description, priority, assignee (un identifiant d’agent) et team_id sont facultatifs. L’outil est classé comme écriture de synchronisation fournisseur et demande votre approbation avant de s’exécuter.

Modifier le statut d’un ticket

Les tickets suivent ce cycle de vie :

backlog → open → inProgress ⇄ blocked
                    ↓   ↑
                 inReview
                    ↓
              done / failed   (terminal)

done, failed et cancelled sont terminaux. cancelled est atteignable depuis n’importe quel statut non terminal. done et failed sont atteignables depuis inProgress ou inReview ; open peut aussi passer directement à blocked. Le sélecteur de statut de l’interface liste tous les statuts sauf failed — les agents le définissent avec fail_ticket.

Pour le changer, utilisez l’un des moyens suivants :

la ligne Statut dans le panneau des propriétés du ticket,
le sous-menu Statut du menu contextuel d’un ticket dans la liste,
la puce Statut de la barre flottante après avoir sélectionné plusieurs tickets.

Les changements de statut émettent des événements de domaine (TicketStatusChanged, TicketCompleted et d’autres) qui peuvent déclencher des pipelines. Voir Configurer des déclencheurs de pipeline.

Attribuer un ticket

Ouvrez le ticket.
Dans le panneau des propriétés, définissez Assigné à — vous-même, un autre membre de l’espace de travail ou un agent.

Ajouter des étiquettes

Les étiquettes s’appliquent en bloc depuis la liste des tickets, et non depuis un ticket isolé — le panneau des propriétés n’a aucune commande d’étiquette.

Survolez une ligne de la liste des tickets et cochez sa case. Cochez-en autant que nécessaire ; une barre flottante apparaît dès qu’un élément est sélectionné.
Dans cette barre, ouvrez la puce Étiquettes.
Choisissez une étiquette. Elle est ajoutée à chaque ticket sélectionné qui ne la possède pas ; les étiquettes existantes ne sont jamais supprimées. Effacer les étiquettes les retire toutes. Le sélecteur liste les étiquettes déjà présentes sur un ticket de l’espace de travail. Les agents peuvent ajouter un nouveau nom via update_ticket ou tickets.patch.

Lier des tickets

Les relations se trouvent sur la carte Relations du ticket, dans le panneau des propriétés, ou derrière Lier à dans le menu contextuel de la liste.

Ouvrez le ticket et repérez la carte Relations.
Appuyez sur sa commande d’ajout et choisissez la relation :

Relation	Signification
Sous-tâche de…	Le ticket parent est l’autre
Parent de…	L’autre ticket est un enfant de celui-ci
Bloqué par…	Ce ticket est bloqué par l’autre
Bloque…	Ce ticket bloque l’autre
Lié à…	Symétrique, sans direction implicite
Doublon de…	Ce ticket est un doublon de l’autre

Choisissez le ticket cible.

Dupliqué par apparaît dans la carte mais pas dans le sélecteur — c’est l’inverse de Doublon de et il est défini depuis l’autre ticket. Chaque relation listée est cliquable pour ouvrir le ticket lié et supprimable au survol.

Les relations parent et sous-tâche sont stockées sur le ticket lui-même plutôt que sous forme de lignes de lien ; supprimer un parent se répercute donc en cascade sur ses enfants (voir ci-dessous), contrairement aux liens de blocage et de liaison.

Ajouter des collaborateurs

Les collaborateurs forment une liste rattachée au ticket : qui est impliqué, à quel titre.

Ouvrez le ticket.
Appuyez sur la commande « personne + » de la carte Ajouter un collaborateur.
Choisissez un agent.

Les trois rôles sont assignee, collaborator (celui par défaut) et reviewer. Le sélecteur de l’interface ne liste que les agents de l’espace de travail et écrit toujours le rôle par défaut ; des humains peuvent apparaître sous forme de lignes, mais ne sont pas proposés dans ce menu. L’outil MCP add_ticket_collaborator accepte un role.

Ajouter un collaborateur écrit une ligne et ne publie aucun événement de domaine ; cela n’accorde aucun accès à l’espace. Pour placer un agent dans une conversation, ajoutez-le plutôt comme participant depuis l’en-tête de l’espace — voir Utiliser les espaces.

Supprimer un ticket

Utilisez Supprimer le ticket en bas du panneau des propriétés, le menu contextuel, ou l’action de suppression de la barre flottante après une sélection multiple.