MedGuru Docsv0.17.0 Voir le changelog
Skip to content

Trier les détections IA ambiguës

Ce manuel s'adresse aux comptes ROLE_GOVERNANCE et ROLE_SUPER_ADMIN qui traitent la queue de triage des publicités dont l'IA n'a pas classé le format avec certitude. Chaque décision humaine nourrit la boucle d'apprentissage PIGES.

Pourquoi cette feature

L'IA Claude Vision détecte chaque pub et propose un format_code accompagné d'un score de confiance. Le pipeline d'ingestion route ensuite la pub selon trois seuils :

Score de confianceDrapeauTraitement
≥ 0.85aucunAssignation automatique, validation éditoriale classique
0.60 – 0.85format_needs_reviewDropdown pré-rempli dans F06 Verify, shortcut de validation
< 0.60 ou UNKNOWNformat_unknownAd visible uniquement dans la queue Triage

La queue Triage centralise toutes les pubs à ré-examiner. Chaque réaffectation manuelle publie un événement vers PIGES qui enrichit ses embeddings CLIP, rendant l'IA progressivement meilleure sur les formats problématiques.

À savoir

La permission requise est catalog.unknown.triage, accordée par défaut à ROLE_GOVERNANCE et ROLE_SUPER_ADMIN. Un compte EDITOR ne voit pas la queue Triage ; il corrige les formats individuellement dans F06 Verify.

Workflow détaillé

1. Accéder à la queue

Depuis le menu latéral Gouvernance, cliquez sur l'onglet Triage. L'URL directe est /governance#triage.

Onglet Triage dans la Gouvernance

2. Filtrer la queue

Deux filtres principaux :

  • Magazine : dropdown listant les magazines actifs. Travailler magazine par magazine permet de rester dans un catalogue cohérent et d'accélérer les décisions.
  • Flag : unknown (confidence < 0.60) ou review (0.60 à 0.85). Commencez par unknown qui bloque le reporting, puis enchaînez sur review qui consolide la précision.
Filtres magazine et flag

3. Examiner une ad

Chaque carte affiche :

  • Aperçu bbox : crop de la publicité détectée sur la page PDF.
  • Numéro de page et lien vers l'import d'origine (/verify/{importId}).
  • Format legacy détecté par l'IA (si UNKNOWN, le texte est grisé).
  • Badge de confiance coloré : rouge < 0.60, orange 0.60–0.85.
Carte ad avec bbox et badge confiance

4. Réaffecter le format

Cliquez sur Réaffecter. Le dropdown charge uniquement les AdFormat au statut active du magazine de l'import, enrichi du libellé canonique entre parenthèses (ex. Pleine page quadri (FULL_PAGE_QUADRI)). Sélectionnez le format correct et validez.

Dropdown de réaffectation

Le backend refuse (422) tout AdFormat d'un autre magazine ou non-active. Un événement catalog.triage.reassigned est écrit dans l'audit log et un événement ad-reassigned est publié vers PIGES en fire-and-forget.

5. Effet dans PIGES

PIGES reçoit la bbox, la télécharge, génère un embedding CLIP et l'ajoute à la collection ChromaDB avec le libellé canonique correct. Au prochain batch d'ingestion sur un magazine similaire, Claude disposera de ce nouvel exemple via le contexte RAG et la précision remontera.

Flux PIGES après reassign

Le Dashboard apprentissage IA permet de mesurer cet effet dans le temps.

Cas limites

Ad sur double page

Quand une publicité chevauche deux pages (spread), la bbox peut être scindée en deux détections. Choisissez le format SPREAD sur la première détection et Ignorer la seconde via le menu contextuel : l'ad fantôme est soft-deleted et n'est plus proposée.

Magazine mal attribué par le pipeline

Si l'import a été rattaché au mauvais magazine (ex. erreur manuelle à l'upload), le dropdown de réaffectation affichera le mauvais catalogue. Corrigez d'abord le magazine de l'import dans Catalogue > Imports, puis revenez dans Triage : la queue se rafraîchit automatiquement.

Aucun format ne colle

Si le catalogue de la régie ne contient aucun format adapté, cliquez sur Créer ce format. Un formulaire pré-rempli s'ouvre (surface, position, dimensions déduites de la bbox). Après création et activation par la gouvernance, revenez sur l'ad dans Triage pour la réaffecter.

Format archivé

Un AdFormat au statut archived n'apparaît plus dans le dropdown. Si vous voulez rattacher une ad historique à ce format, repassez-le temporairement en active dans Catalogue > Formats publicitaires, réaffectez, puis re-archivez.

Confidence anormalement basse sur un magazine entier

Si la majorité des ads d'un magazine tombe en format_unknown, cela indique un catalogue vide ou incomplet. Utilisez le manuel Uploader une grille tarifaire pour seed le catalogue en une passe, puis rejouez l'ingestion (bouton Relancer la détection sur l'import).

FAQ

Puis-je réouvrir un triage terminé ?

Oui. Dans F06 Verify, le dropdown de format reste modifiable tant que l'ad est au statut pending. Au-delà (statut approved), seul un ROLE_GOVERNANCE peut rouvrir via le menu contextuel Déverrouiller le format.

Que se passe-t-il si je me trompe de format ?

La réaffectation est idempotente : ré-ouvrez le dropdown et choisissez le bon format. PIGES reçoit un nouvel événement qui écrase l'embedding précédent pour cette ad.

Combien de corrections faut-il avant que l'IA apprenne ?

L'effet devient mesurable après environ 20 à 40 reclassifs sur un même format canonique. Surveillez la métrique Taux unknown dans le Dashboard apprentissage IA pour confirmer.

Les corrections dans F06 Verify remontent-elles aussi vers PIGES ?

Oui. Toute réassignation de format sur une pub, qu'elle vienne de la queue Triage ou de F06 Verify, publie le même événement PIGES.

Puis-je traiter plusieurs ads en bulk ?

Pas en v1. La décision se prend ad par ad pour garantir la qualité du dataset d'apprentissage. Un mode bulk est envisagé pour v2 sur les cas triviaux (ex. tout un magazine qui passe de UNKNOWN à un canonique unique).

Que devient une ad ignorée ?

L'action Ignorer (soft-delete) marque l'ad comme excluded et la retire définitivement de la queue et des reportings. Utilisez-la pour les faux positifs manifestes (bandeau éditorial détecté comme pub).

Liens utiles

Version v0.17.0 — Changelog