Mémoire et événements clés

Le panneau Mémoire gère deux types de mémoire : le contexte de conversation (mémoire à court terme, contexte complet) et les événements clés (mémoire métier à long terme, inter-sessions).

Mémoire à court terme

La mémoire à court terme détermine si l'agent « se souvient des derniers tours de conversation » :

• Contrôlée par le paramètre « Activer les N derniers tours d'historique de chat » du panneau Mémoire : vous pouvez définir combien de tours de conversation récents conserver (une question et une réponse = un tour), 30 tours par défaut.
• Une fois désactivée, l'historique inter-tours n'est plus transmis au modèle, et l'agent « oublie le tour précédent ». Lorsqu'un client signale qu'il « ne se souvient pas du tour précédent », vérifiez d'abord ici.
• En mode débogage / prévisualisation, la mémoire est toujours vide (un contexte vierge à chaque fois), ce qui est normal.

Contexte complet

Dans la fenêtre de mémoire à court terme, les tours plus anciens ne conservent par défaut que le texte brut de « ce qui a été demandé, ce qui a été répondu » — quel outil a été appelé à ce moment-là, quels paramètres ont été transmis, quel résultat a été obtenu ne figurent pas dans l'historique. Le contexte complet est une couche superposée à la mémoire à court terme : il fait en sorte que les derniers tours transportent en plus la trace complète des appels d'outils (quel outil a été appelé, les paramètres d'entrée, le résultat renvoyé), pour que le modèle se souvienne précisément de ce qu'il vient de faire.

• Contrôlé par le paramètre contexte complet du panneau Mémoire (la valeur s'affiche comme « N derniers tours »), 1 tour par défaut, plage 0–5 ; 0 signifie désactivé (les tours plus anciens ne conservent que le texte des questions-réponses).
• Il constitue avec le nombre de tours de la mémoire à court terme deux paramètres indépendants qui n'ont aucune influence l'un sur l'autre.
• Il se compte par tour (une question et une réponse = un tour), et non par nombre de réponses : si un même tour comporte plusieurs réponses, il n'est pas coupé en son milieu — soit tout le tour porte la trace d'outils, soit aucun.

Quand l'augmenter : lorsque le modèle « semble ne pas se souvenir de quel outil il a appelé au tour précédent ni des paramètres transmis », vérifiez d'abord si cette valeur est réglée sur 0 ou trop basse, puis augmentez-la. À l'inverse, plus le nombre de tours transportés est élevé, plus la consommation de Token augmente vite — plus grand n'est pas mieux ; 1 à 2 tours suffisent généralement.

Événements clés

Les événements clés sont la mémoire à long terme inter-sessions, au niveau utilisateur de LoopAgent (équivalents à un ticket). Au cours d'une conversation, le modèle crée / met à jour / interroge activement des événements pour l'utilisateur (comme « traitement de remboursement » ou « anomalie de compte ») ; lorsque le même utilisateur revient dans une autre session, il peut encore les voir et continuer à les faire avancer.

• Les événements sont rattachés à l'identité de l'utilisateur et sont visibles et modifiables dans toutes les sessions de cet utilisateur.
• À chaque tour, le prompt système transporte automatiquement jusqu'à 5 événements non clos de cet utilisateur ; le modèle interroge activement lorsqu'il en faut davantage.

Différence avec un Agent / FlowAgent ordinaire : les trois types d'agents partagent la même configuration d'événements clés (interrupteur + types d'événements), mais la manière d'écrire diffère — LoopAgent écrit de manière synchrone au cours de la conversation (crée / modifie directement des événements dans le tour) ; un Agent / FlowAgent ordinaire extrait de manière asynchrone en arrière-plan après la conversation. Pour les notions générales sur les événements clés, la configuration des types d'événements et les cas d'usage, voir Événements clés.

Conditions d'apparition : les deux conditions doivent être réunies

Pour que les outils liés aux événements clés apparaissent, il faut que les deux conditions soient réunies simultanément :

1. L'interrupteur général des événements clés dans la mémoire est activé ;
2. Au moins un type est configuré dans les catégories de types d'événements.

Interrupteur activé mais aucun type d'événement créé → les outils d'événements clés n'apparaissent pas, et aucun événement historique n'est injecté. Ce n'est pas un dysfonctionnement.

Questions fréquentes

• « La création d'un événement renvoie une erreur de paramètre » : le plus souvent, le type d'événement utilisé par le modèle ne figure pas dans le dictionnaire de types que vous avez configuré. Vérifiez que le type transmis par le modèle correspond mot pour mot aux noms de types de la page de paramètres (sensible à la casse et aux espaces).
• « Créé mais introuvable lors d'une nouvelle visite » : soupçonnez en priorité que l'identité de l'utilisateur n'a pas été résolue (session anonyme / de canal). Dans ce cas, les événements se rabattent sur la session, et la recherche inter-sessions peut les manquer.