Imposer une liste à masquer et une liste à laisser en clair

En bref

• Deux listes, écrites dans la section [override] de la configuration, corrigent le détecteur. La liste à masquer (deny_list dans la configuration) masque une valeur même si le détecteur la rate. La liste à laisser en clair (allow_list) garde une valeur en clair même si le détecteur la trouve. Une valeur que l'assistant cite le premier fait exception, et reste en clair par défaut.
• La configuration est celle du pipeline, qu'il tourne dans l'application ou dans le serveur piighost-api.
• Ces listes passent avant tout le reste, y compris avant une correction faite à la main par une personne.
• Une valeur de la liste à laisser en clair part au modèle en clair, et le contrôle final ne la bloque pas.
• Quand les deux listes visent la même valeur, la liste à masquer gagne par défaut, donc la valeur est masquée.
• Une liste modifiée ne s'applique qu'aux messages nouveaux d'une conversation déjà commencée.

Besoins couverts, décrits dans Besoins par profil :

• Responsable conformité : DPO-3 DPO-3 Besoins par profil En tant que DPO, je veux forcer la protection d'une valeur, ou laisser en clair un terme public, sans attendre le détecteur, afin d'imposer la politique de l'entreprise.
• Utilisateur de l'application : USER-5 USER-5 Besoins par profil En tant qu'utilisateur, je veux que les termes publics restent lisibles, afin que la réponse garde son sens., USER-6 USER-6 Besoins par profil En tant qu'utilisateur, je veux corriger une détection, ajouter un nom oublié ou rendre lisible un terme masqué à tort, afin que l'assistant reçoive le bon texte.

Les termes sont définis dans le glossaire. Le déroulé complet d'un message est dans Protéger un message avant l'envoi au modèle.

Pour le métier

piighost n'a pas d'écran. La liste à masquer et la liste à laisser en clair sont écrites par l'équipe technique, dans le code ou dans la section [override] du fichier de configuration de l'application ou du serveur piighost-api. Le DPO décide de leur contenu. Les tâches ci-dessous disent quoi demander.

Le trajet d'un message à travers les listes

Exemple suivi d'un bout à l'autre

La liste à masquer contient la forme « PRJ- suivi de quatre chiffres », avec le type CODE. La liste à laisser en clair contient « Acme », le nom de l'entreprise. Le détecteur lit « Acme » comme une personne et ne connaît pas les numéros de dossier.

Garder une valeur en clair

Cas typique : le nom de votre entreprise est lu comme un nom de personne, et le modèle en a besoin pour répondre.

1. Listez les valeurs exactes à garder en clair, avec leur orthographe.
2. Précisez si la valeur doit rester en clair quelle que soit la façon dont le détecteur la classe. C'est le réglage par défaut.
3. Si une valeur plus longue la contient (« Acme Services » pour « Acme »), dites si la valeur longue doit aussi rester en clair.
4. Transmettez la liste à l'équipe technique.

Comment vérifier : faites protéger une phrase de test. Par exemple, « Claire Dubois travaille chez Acme. » doit donner « <<PERSON:1>> travaille chez Acme. »

Forcer le masquage d'une valeur

Cas typique : vos noms de code internes ne sont jamais repérés.

1. Décrivez la forme exacte des valeurs, par exemple « PRJ- suivi de quatre chiffres ».
2. Précisez si une valeur citée d'abord par l'assistant doit aussi être masquée. Par défaut, non (BR-LIST-05 BR-LIST-05 Imposer une liste à masquer et une liste à laisser en clair Quand l'assistant cite le premier une valeur de la liste à masquer, alors elle reste en clair par défaut.).
3. Transmettez la description à l'équipe technique.

Comment vérifier : faites protéger une phrase qui contient un nom de code. Il doit être remplacé par un jeton comme <<CODE:1>>.

Règles à connaître

BR-LIST-01 BR-LIST-01 Imposer une liste à masquer et une liste à laisser en clair Quand une valeur figure dans la liste à laisser en clair, alors elle est retirée des valeurs à masquer et part au modèle en clair.. Quand une valeur figure dans la liste à laisser en clair, alors elle est retirée des valeurs à masquer et part au modèle en clair. 4 emplacements · 26 tests indirects

BR-LIST-02 BR-LIST-02 Imposer une liste à masquer et une liste à laisser en clair Quand une valeur figure dans la liste à masquer, alors elle est masquée, même si le détecteur l'a ratée.. Quand une valeur figure dans la liste à masquer, alors elle est masquée, même si le détecteur l'a ratée. Si le détecteur avait repéré un morceau qui la chevauche, la détection de la liste à masquer remplace ce morceau. 1 emplacement · 26 tests indirects

BR-LIST-03 BR-LIST-03 Imposer une liste à masquer et une liste à laisser en clair Quand la liste à laisser en clair vise une valeur, alors la façon de l'appliquer suit l'un de trois réglages.. Quand la liste à laisser en clair vise une valeur, alors la façon de l'appliquer suit l'un de trois réglages. Exemple sur « Claire Dubois travaille chez Acme, puis chez Globex SA. », avec un détecteur qui lit « Acme » comme une personne et « Globex SA » comme une organisation, et une liste à laisser en clair qui contient « Acme » et « Globex » comme organisations. 4 emplacements · 26 tests indirects

Le tableau suivant donne le résultat de chaque réglage :

« Même valeur » est le défaut parce que la liste à laisser en clair nomme une valeur, et le type écrit à côté n'est qu'une supposition sur ce que dira le détecteur.

BR-LIST-04 BR-LIST-04 Imposer une liste à masquer et une liste à laisser en clair Quand les deux listes visent le même passage, alors le réglage de conflit décide.. Quand les deux listes visent le même passage, alors le réglage de conflit décide. 2 emplacements · 14 tests directs · 12 indirects

Le tableau suivant donne le résultat de chaque réglage :

Ce défaut vient d'un principe simple. En cas de doute, masquer protège.

BR-LIST-05 BR-LIST-05 Imposer une liste à masquer et une liste à laisser en clair Quand l'assistant cite le premier une valeur de la liste à masquer, alors elle reste en clair par défaut.. Quand l'assistant cite le premier une valeur de la liste à masquer, alors elle reste en clair par défaut. Un réglage « forcer » la masque quand même. La raison est que masquer une valeur que le modèle a lui-même apportée lui retire une connaissance utile. Le masquage lui signale aussi que cette valeur précise est sensible. 2 emplacements · 3 tests directs · 128 indirects

BR-LIST-06 BR-LIST-06 Imposer une liste à masquer et une liste à laisser en clair Quand une personne corrige à la main les valeurs d'un message, alors les deux listes s'appliquent encore à sa correction et l'emportent sur elle.. Quand une personne corrige à la main les valeurs d'un message, alors les deux listes s'appliquent encore à sa correction et l'emportent sur elle. Par exemple, l'utilisateur retire « PRJ-0042 » des valeurs masquées de son message, mais le numéro reste masqué. 1 emplacement · 2 tests directs · 103 indirects

BR-LIST-07 BR-LIST-07 Imposer une liste à masquer et une liste à laisser en clair Quand le contrôle final relit le texte protégé, alors il ignore les valeurs de la liste à laisser en clair.. Quand le contrôle final relit le texte protégé, alors il ignore les valeurs de la liste à laisser en clair. Toute autre valeur restée en clair bloque l'envoi. 3 emplacements · 17 tests directs · 105 indirects

BR-LIST-08 BR-LIST-08 Imposer une liste à masquer et une liste à laisser en clair Quand une liste change pendant une conversation, alors un message déjà analysé garde son ancien résultat, même renvoyé à l'identique.. Quand une liste change pendant une conversation, alors un message déjà analysé garde son ancien résultat, même renvoyé à l'identique. Par exemple, le 2 octobre 2026, « Acme » entre dans la liste à masquer. Le message envoyé le 1er octobre 2026 dans la même conversation reste avec « Acme » en clair. Seuls les nouveaux messages appliquent la liste. 1 emplacement · 105 tests indirects

Ce que voit l'utilisateur final

Rien de différent. La réponse restaurée contient les vraies valeurs. Seul le modèle voit la différence entre une valeur masquée et une valeur gardée en clair.

Questions fréquentes

Le nom de l'entreprise est encore masqué alors qu'il est dans la liste à laisser en clair. Trois causes possibles. La valeur figure aussi dans la liste à masquer (BR-LIST-04 BR-LIST-04 Imposer une liste à masquer et une liste à laisser en clair Quand les deux listes visent le même passage, alors le réglage de conflit décide.). Ou le texte détecté est plus long que la valeur listée, avec le réglage « Même valeur » (BR-LIST-03 BR-LIST-03 Imposer une liste à masquer et une liste à laisser en clair Quand la liste à laisser en clair vise une valeur, alors la façon de l'appliquer suit l'un de trois réglages.). Ou le message avait été analysé avant l'ajout à la liste (BR-LIST-08 BR-LIST-08 Imposer une liste à masquer et une liste à laisser en clair Quand une liste change pendant une conversation, alors un message déjà analysé garde son ancien résultat, même renvoyé à l'identique.).

Un nom de code de la liste à masquer reste en clair. L'assistant l'a probablement cité le premier dans la conversation (BR-LIST-05 BR-LIST-05 Imposer une liste à masquer et une liste à laisser en clair Quand l'assistant cite le premier une valeur de la liste à masquer, alors elle reste en clair par défaut.). Demandez le réglage « forcer » si la valeur doit toujours être masquée.

Le traitement s'arrête avec Overrides contradict each other on …. Le réglage de conflit est « Refuser » et une valeur figure dans les deux listes. Retirez-la de l'une des deux.

Pour les développeurs

Le guide technique montre les deux listes à l'œuvre dans Comment forcer une détection ou laisser une valeur en clair.

Où vivent les règles

Composants liés : AnyDetectionOverride (port, sans gabarit), DetectionOverride (implémentation pilotée par deux détecteurs), AllowListStrategy, DenyListStrategy, OverrideConflictStrategy, ConflictingOverrideError.

Position dans le pipeline : juste après la détection, avant les chevauchements et l'expansion (pipeline/base.py:385-392). Dans le pipeline de conversation, avant chaque écriture en mémoire (pipeline/thread.py:271-281).

Configurer les listes

1. Partez de la section [override] documentée dans docs/en/configuration/toml.md.
2. Écrivez chaque liste comme un détecteur complet, souvent type = "exact" ou type = "regex" :

[override]
allow_list_strategy = "value"
conflict_strategy = "deny_list_wins"

[override.deny_list]
type = "regex"
patterns = { CODE = 'PRJ-[0-9]{4}' }

[override.allow_list]
type = "exact"
values = { Acme = "ORG" }

3. Pour masquer aussi les valeurs citées d'abord par l'assistant, ajoutez deny_list_strategy = "force".
4. Ne reprenez pas telle quelle une configuration 1.x. Ses clés whitelist et blacklist sont refusées au chargement, avec le nom qui les remplace (DEC-09 DEC-09 Décisions de conception Laisser corriger la détection).

Vérifier

uv run pytest tests/components/override tests/config/test_guard_override_models.py

Puis lancez piighost anonymize --config <votre fichier> "Claire Dubois travaille chez Acme sur PRJ-0042.". Vous devez voir « Acme » en clair et <<CODE:1>> à la place du code.

Pièges

• Les listes sont des détecteurs complets. Une liste regex lourde ou un détecteur à modèle relance un calcul à chaque message, et une seconde fois pour le contrôle final (cleared_values).
• forces_value relance la liste à masquer sur chaque valeur d'entité introduite par l'assistant, sous FORCE.
• Une détection en cache n'est pas repassée dans les listes (BR-LIST-08 BR-LIST-08 Imposer une liste à masquer et une liste à laisser en clair Quand une liste change pendant une conversation, alors un message déjà analysé garde son ancien résultat, même renvoyé à l'identique.). Pour appliquer une nouvelle liste à une conversation en cours, effacez la conversation (forget_thread) ou corrigez le message par anonymize_corrected.
• ExactMatchDetector est d'abord un outil de test. Utilisé comme liste à masquer dans DetectionOverride, il survit aux corrections humaines. Utilisé seul comme détecteur principal, il n'y survit pas.

Tests