Isi-APP Docs fonctionnelles
Toutes les docs
Markdown brut
Assistant IA de clarification de backlog — Documentation Fonctionnelle
Actif ai functional Revu le 2026-08-07 ai/backlog-ai-clarification.md

Assistant IA de clarification de backlog — Documentation Fonctionnelle

Reformule un élément de backlog existant en contexte détaillé et pose les questions nécessaires (accès, droits, forme visuelle, champs...) jusqu'à ce qu'il ne reste plus de zone d'ombre.


À quoi ça sert

De nombreux éléments de backlog CRM v2 ont été générés en masse depuis un cahier des charges via la moulinette IA (voir Génération de backlog par IA). Le résultat est cohérent mais reste souvent trop court pour être développé sans échanges complémentaires : il manque les précisions opérationnelles (par où y accéder, qui a le droit de le voir, à quoi ça doit ressembler, quels champs afficher...).

L'assistant de clarification permet, directement depuis un backlog existant, de faire dialoguer l'IA avec l'utilisateur pour obtenir ces précisions, sans jamais modifier la description initiale.

Comment ça marche (côté utilisateur)

Dans la modal d'édition d'un backlog, un nouvel onglet Assistant IA est disponible à côté de Formulaire / Sous-tâches / Tickets.

  1. Génération initiale : le bouton Générer le contexte IA lance une première analyse. L'IA produit un contexte enrichi (reformulation du besoin) et, si nécessaire, une liste de questions précises (accès, droits, forme visuelle, champs, comportements limites...).

  2. Réponse aux questions : chaque question ouverte a son propre champ de réponse. Aucune réponse n'est obligatoire : laisser un champ vide revient à ignorer la question — elle est alors marquée comme telle et ne sera plus jamais reposée, même dans un round ultérieur. Répondre à certaines questions et en ignorer d'autres dans le même envoi est possible.

  3. Régénération : le bouton Envoyer mes réponses et régénérer transmet les réponses (et les questions ignorées) à l'IA, qui produit une nouvelle version du contexte en tenant compte de tout l'historique, et pose de nouvelles questions si besoin. L'IA sait qu'une question ignorée ne doit pas être reformulée pour être reposée : elle raisonne avec l'information manquante.

  4. Application dans la description : deux boutons, disponibles à tout moment dès qu'un contexte existe (y compris avec des questions encore ouvertes), évitent tout copier-coller :

    • Ajouter à la description — ajoute le contexte à la suite du texte existant ;
    • Remplacer la description — écrase la description par le contexte (confirmation demandée).

    Dans les deux cas la description est enregistrée immédiatement — aucun clic sur Enregistrer n'est nécessaire — et le champ Description de l'onglet Formulaire est mis à jour en même temps.

  5. Fin de clarification : quand l'IA n'a plus de question à poser, un message confirme que le backlog est clarifié. Un bouton Relancer une clarification reste disponible dès qu'aucune question n'est en attente — que le backlog soit marqué clarifié (la description a pu être modifiée entre-temps) ou qu'un appel IA ait échoué en cours de route.

Le badge sur l'onglet indique le nombre de questions actuellement en attente de traitement (ni répondues, ni ignorées).

Règles d'accès

L'onglet est visible pour tout utilisateur ayant accès à la modal d'édition du backlog, à condition que le tenant dispose du module IA (canUseIa() — même règle que les autres assistants IA du projet, ex. l'éditeur enrichi). L'accès est en outre limité aux backlogs de votre propre entité : un backlog appartenant à une autre entité est refusé (403), même en forçant son identifiant.

Points d'attention

  • Le contexte généré est stocké à part (txai_context). L'IA ne modifie jamais la description d'elle-même : seule une action explicite (Ajouter / Remplacer) la change. Le contexte reste consultable dans l'onglet après application.
  • Remplacer la description est irréversible (écriture immédiate, pas d'annulation dans l'écran) — d'où la confirmation. Ajouter à la description est non destructif et n'en demande pas.
  • L'historique complet des questions/réponses de chaque round est conservé (traçabilité), même après que le round soit résolu — y compris les questions ignorées, distinguées des questions répondues.
  • Une question ignorée l'est définitivement : il n'existe pas d'action pour « rouvrir » une question ignorée. Si l'information devient nécessaire, relancer une clarification (bouton Relancer une clarification) produit un nouveau round, mais l'IA a pour consigne de ne pas reposer ce qui a été ignoré.
  • Chaque appel à l'IA est facturé/journalisé comme les autres assistants IA du projet et apparaît dans le dashboard admin IA.

Voir aussi