Suivre une conversation et restaurer la réponse

En bref

• Dans une conversation, une même valeur garde le même jeton du premier au dernier message.
• Deux conversations sont isolées. Le même nom peut porter le même numéro dans les deux, mais elles ne partagent rien.
• Chaque appel nomme sa conversation. Un appel sans identifiant est refusé, au lieu de tomber dans une conversation partagée. Seule la commande piighost anonymize se rabat sur la conversation default.
• Une valeur citée d'abord par l'assistant reste en clair, même si l'utilisateur la reprend ensuite.
• Effacer une conversation supprime sa mémoire. Les jetons de cette conversation ne sont plus restaurés ensuite.

Besoins couverts, décrits dans Besoins par profil :

• Responsable conformité : DPO-6 DPO-6 Besoins par profil En tant que DPO, je veux effacer une conversation sur demande, afin de répondre au droit à l'effacement.
• Développeur : DEV-2 DEV-2 Besoins par profil En tant que développeur, je veux que la réponse soit restaurée automatiquement, afin de ne rien écrire pour remettre les vraies valeurs., DEV-3 DEV-3 Besoins par profil En tant que développeur, je veux qu'une valeur garde le même jeton sur toute la conversation, afin que le LLM suive le fil., DEV-8 DEV-8 Besoins par profil En tant que développeur, je veux décider quoi faire d'un jeton que le LLM a inventé, afin qu'il n'arrive pas tel quel à l'utilisateur., DEV-10 DEV-10 Besoins par profil En tant que développeur, je veux que chaque conversation soit nommée explicitement, afin que deux utilisateurs ne partagent jamais leurs jetons par accident., DEV-11 DEV-11 Besoins par profil En tant que développeur, je veux choisir le sort d'une valeur que l'assistant introduit lui-même, afin de décider si le LLM garde ce qu'il sait d'elle.
• Exploitant : OPS-2 OPS-2 Besoins par profil En tant qu'exploitant, je veux que la mémoire survive aux redémarrages et soit partagée entre instances, afin qu'une conversation ne perde pas ses jetons., OPS-7 OPS-7 Besoins par profil En tant qu'exploitant, je veux que la mémoire en processus soit bornée par défaut, afin qu'un serveur qui tourne des semaines ne garde pas toutes les valeurs qu'il a vues.
• Utilisateur de l'application : USER-1 USER-1 Besoins par profil En tant qu'utilisateur, je veux lire la réponse avec mes vraies informations, afin de ne jamais voir de jeton., USER-2 USER-2 Besoins par profil En tant qu'utilisateur, je veux que la conversation reste cohérente de bout en bout, afin que l'assistant ne confonde pas deux personnes., 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 traitement d'un message isolé est décrit dans Protéger un message avant l'envoi au modèle.

Pour le métier

piighost n'a pas d'écran. Une conversation est désignée par un identifiant que l'application transmet à chaque message. Ce que vous pouvez constater, c'est le texte reçu par le modèle et la réponse affichée.

Qui intervient

Le trajet d'un message dans une conversation

Exemple de conversation

Si le modèle répond « Bonjour <<PERSON:1>>, saluez <<PERSON:2>>. », l'utilisateur lit « Bonjour Claire Dubois, saluez Marc Petit. »

Comment vérifier : demandez à l'équipe technique la correspondance des jetons de la conversation. Chaque jeton doit désigner une seule personne.

Corriger un repérage

L'utilisateur, ou l'application en son nom, peut corriger les valeurs d'un message avant l'envoi, par exemple ajouter un nom oublié, ou rendre lisible un terme masqué à tort.

Si votre application a un écran de correction, faites-le dans cet écran. Sinon, demandez-le à l'équipe technique. Elle applique la correction par anonymize_corrected (ou la route /v1/anonymize/corrected du serveur).

1. Repérez le message à corriger.
2. Ajoutez la valeur oubliée avec son type, ou retirez la valeur masquée à tort.
3. Renvoyez le message corrigé.

Comment vérifier : la valeur ajoutée part sous forme de jeton, la valeur retirée part en clair, et les autres messages ne changent pas.

Effacer une conversation

Cas typique : une personne exerce son droit à l'effacement.

1. Identifiez la conversation par son identifiant.
2. Demandez son effacement à l'équipe technique, ou appelez la route d'effacement du serveur.
3. Notez le compte rendu, c'est-à-dire le nombre de messages et de valeurs supprimés.

Sur un serveur qui tourne en plusieurs instances, l'effacement vide le stockage et le cache de jetons de l'instance qui reçoit la demande. Les autres instances gardent une copie des valeurs dans leur propre cache, jusqu'à ce qu'elle en soit chassée ou que la durée de vie de ce cache expire (BR-STO-06 BR-STO-06 Stocker les conversations et protéger les traces Quand une conversation est effacée, alors son stockage et le cache de jetons du processus qui reçoit la demande sont vidés.). Si vous effacez des conversations sur demande, faites régler cette durée de vie par l'équipe technique.

Comment vérifier : restaurez un ancien jeton de cette conversation. Il doit rester tel quel, par exemple « Bonjour <<PERSON:1>> ». Sur un serveur à plusieurs instances, ce contrôle ne prouve pas que la copie des autres instances a disparu. Attendez la fin de la durée de vie du cache, ou faites redémarrer ces instances.

Règles à connaître

BR-CONV-01 BR-CONV-01 Suivre une conversation et restaurer la réponse Quand une valeur réapparaît dans un message suivant de la même conversation, alors elle reprend son jeton.. Quand une valeur réapparaît dans un message suivant de la même conversation, alors elle reprend son jeton. Une nouvelle valeur du même type reçoit le numéro suivant. 2 emplacements · 8 tests directs

BR-CONV-02 BR-CONV-02 Suivre une conversation et restaurer la réponse Quand la même valeur apparaît dans deux conversations différentes, alors chacune a sa propre numérotation, et un jeton ne se restaure que dans sa conversation.. Quand la même valeur apparaît dans deux conversations différentes, alors chacune a sa propre numérotation, et un jeton ne se restaure que dans sa conversation. Par exemple, « Marc Petit » est <<PERSON:2>> dans une conversation et <<PERSON:1>> dans une autre. Restaurer <<PERSON:1>> dans une troisième conversation vide le laisse tel quel. 2 emplacements · 8 tests directs

BR-CONV-03 BR-CONV-03 Suivre une conversation et restaurer la réponse Quand un appel ne nomme aucune conversation, alors il est refusé, avant tout envoi au modèle.. Quand un appel ne nomme aucune conversation, alors il est refusé, avant tout envoi au modèle. Une application dont les conversations n'ont pas besoin d'être séparées nomme elle-même la conversation default. La raison est que sans identifiant, tous les utilisateurs partageraient leurs jetons. 2 emplacements · 9 tests directs

La commande piighost anonymize fait exception. Elle sert à essayer un texte isolé, et se rabat sur la conversation default quand aucun identifiant ne lui est donné.

BR-CONV-04 BR-CONV-04 Suivre une conversation et restaurer la réponse Quand l'assistant cite une valeur avant l'utilisateur, alors elle reste en clair pour toute la conversation, même si l'utilisateur la reprend ensuite (tour 4, « Lyon »).. Quand l'assistant cite une valeur avant l'utilisateur, alors elle reste en clair pour toute la conversation, même si l'utilisateur la reprend ensuite (tour 4, « Lyon »). La raison est que le modèle connaît déjà cette valeur, et la masquer lui retirerait une connaissance utile. Les deux autres réglages sont de la masquer comme une valeur de l'utilisateur, ou de ne pas analyser les messages de l'assistant. Une valeur apportée d'abord par l'utilisateur reste masquée, même si l'assistant la répète. 3 emplacements · 11 tests directs

BR-CONV-05 BR-CONV-05 Suivre une conversation et restaurer la réponse Quand la réponse du modèle contient un jeton de la conversation, alors il est remplacé par la vraie valeur, même dans un texte que piighost n'a jamais protégé.. Quand la réponse du modèle contient un jeton de la conversation, alors il est remplacé par la vraie valeur, même dans un texte que piighost n'a jamais protégé. 1 emplacement · 8 tests directs

BR-CONV-06 BR-CONV-06 Suivre une conversation et restaurer la réponse Quand la réponse contient un jeton au bon format que piighost n'a jamais émis, alors la restauration est refusée par défaut, avec l'erreur Deanonymized text holds tokens the pipeline never issued: ['<<PERSON:9>>'].. Quand la réponse contient un jeton au bon format que piighost n'a jamais émis, alors la restauration est refusée par défaut, avec l'erreur Deanonymized text holds tokens the pipeline never issued: ['<<PERSON:9>>']. Ce jeton a été inventé par le modèle ou injecté par un texte. Les deux autres choix sont de le garder ou de le retirer. 1 emplacement

Un jeton dont la casse ou le numéro a changé (<<Person:1>>, <<PERSON:01>>) compte comme inventé. Un jeton aux délimiteurs abîmés (<< PERSON:1 >>) n'est pas reconnu du tout et reste tel quel.

BR-CONV-07 BR-CONV-07 Suivre une conversation et restaurer la réponse Quand une personne corrige à la main les valeurs d'un message, alors sa correction remplace le repérage automatique de ce message seulement.. Quand une personne corrige à la main les valeurs d'un message, alors sa correction remplace le repérage automatique de ce message seulement. La liste à masquer (deny_list dans la configuration) et la liste à laisser en clair (allow_list) s'appliquent encore. Par exemple, retirer « Claire Dubois » du tour 1 le laisse en clair au tour 1, et il reste masqué au tour 2. Les numéros peuvent alors changer pour toute la conversation. Après ce retrait, <<PERSON:1>> désigne Marc Petit et <<PERSON:2>> Claire Dubois. 4 emplacements · 8 tests directs

BR-CONV-08 BR-CONV-08 Suivre une conversation et restaurer la réponse Quand un message identique est renvoyé dans la même conversation, alors son repérage n'est pas refait.. Quand un message identique est renvoyé dans la même conversation, alors son repérage n'est pas refait. Le résultat enregistré la première fois est réutilisé. 1 emplacement · 8 tests directs

BR-CONV-09 BR-CONV-09 Suivre une conversation et restaurer la réponse Quand une conversation est effacée, alors toute sa mémoire est supprimée, et l'effacement rend le nombre de messages et de valeurs supprimés.. Quand une conversation est effacée, alors toute sa mémoire est supprimée, et l'effacement rend le nombre de messages et de valeurs supprimés. Par exemple, il rend Forgotten(messages=4, detections=5) pour la conversation ci-dessus. Ensuite, <<PERSON:1>> n'est plus restauré et reste tel quel. 1 emplacement · 8 tests directs

BR-CONV-10 BR-CONV-10 Suivre une conversation et restaurer la réponse Quand plusieurs instances du service partagent la même mémoire Redis, alors elles donnent le même jeton à la même valeur d'une conversation, et chacune restaure les jetons émis par l'autre.. Quand plusieurs instances du service partagent la même mémoire Redis, alors elles donnent le même jeton à la même valeur d'une conversation, et chacune restaure les jetons émis par l'autre. 1 emplacement

BR-CONV-11 BR-CONV-11 Suivre une conversation et restaurer la réponse Quand la mémoire est gardée dans le processus, alors, sauf autre réglage, elle garde au plus 10 000 conversations et oublie chacune un jour après son dernier message.. Quand la mémoire est gardée dans le processus, alors, sauf autre réglage, elle garde au plus 10 000 conversations et oublie chacune un jour après son dernier message. Une conversation oubliée ne restaure plus ses jetons. La raison est qu'un serveur qui tourne des semaines ne doit pas garder toutes les valeurs qu'il a vues. 2 emplacements · 37 tests directs

Pour une réponse affichée pendant qu'elle arrive, voir Afficher une réponse au fil de l'eau.

Ce que voit l'utilisateur final

Une conversation lisible, avec les vraies valeurs. Une ancienne réponse peut toutefois montrer des jetons si l'application la restaure une seconde fois. C'est le cas après un effacement, ou après un jour d'inactivité quand la mémoire est gardée dans le processus.

Questions fréquentes

L'appel s'arrête avec No thread_id in the LangGraph config. L'application ne nomme pas la conversation (BR-CONV-03 BR-CONV-03 Suivre une conversation et restaurer la réponse Quand un appel ne nomme aucune conversation, alors il est refusé, avant tout envoi au modèle.). Faites-lui passer un identifiant, ou default si les conversations n'ont pas besoin d'être séparées.

Une réponse a affiché le nom d'une autre personne. Un message ancien a probablement été corrigé à la main (BR-CONV-07 BR-CONV-07 Suivre une conversation et restaurer la réponse Quand une personne corrige à la main les valeurs d'un message, alors sa correction remplace le repérage automatique de ce message seulement.), ou la mémoire d'un message a expiré (voir Pièges). Vérifiez l'historique de la conversation.

« Lyon » n'est pas masqué alors que l'utilisateur l'a écrit. L'assistant l'avait cité avant lui (BR-CONV-04 BR-CONV-04 Suivre une conversation et restaurer la réponse Quand l'assistant cite une valeur avant l'utilisateur, alors elle reste en clair pour toute la conversation, même si l'utilisateur la reprend ensuite (tour 4, « Lyon »).). Pour forcer le masquage, voir Imposer une liste à masquer et une liste à laisser en clair.

La réponse s'arrête avec Deanonymized text holds tokens the pipeline never issued. Le modèle a écrit un jeton inconnu (BR-CONV-06 BR-CONV-06 Suivre une conversation et restaurer la réponse Quand la réponse contient un jeton au bon format que piighost n'a jamais émis, alors la restauration est refusée par défaut, avec l'erreur Deanonymized text holds tokens the pipeline never issued: ['<<PERSON:9>>'].). Il a souvent recopié un jeton d'une autre conversation ou d'un document.

La réponse montre <<PERSON:1>> après une longue pause. La mémoire en processus a oublié la conversation après un jour d'inactivité (BR-CONV-11 BR-CONV-11 Suivre une conversation et restaurer la réponse Quand la mémoire est gardée dans le processus, alors, sauf autre réglage, elle garde au plus 10 000 conversations et oublie chacune un jour après son dernier message.), ou la conversation a été effacée (BR-CONV-09 BR-CONV-09 Suivre une conversation et restaurer la réponse Quand une conversation est effacée, alors toute sa mémoire est supprimée, et l'effacement rend le nombre de messages et de valeurs supprimés.).

Pour les développeurs

Le guide technique construit un pipeline de conversation pas à pas dans Pipeline conversationnel.

Où vivent les règles

Composants liés : ThreadAnonymizationPipeline, AnyConversationMemory (remember, get_detections, get_provenance, forget), MessageRole, Forgotten, thread_token_map, TextDeidentifier, DEFAULT_THREAD_ID (conversation_memory/base.py:31), MissingThreadIdError, InventedPlaceholderStrategy, EntityCreateByAssistantStrategy.

Mécanique : les jetons sont attribués sur l'union des détections de tous les messages, dans l'ordre de première apparition. Le rendu ne remplace que les positions du message courant, car les détections de messages différents partagent le même espace de positions.

Corriger un message à la main

1. Construisez le jeu corrigé de Detection pour le texte exact du message.
2. Appelez await pipeline.anonymize_corrected(texte, thread_id, détections).
3. Si le message corrigé n'est pas le dernier, relancez les tours suivants (BR-CONV-07 BR-CONV-07 Suivre une conversation et restaurer la réponse Quand une personne corrige à la main les valeurs d'un message, alors sa correction remplace le repérage automatique de ce message seulement.).

Vérifier

uv run pytest tests/pipeline/test_thread.py tests/pipeline/test_thread_hitl.py tests/acceptance

Après la correction, await pipeline.thread_token_map(thread_id) doit montrer la correspondance attendue jeton par jeton.

Pièges

• Aucune intégration ne retombe sur default. Le middleware LangChain et les hooks Claude Code lèvent MissingThreadIdError. Le serveur répond 400. Seule la commande piighost anonymize garde --thread-id default, pour une commande isolée.
• La numérotation dépend de l'ordre de l'union. Tout ce qui retire un message ancien de l'union décale la numérotation. C'est le cas d'une correction (BR-CONV-07 BR-CONV-07 Suivre une conversation et restaurer la réponse Quand une personne corrige à la main les valeurs d'un message, alors sa correction remplace le repérage automatique de ce message seulement.), mais aussi de l'expiration d'un message Redis avec ttl, que _read_all retire de l'union (conversation_memory/redis_backend.py:200-228).
• La mémoire en processus oublie en silence. Une conversation évincée ou expirée (BR-CONV-11 BR-CONV-11 Suivre une conversation et restaurer la réponse Quand la mémoire est gardée dans le processus, alors, sauf autre réglage, elle garde au plus 10 000 conversations et oublie chacune un jour après son dernier message.) ne lève rien. Ses jetons restent tels quels à la restauration. max_threads=None et ttl=None lèvent les bornes.
• La provenance porte sur la clé de valeur (value_key), donc sur toutes les graphies d'une valeur.
• Le cache de jetons est mémorisé par processus (256 cartes au plus, _TOKEN_MEMO_MAX). Voir Stocker les conversations pour l'effet sur l'effacement en multi-processus, et token_memo_ttl pour le borner.
• anonymize_corrected ne résout pas les chevauchements et ne relance pas l'expansion. Le jeu corrigé doit être propre. Il passe seulement par la liste à masquer et la liste à laisser en clair.

Tests