Pourquoi mon assistant IA ne se souvient-il pas de ce que je lui ai dit plus tôt ?

Symptôme: J'ai enregistré une préférence ou un détail important, mais dans une conversation ultérieure, mon assistant IA agit comme s'il ne l'avait jamais vu. Cause: L'assistant est peut-être connecté à un autre compte XMemo, un autre projet ou un autre contexte d'appareil, ou la mémoire d'origine n'a pas été enregistrée. Action: Demandez à l'assistant d'enregistrer un petit détail de test non confidentiel, puis ouvrez la Memory Console et vérifiez qu'il apparaît bien sous le compte et le projet que vous utilisez. Vérification: Démarrez une nouvelle conversation avec le même assistant et interrogez-le sur ce détail de test ; supprimez l'entrée de test une fois terminé. Sécurité: Utilisez un détail de test inventé ; n'utilisez pas les informations privées d'une autre personne.

Pourquoi mon assistant IA mélange-t-il mes projets ou mes conversations ?

Symptôme: Un détail d'un projet apparaît dans un autre, ou l'assistant répond comme si deux conversations distinctes étaient liées. Cause: L'assistant utilise peut-être un contexte de projet ou de compte différent de celui où la mémoire a été enregistrée. Action: Dans l'assistant, choisissez le compte et le projet XMemo prévus, reconnectez-le si nécessaire, puis réessayez avec un détail de test clairement étiqueté. Vérification: Vérifiez le projet et la source de la mémoire dans la Memory Console, puis confirmez qu'un projet non lié ne peut pas voir ce détail de test. Sécurité: Ne déplacez pas d'informations privées entre projets simplement pour les faire apparaître.

Comment puis-je faire oublier complètement quelque chose à mon assistant IA ?

Symptôme: Je souhaite supprimer une mémoire et je dois m'assurer qu'elle a bien disparu. Cause: Consulter, retirer de façon réversible, supprimer définitivement et exporter une mémoire constituent des actions de compte distinctes. Action: Ouvrez la Memory Console, repérez la mémoire et utilisez sa commande de suppression ou d'oubli ; si vous ne trouvez pas la commande, contactez le Support en fournissant la référence de la mémoire. Vérification: Recherchez à nouveau la mémoire et confirmez l'état affiché par la Memory Console ; vérifiez que tout export ne contient que les données de votre compte. Sécurité: Supprimez uniquement la mémoire visée et n'incluez jamais de contenu privé dans un message adressé au support.

J'ai changé d'ordinateur ou d'assistant IA ; XMemo se souviendra-t-il toujours de moi ?

Symptôme: Mes anciennes mémoires semblent séparées des nouvelles après avoir changé d'appareil, redémarré un assistant ou changé d'hôte. Cause: La nouvelle connexion de l'assistant peut identifier l'appareil ou l'assistant comme une nouvelle source, ou être connectée à un autre compte. Action: Reconnectez XMemo dans l'assistant que vous souhaitez utiliser, connectez-vous au même compte et conservez l'étiquette d'appareil de la connexion stable lorsque l'application propose cette option. Vérification: Enregistrez un détail de test inventé, lancez une nouvelle conversation sur le même assistant et confirmez que le détail apparaît sans changer de compte. Sécurité: Vérifiez le compte avant d'enregistrer quoi que ce soit de personnel sur un ordinateur partagé.

Pourquoi mon assistant IA a-t-il enregistré la même chose deux fois ?

Symptôme: Je vois deux copies de ce qui semble être la même mémoire après une nouvelle tentative ou une reconnexion. Cause: Le premier enregistrement a peut-être réussi même si l'assistant n'a pas affiché le résultat, de sorte que la répétition de la demande a créé une autre copie. Action: Ouvrez la Memory Console, comparez les deux entrées et ne supprimez que le doublon après avoir confirmé leurs dates et leur source. Vérification: Demandez à l'assistant d'enregistrer une seule fois un nouveau détail de test clairement étiqueté et confirmez qu'une seule nouvelle entrée apparaît. Sécurité: Ne supprimez pas toutes les mémoires correspondantes avant d'avoir identifié la copie que vous souhaitez conserver.

Pourquoi mon assistant IA me donne-t-il trop ou pas assez de mon contexte passé ?

Symptôme: L'assistant mentionne des détails non pertinents, omet la décision dont j'ai besoin ou formule une réponse surchargée. Cause: La demande couvre un sujet ou une période trop large, ou l'assistant essaie d'utiliser davantage de contexte enregistré que la conversation n'en nécessite. Action: Demandez un sujet, un projet ou une période plus restreints, et précisez à l'assistant quelle décision ou quel détail importe le plus. Vérification: Comparez la réponse avec le sujet demandé et supprimez tout détail non pertinent de la conversation avant de continuer. Sécurité: Ne demandez pas à l'assistant de révéler des mémoires privées sans rapport simplement pour étoffer la conversation.

J'ai déconnecté XMemo ; comment m'assurer que l'ancien assistant ne peut plus l'utiliser ?

Symptôme: J'ai retiré la connexion d'un assistant, mais j'ignore s'il peut toujours accéder à mes mémoires. Cause: Retirer une connexion de l'application peut ne pas annuler l'autorisation de connexion au niveau du compte. Action: Ouvrez les contrôles de sécurité ou d'applications connectées de votre compte XMemo, révoquez l'ancienne connexion d'assistant et reconnectez uniquement celle en laquelle vous avez confiance. Vérification: Testez l'ancienne connexion uniquement si cela ne présente aucun risque, et confirmez qu'elle est refusée avant d'utiliser la nouvelle connexion. Sécurité: Révoquez uniquement la connexion que vous souhaitez retirer et ne partagez pas vos identifiants de connexion au compte.

Pourquoi mon assistant IA ne peut-il plus utiliser XMemo ?

Symptôme: XMemo était auparavant disponible dans mon assistant, mais ses actions de mémoire n'apparaissent plus ou l'assistant indique qu'il ne peut pas les utiliser. Cause: L'assistant doit peut-être rafraîchir sa connexion XMemo, ou il est connecté à un autre compte. Action: Ouvrez les paramètres d'applications connectées de l'assistant, déconnectez et reconnectez XMemo, puis lancez une nouvelle conversation. Vérification: Demandez à l'assistant d'indiquer si XMemo est connecté, puis effectuez une lecture sans danger avant d'enregistrer quoi que ce soit. Sécurité: Ne collez jamais d'identifiants secrets de compte ni de mémoires privées dans une conversation ou une demande d'assistance.

Quelle connexion XMemo dois-je utiliser dans mon assistant IA ?

Symptôme: J'ignore quelle page ou connexion XMemo doit figurer dans les paramètres de mon assistant. Cause: La page de configuration guidée et la connexion de l'assistant ont des objectifs différents, et les configurations hébergées et auto-hébergées possèdent des limites distinctes. Action: Pour le service hébergé, commencez sur https://xmemo.dev/product/docs et suivez le lien de connexion indiqué pour votre assistant ; renseignez-vous auprès du Support si votre organisation vous a fourni une page de configuration distincte. Vérification: Avant d'enregistrer un détail personnel, confirmez que la page utilise bien votre compte XMemo et le service hébergé prévu. Sécurité: N'utilisez pas d'adresses de développement local et ne collez pas d'identifiants privés dans une conversation publique.

Que dois-je faire si mon assistant IA ne parvient toujours pas à se connecter à XMemo ?

Symptôme: J'ai réessayé les étapes de connexion, mais l'assistant ne parvient toujours pas à utiliser XMemo. Cause: Le problème peut venir de l'application de l'assistant, de mon compte ou d'une connexion obsolète que les instructions publiques ne peuvent pas inspecter. Action: Contactez le Support en indiquant le nom de l'assistant, l'heure approximative et une brève description de ce qui s'est produit ; n'incluez que des informations caviardées. Vérification: Assurez-vous que le signalement peut être reproduit sans envoyer de mémoires privées ni de secrets de compte. Sécurité: N'envoyez jamais d'identifiants de connexion, de codes à usage unique, de cookies ou de texte de mémoire privée.

OAuth a échoué ou la fenêtre de consentement ne se termine jamais.

Symptôme: Le client affiche une erreur 401, le navigateur OAuth ne s'ouvre pas ou le consentement revient au client sans établir de connexion utilisable. Cause: L'autorisation hébergée est peut-être obsolète, la transmission au navigateur est bloquée ou le client utilise un ancien enregistrement de serveur. Action: Déconnectez-vous du serveur MCP XMemo dans l'application hôte, reconnectez l'URL hébergée MCP et approuvez à nouveau memory:read et memory:write. Vérification: Reconnectez-vous jusqu'à ce que le client indique une autorisation active, puis lancez un rappel inoffensif avant d'écrire de la mémoire. Sécurité: Ne basculez pas vers XMEMO_KEY dans les clients OAuth simplement pour contourner une session OAuth obsolète.

La requête renvoie 403 Forbidden.

Symptôme: Le serveur est joignable et l'identifiant est reconnu, mais le projet, l'outil ou l'action de mémoire demandés sont refusés. Cause: L'autorisation ne dispose pas du périmètre requis, le compte se situe en dehors de la limite du projet sélectionné ou la ressource appartient à un autre locataire. Action: Vérifiez le compte et le projet sélectionnés, reconnectez OAuth ou demandez le périmètre souhaité, puis réessayez la même opération sans modifier la ressource. Vérification: Confirmez qu'une requête en lecture seule dans le projet prévu réussit avant de réitérer une opération d'écriture ou de suppression. Sécurité: N'élargissez pas les périmètres et ne copiez pas le jeton d'un autre utilisateur pour faire disparaître une erreur 403.

Le serveur MCP se connecte mais aucun outil n'apparaît.

Symptôme: L'hôte indique un serveur connecté, mais tools/list est vide ou les outils XMemo manquent dans le sélecteur d'outils du modèle. Cause: Le client n'a pas actualisé la découverte, utilise le mauvais profil MCP ou est connecté à une URL ou un enregistrement obsolètes. Action: Reconnectez le serveur, vérifiez que le client utilise le profil MCP pris en charge et relancez la découverte d'outils avant de modifier les identifiants. Vérification: Confirmez qu'au moins remember, recall et search_memory apparaissent avant de débuter une écriture ou une démonstration pour une marketplace. Sécurité: Ne collez pas de jetons porteurs dans des captures d'écran, des tickets d'assistance ou des notes d'évaluation de marketplace.

Un client direct MCP signale que le jeton est manquant.

Symptôme: Un client direct indique que XMEMO_KEY n'est pas défini, est vide ou indisponible alors même que la variable a été ajoutée sur la machine. Cause: Le processus du client n'a pas hérité de l'environnement, la variable a été ajoutée dans un autre shell ou la configuration attend plutôt une référence à un magasin de secrets. Action: Définissez XMEMO_KEY dans l'environnement local ou le magasin de secrets, redémarrez le client et maintenez XMEMO_AGENT_INSTANCE_ID stable lorsque l'attribution importe. Vérification: Inspectez uniquement les métadonnées de présence de la variable, redémarrez le client et confirmez un rappel authentifié sans danger ; n'imprimez jamais la valeur du jeton. Sécurité: Conservez le vrai jeton hors des fichiers de configuration validés dans git ; les exemples publics doivent référencer uniquement des variables d'environnement.

L'ID d'instance d'agent change après chaque redémarrage.

Symptôme: Le même exécuteur local apparaît sous la forme de plusieurs agents ou les rappels sont scindés entre instances après un redémarrage ou un redéploiement. Cause: XMEMO_AGENT_INSTANCE_ID est généré au lancement du processus au lieu d'être conservé dans le secret local ou la configuration d'environnement de l'exécuteur. Action: Générez une étiquette d'instance non secrète par exécuteur, conservez-la en dehors de git et transmettez-la avec chaque connexion MCP directe. Vérification: Redémarrez l'exécuteur à deux reprises et confirmez que la même étiquette d'instance apparaît dans l'attribution de source sans exposer d'identifiants. Sécurité: L'étiquette d'instance est une métadonnée d'attribution, pas un identifiant d'autorisation ; les limites de compte et de jeton contrôlent toujours l'accès.

Le rappel renvoie une mémoire vide.

Symptôme: Un rappel ou une recherche réussit mais ne renvoie aucun enregistrement pertinent après que l'utilisateur a enregistré du contexte. Cause: La lecture utilise un compte, un projet, un périmètre, une limite d'agent ou un type de mémoire différents de l'écriture, ou l'enregistrement de test n'a jamais été validé. Action: Créez une mémoire de test synthétique, vérifiez le chemin et le type de mémoire dans la Memory Console, puis réessayez le rappel depuis la même limite de compte ou de locataire. Vérification: Relisez l'enregistrement synthétique nouvellement créé avec le même projet et périmètre, puis supprimez-le via la procédure de suppression prévue. Sécurité: Utilisez des données d'évaluation synthétiques ; n'utilisez pas la mémoire privée de clients pour une démonstration de marketplace.

Le rappel ou l'écriture utilise le mauvais périmètre de projet.

Symptôme: Un enregistrement est visible dans un projet mais pas dans un autre, ou une écriture apparaît sous un projet que l'opérateur ne prévoyait pas d'utiliser. Cause: Le client a réutilisé un identifiant de projet provenant d'un autre environnement, a omis la limite de projet ou a conservé une session de compte obsolète. Action: Sélectionnez explicitement le compte et le projet souhaités, actualisez le contexte du client et répétez l'opération avec un enregistrement synthétique. Vérification: Confirmez le projet et l'attribution de source de l'enregistrement dans la Memory Console, puis vérifiez qu'un projet non lié ne peut pas le lire. Sécurité: Ne résolvez jamais un décalage de périmètre en accordant un jeton plus large ou en copiant des données entre projets.

La même mémoire est enregistrée deux fois.

Symptôme: Une nouvelle tentative ou une reconnexion génère des enregistrements en double au lieu d'une mémoire durable unique. Cause: Le client a réessayé après un délai d'attente sans limite d'idempotence, ou le flux de capture écrit avant d'avoir confirmé la première réponse. Action: Inspectez d'abord l'enregistrement existant et l'attribution de source, puis utilisez la politique de nouvelle tentative du client ou une clé d'idempotence stable avant d'écrire à nouveau. Vérification: Répétez la même capture contrôlée une seule fois et confirmez un nouvel enregistrement plus une relecture, sans second nouvel enregistrement. Sécurité: Ne supprimez pas en bloc les mémoires correspondantes avant d'avoir confirmé l'enregistrement visé et le périmètre de compte.

Le contexte de rappel est trop volumineux ou trop restreint.

Symptôme: L'agent reçoit un contexte non pertinent, omet la décision nécessaire ou dépasse le budget de contexte utile de l'hôte. Cause: La requête est trop vaste, le périmètre ou la fenêtre temporelle est manquant, ou l'appelant a demandé une limite de résultats inadaptée à la tâche. Action: Resserrez la requête avec des limites de projet, d'agent, de temps ou de sujet, et demandez un petit ensemble pertinent avant d'augmenter la limite. Vérification: Comparez le contexte renvoyé avec la question cible et confirmez que chaque enregistrement inclus est autorisé et pertinent. Sécurité: N'élargissez pas le périmètre et n'exportez pas de mémoires non liées simplement pour remplir une fenêtre de contexte.

Comment supprimer ou exporter de la mémoire ?

Symptôme: L'opérateur doit retirer un enregistrement, confirmer une action d'oubli ou obtenir une exportation délimitée au compte. Cause: La suppression, l'oubli réversible, la suppression définitive et l'exportation sont des flux distincts dotés de sémantiques de confirmation et de récupération différentes. Action: Utilisez d'abord la Memory Console ou les flux de gestion du compte ; si aucune procédure en libre-service n'est disponible, contactez le Support afin que la demande reste cantonnée au compte. Vérification: Après l'oubli ou la suppression, recherchez par la référence de l'enregistrement et confirmez l'état réversible ou permanent attendu ; vérifiez que les exportations ne contiennent que le périmètre du compte. Sécurité: Les exports et archives d'assistance doivent exclure les hachages de jetons, les clés API, les secrets de session, les identifiants de fournisseurs et les données d'autres locataires.

Comment révoquer l'accès après la déconnexion d'un client ?

Symptôme: Un client a été retiré localement, mais l'opérateur doit invalider son autorisation OAuth ou son identifiant direct. Cause: Déconnecter la configuration d'un client ne révoque pas nécessairement l'autorisation côté serveur ni ne fait tourner un jeton direct. Action: Ouvrez les contrôles de sécurité du compte ou des clients connectés, révoquez l'autorisation OAuth désignée et renouvelez l'identifiant direct si celui-ci a été exposé ou n'est plus fiable. Vérification: Réessayez une lecture authentifiée avec l'ancienne connexion et confirmez qu'elle est rejetée, puis reconnectez uniquement via la voie de consentement ou de magasin de secrets prévue. Sécurité: Révoquez uniquement le client ou l'autorisation visés ; ne publiez pas d'anciens jetons, de codes OAuth ou de détails de session lors du diagnostic d'accès.

XMemo est-il en disponibilité générale (GA), certifié ou répertorié sur une marketplace ?

Symptôme: Une fiche ou un document demande si une configuration fonctionnelle prouve la disponibilité générale, une certification ou une approbation marketplace. Cause: La prise en charge de configuration, la préparation OAuth, les preuves pilotes et l'approbation marketplace constituent des assertions distinctes. Action: Considérez les mentions publiques comme bêta ou prises en charge par configuration, sauf en présence d'un artefact d'approbation ou de certification marketplace spécifique. Vérification: Vérifiez la matrice canonique des capacités des clients et l'artefact d'approbation mentionné avant de publier une affirmation de statut. Sécurité: Ne revendiquez pas un statut GA, certifié, stable ou répertorié sur la seule base d'une configuration fonctionnelle.

Quelle URL dois-je utiliser ?

Symptôme: Un utilisateur du service hébergé hésite entre le démarrage rapide public, le point de terminaison MCP ou les instructions pour développeurs auto-hébergés. Cause: L'intégration hébergée et les parcours auto-hébergés ou hérités ont des URL, des identifiants et des limites de données différents. Action: Les utilisateurs du service hébergé doivent commencer par https://xmemo.dev/mcp pour les clients MCP et https://xmemo.dev/product/docs pour la configuration guidée. Vérification: Confirmez que l'URL d'hôte, le mode d'authentification et la limite du compte correspondent au déploiement hébergé ou auto-hébergé prévu avant de vous connecter. Sécurité: N'utilisez pas les instructions relatives à localhost, Supabase, Docker ou Python auto-hébergé comme premier parcours pour les utilisateurs du service hébergé public.

La mémoire apparaît sous le mauvais agent ou appareil.

Symptôme: Une mémoire est attribuée à un autre exécuteur ou apparaît scindée entre appareils après une mise à jour ou un redémarrage du client. Cause: Le client a modifié ses en-têtes non secrets d'agent ou d'instance, ou un identifiant partagé est utilisé par plusieurs exécuteurs. Action: Vérifiez les en-têtes non secrets d'agent/appareil ou le profil client, puis conservez l'ID d'instance local au lieu de le régénérer. Vérification: Écrivez un enregistrement synthétique depuis l'exécuteur prévu et confirmez que son attribution de source reste stable après la reconnexion. Sécurité: Les étiquettes d'attribution aident à vérifier la source, mais ne constituent pas une limite de sécurité ; les identifiants du compte contrôlent toujours l'accès.

Je ne parviens toujours pas à me connecter après avoir suivi les étapes.

Symptôme: La connexion reste indisponible après avoir réessayé la procédure OAuth ou de secret direct propre au client. Cause: Le problème persistant peut être propre au client, au compte, ou dû à un enregistrement obsolète ou à une limite d'environnement que la documentation locale ne peut inspecter. Action: Ouvrez une demande auprès du Support en précisant le nom du client, le chemin de configuration, l'horodatage approximatif et si le client utilise OAuth ou XMEMO_KEY. Vérification: Confirmez que le rapport d'assistance contient un symptôme reproductible et des métadonnées caviardées, puis attendez le diagnostic restreint au compte. Sécurité: Partagez uniquement des diagnostics caviardés ; n'envoyez jamais de jetons porteurs, de codes OAuth, de cookies ou de contenu de mémoire client.

Dépannage · XMemo Docs

Vérifier une connexion sans écrire de memory

Chaque parcours de dépannage ci-dessous se termine par une étape de verification. Commencez par une lecture : elle valide credential et transport sans rien modifier.

curl -s -o /dev/null -w '%{http_code}\n' \
  -H 'X-API-Key: <your-assigned-api-key>' \
  'https://xmemo.dev/v1/memories/search?query=connection%20check&limit=1'

Lire le status code

Le status sépare un problème de credential d'un memory store vide.

200 — authorized; an empty results array just means nothing matched.
401 — the credential is missing or not valid.
403 — the credential is valid but lacks the required scope.

Erreurs de connexion client

Lorsqu'un client IA ou exécuteur ne peut pas joindre le serveur MCP, isolez la négociation du protocole de transport et le routage avant de renouveler les jetons.

Vérifiez l'état du serveur avec un GET direct vers /health ou OPTIONS vers /mcp.
Vérifiez la compatibilité du transport : les clients hébergés utilisent Streamable HTTP (/mcp) ; les outils CLI locaux utilisent stdio.
Assurez-vous que les proxys d'entreprise ou pare-feu autorisent les réponses SSE en streaming sans troncature.

curl -I -s 'https://xmemo.dev/mcp'

Échecs d'authentification

Les échecs d'authentification distinguent les identifiants manquants (401 Unauthorized) des autorisations insuffisantes ou violations de limites de locataire (403 Forbidden).

Clients OAuth : Reconnectez-vous via l'application hôte et accordez memory:read et memory:write.
Clients Direct MCP : Vérifiez que XMEMO_KEY est renseigné dans l'environnement du processus sans exposer de secrets dans git.
403 Forbidden : Confirmez que le jeton appartient au locataire et au project scope actifs.

curl -s -o /dev/null -w '%{http_code}\n' \
  -H 'Authorization: Bearer <your-token>' \
  'https://xmemo.dev/v1/memories/search?query=auth%20check&limit=1'

Résultats de rappel vides

Un rappel renvoyant zéro résultat indique une divergence de portée ou de requête plutôt qu'une panne du moteur. Les lectures réussissent avec 200 OK si aucune mémoire ne correspond.

Divergence de project scope : Vérifiez que l'agent interrogateur opère dans le même project que la mémoire stockée.
Limite d'instance d'agent : Les clients Direct filtrant par XMEMO_AGENT_INSTANCE_ID ne peuvent pas lire les mémoires enregistrées sous d'autres identifiants d'instance.
Vérification d'état : Vérifiez dans Memory Console que la mémoire est validée et active, non supprimée ni obsolète.

curl -s -H 'Authorization: Bearer <your-token>' \
  'https://xmemo.dev/v1/memories/search?query=test&limit=5&scope=project:demo'

Délais d'attente de verrouillage d'écriture

Les écritures simultanées provenant de plusieurs exécuteurs ou outils parallèles peuvent entraîner des conflits de verrouillage sur des memory paths partagés.

Implémentez un intervalle d'attente exponentiel avec gigue aléatoire lorsque les requêtes d'écriture signalent un conflit de verrouillage.
Fournissez une clé d'idempotence (idempotency key) côté client lors des nouvelles tentatives d'écriture pour éviter les doublons.
Sérialisez les mutations de mémoire pour les flux de travail à haute fréquence à l'aide de files d'attente ou d'APIs par lots.

curl -s -X POST 'https://xmemo.dev/v1/memories' \
  -H 'Authorization: Bearer <your-token>' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <generate-a-uuid-v4>' \
  -d '{"content":"Durable convention fact","path":"projects/demo/conventions"}'

FAQ / Dépannage

Commencez par les réponses destinées aux utilisateurs d'assistants IA, puis consultez les réponses pour développeurs et intégrateurs pour les détails de connexion et d'exploitation. Chaque réponse comprend une étape d'action et une limite de sécurité.

Pour les utilisateurs d'assistants IA

Réponses du quotidien pour les personnes qui utilisent XMemo via un assistant IA sans configurer la connexion elles-mêmes.

Pourquoi mon assistant IA ne se souvient-il pas de ce que je lui ai dit plus tôt ?
Symptôme
J'ai enregistré une préférence ou un détail important, mais dans une conversation ultérieure, mon assistant IA agit comme s'il ne l'avait jamais vu.
Cause
L'assistant est peut-être connecté à un autre compte XMemo, un autre projet ou un autre contexte d'appareil, ou la mémoire d'origine n'a pas été enregistrée.
Action :
Demandez à l'assistant d'enregistrer un petit détail de test non confidentiel, puis ouvrez la Memory Console et vérifiez qu'il apparaît bien sous le compte et le projet que vous utilisez.
Vérification
Démarrez une nouvelle conversation avec le même assistant et interrogez-le sur ce détail de test ; supprimez l'entrée de test une fois terminé.
Sécurité :
Utilisez un détail de test inventé ; n'utilisez pas les informations privées d'une autre personne.
Pourquoi mon assistant IA mélange-t-il mes projets ou mes conversations ?
Symptôme
Un détail d'un projet apparaît dans un autre, ou l'assistant répond comme si deux conversations distinctes étaient liées.
Cause
L'assistant utilise peut-être un contexte de projet ou de compte différent de celui où la mémoire a été enregistrée.
Action :
Dans l'assistant, choisissez le compte et le projet XMemo prévus, reconnectez-le si nécessaire, puis réessayez avec un détail de test clairement étiqueté.
Vérification
Vérifiez le projet et la source de la mémoire dans la Memory Console, puis confirmez qu'un projet non lié ne peut pas voir ce détail de test.
Sécurité :
Ne déplacez pas d'informations privées entre projets simplement pour les faire apparaître.
Comment puis-je faire oublier complètement quelque chose à mon assistant IA ?
Symptôme
Je souhaite supprimer une mémoire et je dois m'assurer qu'elle a bien disparu.
Cause
Consulter, retirer de façon réversible, supprimer définitivement et exporter une mémoire constituent des actions de compte distinctes.
Action :
Ouvrez la Memory Console, repérez la mémoire et utilisez sa commande de suppression ou d'oubli ; si vous ne trouvez pas la commande, contactez le Support en fournissant la référence de la mémoire.
Vérification
Recherchez à nouveau la mémoire et confirmez l'état affiché par la Memory Console ; vérifiez que tout export ne contient que les données de votre compte.
Sécurité :
Supprimez uniquement la mémoire visée et n'incluez jamais de contenu privé dans un message adressé au support.
J'ai changé d'ordinateur ou d'assistant IA ; XMemo se souviendra-t-il toujours de moi ?
Symptôme
Mes anciennes mémoires semblent séparées des nouvelles après avoir changé d'appareil, redémarré un assistant ou changé d'hôte.
Cause
La nouvelle connexion de l'assistant peut identifier l'appareil ou l'assistant comme une nouvelle source, ou être connectée à un autre compte.
Action :
Reconnectez XMemo dans l'assistant que vous souhaitez utiliser, connectez-vous au même compte et conservez l'étiquette d'appareil de la connexion stable lorsque l'application propose cette option.
Vérification
Enregistrez un détail de test inventé, lancez une nouvelle conversation sur le même assistant et confirmez que le détail apparaît sans changer de compte.
Sécurité :
Vérifiez le compte avant d'enregistrer quoi que ce soit de personnel sur un ordinateur partagé.
Pourquoi mon assistant IA a-t-il enregistré la même chose deux fois ?
Symptôme
Je vois deux copies de ce qui semble être la même mémoire après une nouvelle tentative ou une reconnexion.
Cause
Le premier enregistrement a peut-être réussi même si l'assistant n'a pas affiché le résultat, de sorte que la répétition de la demande a créé une autre copie.
Action :
Ouvrez la Memory Console, comparez les deux entrées et ne supprimez que le doublon après avoir confirmé leurs dates et leur source.
Vérification
Demandez à l'assistant d'enregistrer une seule fois un nouveau détail de test clairement étiqueté et confirmez qu'une seule nouvelle entrée apparaît.
Sécurité :
Ne supprimez pas toutes les mémoires correspondantes avant d'avoir identifié la copie que vous souhaitez conserver.
Pourquoi mon assistant IA me donne-t-il trop ou pas assez de mon contexte passé ?
Symptôme
L'assistant mentionne des détails non pertinents, omet la décision dont j'ai besoin ou formule une réponse surchargée.
Cause
La demande couvre un sujet ou une période trop large, ou l'assistant essaie d'utiliser davantage de contexte enregistré que la conversation n'en nécessite.
Action :
Demandez un sujet, un projet ou une période plus restreints, et précisez à l'assistant quelle décision ou quel détail importe le plus.
Vérification
Comparez la réponse avec le sujet demandé et supprimez tout détail non pertinent de la conversation avant de continuer.
Sécurité :
Ne demandez pas à l'assistant de révéler des mémoires privées sans rapport simplement pour étoffer la conversation.
J'ai déconnecté XMemo ; comment m'assurer que l'ancien assistant ne peut plus l'utiliser ?
Symptôme
J'ai retiré la connexion d'un assistant, mais j'ignore s'il peut toujours accéder à mes mémoires.
Cause
Retirer une connexion de l'application peut ne pas annuler l'autorisation de connexion au niveau du compte.
Action :
Ouvrez les contrôles de sécurité ou d'applications connectées de votre compte XMemo, révoquez l'ancienne connexion d'assistant et reconnectez uniquement celle en laquelle vous avez confiance.
Vérification
Testez l'ancienne connexion uniquement si cela ne présente aucun risque, et confirmez qu'elle est refusée avant d'utiliser la nouvelle connexion.
Sécurité :
Révoquez uniquement la connexion que vous souhaitez retirer et ne partagez pas vos identifiants de connexion au compte.
Pourquoi mon assistant IA ne peut-il plus utiliser XMemo ?
Symptôme
XMemo était auparavant disponible dans mon assistant, mais ses actions de mémoire n'apparaissent plus ou l'assistant indique qu'il ne peut pas les utiliser.
Cause
L'assistant doit peut-être rafraîchir sa connexion XMemo, ou il est connecté à un autre compte.
Action :
Ouvrez les paramètres d'applications connectées de l'assistant, déconnectez et reconnectez XMemo, puis lancez une nouvelle conversation.
Vérification
Demandez à l'assistant d'indiquer si XMemo est connecté, puis effectuez une lecture sans danger avant d'enregistrer quoi que ce soit.
Sécurité :
Ne collez jamais d'identifiants secrets de compte ni de mémoires privées dans une conversation ou une demande d'assistance.
Quelle connexion XMemo dois-je utiliser dans mon assistant IA ?
Symptôme
J'ignore quelle page ou connexion XMemo doit figurer dans les paramètres de mon assistant.
Cause
La page de configuration guidée et la connexion de l'assistant ont des objectifs différents, et les configurations hébergées et auto-hébergées possèdent des limites distinctes.
Action :
Pour le service hébergé, commencez sur https://xmemo.dev/product/docs et suivez le lien de connexion indiqué pour votre assistant ; renseignez-vous auprès du Support si votre organisation vous a fourni une page de configuration distincte.
Vérification
Avant d'enregistrer un détail personnel, confirmez que la page utilise bien votre compte XMemo et le service hébergé prévu.
Sécurité :
N'utilisez pas d'adresses de développement local et ne collez pas d'identifiants privés dans une conversation publique.
Que dois-je faire si mon assistant IA ne parvient toujours pas à se connecter à XMemo ?
Symptôme
J'ai réessayé les étapes de connexion, mais l'assistant ne parvient toujours pas à utiliser XMemo.
Cause
Le problème peut venir de l'application de l'assistant, de mon compte ou d'une connexion obsolète que les instructions publiques ne peuvent pas inspecter.
Action :
Contactez le Support en indiquant le nom de l'assistant, l'heure approximative et une brève description de ce qui s'est produit ; n'incluez que des informations caviardées.
Vérification
Assurez-vous que le signalement peut être reproduit sans envoyer de mémoires privées ni de secrets de compte.
Sécurité :
N'envoyez jamais d'identifiants de connexion, de codes à usage unique, de cookies ou de texte de mémoire privée.

Pour les développeurs et intégrateurs

Réponses sur la connexion, les limites de compte, le client et l'exploitation pour les personnes intégrant XMemo.

OAuth a échoué ou la fenêtre de consentement ne se termine jamais.
Symptôme
Le client affiche une erreur 401, le navigateur OAuth ne s'ouvre pas ou le consentement revient au client sans établir de connexion utilisable.
Cause
L'autorisation hébergée est peut-être obsolète, la transmission au navigateur est bloquée ou le client utilise un ancien enregistrement de serveur.
Action :
Déconnectez-vous du serveur MCP XMemo dans l'application hôte, reconnectez l'URL hébergée MCP et approuvez à nouveau memory:read et memory:write.
Vérification
Reconnectez-vous jusqu'à ce que le client indique une autorisation active, puis lancez un rappel inoffensif avant d'écrire de la mémoire.
Sécurité :
Ne basculez pas vers XMEMO_KEY dans les clients OAuth simplement pour contourner une session OAuth obsolète.
La requête renvoie 403 Forbidden.
Symptôme
Le serveur est joignable et l'identifiant est reconnu, mais le projet, l'outil ou l'action de mémoire demandés sont refusés.
Cause
L'autorisation ne dispose pas du périmètre requis, le compte se situe en dehors de la limite du projet sélectionné ou la ressource appartient à un autre locataire.
Action :
Vérifiez le compte et le projet sélectionnés, reconnectez OAuth ou demandez le périmètre souhaité, puis réessayez la même opération sans modifier la ressource.
Vérification
Confirmez qu'une requête en lecture seule dans le projet prévu réussit avant de réitérer une opération d'écriture ou de suppression.
Sécurité :
N'élargissez pas les périmètres et ne copiez pas le jeton d'un autre utilisateur pour faire disparaître une erreur 403.
Le serveur MCP se connecte mais aucun outil n'apparaît.
Symptôme
L'hôte indique un serveur connecté, mais tools/list est vide ou les outils XMemo manquent dans le sélecteur d'outils du modèle.
Cause
Le client n'a pas actualisé la découverte, utilise le mauvais profil MCP ou est connecté à une URL ou un enregistrement obsolètes.
Action :
Reconnectez le serveur, vérifiez que le client utilise le profil MCP pris en charge et relancez la découverte d'outils avant de modifier les identifiants.
Vérification
Confirmez qu'au moins remember, recall et search_memory apparaissent avant de débuter une écriture ou une démonstration pour une marketplace.
Sécurité :
Ne collez pas de jetons porteurs dans des captures d'écran, des tickets d'assistance ou des notes d'évaluation de marketplace.
Un client direct MCP signale que le jeton est manquant.
Symptôme
Un client direct indique que XMEMO_KEY n'est pas défini, est vide ou indisponible alors même que la variable a été ajoutée sur la machine.
Cause
Le processus du client n'a pas hérité de l'environnement, la variable a été ajoutée dans un autre shell ou la configuration attend plutôt une référence à un magasin de secrets.
Action :
Définissez XMEMO_KEY dans l'environnement local ou le magasin de secrets, redémarrez le client et maintenez XMEMO_AGENT_INSTANCE_ID stable lorsque l'attribution importe.
Vérification
Inspectez uniquement les métadonnées de présence de la variable, redémarrez le client et confirmez un rappel authentifié sans danger ; n'imprimez jamais la valeur du jeton.
Sécurité :
Conservez le vrai jeton hors des fichiers de configuration validés dans git ; les exemples publics doivent référencer uniquement des variables d'environnement.
L'ID d'instance d'agent change après chaque redémarrage.
Symptôme
Le même exécuteur local apparaît sous la forme de plusieurs agents ou les rappels sont scindés entre instances après un redémarrage ou un redéploiement.
Cause
XMEMO_AGENT_INSTANCE_ID est généré au lancement du processus au lieu d'être conservé dans le secret local ou la configuration d'environnement de l'exécuteur.
Action :
Générez une étiquette d'instance non secrète par exécuteur, conservez-la en dehors de git et transmettez-la avec chaque connexion MCP directe.
Vérification
Redémarrez l'exécuteur à deux reprises et confirmez que la même étiquette d'instance apparaît dans l'attribution de source sans exposer d'identifiants.
Sécurité :
L'étiquette d'instance est une métadonnée d'attribution, pas un identifiant d'autorisation ; les limites de compte et de jeton contrôlent toujours l'accès.
Le rappel renvoie une mémoire vide.
Symptôme
Un rappel ou une recherche réussit mais ne renvoie aucun enregistrement pertinent après que l'utilisateur a enregistré du contexte.
Cause
La lecture utilise un compte, un projet, un périmètre, une limite d'agent ou un type de mémoire différents de l'écriture, ou l'enregistrement de test n'a jamais été validé.
Action :
Créez une mémoire de test synthétique, vérifiez le chemin et le type de mémoire dans la Memory Console, puis réessayez le rappel depuis la même limite de compte ou de locataire.
Vérification
Relisez l'enregistrement synthétique nouvellement créé avec le même projet et périmètre, puis supprimez-le via la procédure de suppression prévue.
Sécurité :
Utilisez des données d'évaluation synthétiques ; n'utilisez pas la mémoire privée de clients pour une démonstration de marketplace.
Le rappel ou l'écriture utilise le mauvais périmètre de projet.
Symptôme
Un enregistrement est visible dans un projet mais pas dans un autre, ou une écriture apparaît sous un projet que l'opérateur ne prévoyait pas d'utiliser.
Cause
Le client a réutilisé un identifiant de projet provenant d'un autre environnement, a omis la limite de projet ou a conservé une session de compte obsolète.
Action :
Sélectionnez explicitement le compte et le projet souhaités, actualisez le contexte du client et répétez l'opération avec un enregistrement synthétique.
Vérification
Confirmez le projet et l'attribution de source de l'enregistrement dans la Memory Console, puis vérifiez qu'un projet non lié ne peut pas le lire.
Sécurité :
Ne résolvez jamais un décalage de périmètre en accordant un jeton plus large ou en copiant des données entre projets.
La même mémoire est enregistrée deux fois.
Symptôme
Une nouvelle tentative ou une reconnexion génère des enregistrements en double au lieu d'une mémoire durable unique.
Cause
Le client a réessayé après un délai d'attente sans limite d'idempotence, ou le flux de capture écrit avant d'avoir confirmé la première réponse.
Action :
Inspectez d'abord l'enregistrement existant et l'attribution de source, puis utilisez la politique de nouvelle tentative du client ou une clé d'idempotence stable avant d'écrire à nouveau.
Vérification
Répétez la même capture contrôlée une seule fois et confirmez un nouvel enregistrement plus une relecture, sans second nouvel enregistrement.
Sécurité :
Ne supprimez pas en bloc les mémoires correspondantes avant d'avoir confirmé l'enregistrement visé et le périmètre de compte.
Le contexte de rappel est trop volumineux ou trop restreint.
Symptôme
L'agent reçoit un contexte non pertinent, omet la décision nécessaire ou dépasse le budget de contexte utile de l'hôte.
Cause
La requête est trop vaste, le périmètre ou la fenêtre temporelle est manquant, ou l'appelant a demandé une limite de résultats inadaptée à la tâche.
Action :
Resserrez la requête avec des limites de projet, d'agent, de temps ou de sujet, et demandez un petit ensemble pertinent avant d'augmenter la limite.
Vérification
Comparez le contexte renvoyé avec la question cible et confirmez que chaque enregistrement inclus est autorisé et pertinent.
Sécurité :
N'élargissez pas le périmètre et n'exportez pas de mémoires non liées simplement pour remplir une fenêtre de contexte.
Comment supprimer ou exporter de la mémoire ?
Symptôme
L'opérateur doit retirer un enregistrement, confirmer une action d'oubli ou obtenir une exportation délimitée au compte.
Cause
La suppression, l'oubli réversible, la suppression définitive et l'exportation sont des flux distincts dotés de sémantiques de confirmation et de récupération différentes.
Action :
Utilisez d'abord la Memory Console ou les flux de gestion du compte ; si aucune procédure en libre-service n'est disponible, contactez le Support afin que la demande reste cantonnée au compte.
Vérification
Après l'oubli ou la suppression, recherchez par la référence de l'enregistrement et confirmez l'état réversible ou permanent attendu ; vérifiez que les exportations ne contiennent que le périmètre du compte.
Sécurité :
Les exports et archives d'assistance doivent exclure les hachages de jetons, les clés API, les secrets de session, les identifiants de fournisseurs et les données d'autres locataires.
Comment révoquer l'accès après la déconnexion d'un client ?
Symptôme
Un client a été retiré localement, mais l'opérateur doit invalider son autorisation OAuth ou son identifiant direct.
Cause
Déconnecter la configuration d'un client ne révoque pas nécessairement l'autorisation côté serveur ni ne fait tourner un jeton direct.
Action :
Ouvrez les contrôles de sécurité du compte ou des clients connectés, révoquez l'autorisation OAuth désignée et renouvelez l'identifiant direct si celui-ci a été exposé ou n'est plus fiable.
Vérification
Réessayez une lecture authentifiée avec l'ancienne connexion et confirmez qu'elle est rejetée, puis reconnectez uniquement via la voie de consentement ou de magasin de secrets prévue.
Sécurité :
Révoquez uniquement le client ou l'autorisation visés ; ne publiez pas d'anciens jetons, de codes OAuth ou de détails de session lors du diagnostic d'accès.
XMemo est-il en disponibilité générale (GA), certifié ou répertorié sur une marketplace ?
Symptôme
Une fiche ou un document demande si une configuration fonctionnelle prouve la disponibilité générale, une certification ou une approbation marketplace.
Cause
La prise en charge de configuration, la préparation OAuth, les preuves pilotes et l'approbation marketplace constituent des assertions distinctes.
Action :
Considérez les mentions publiques comme bêta ou prises en charge par configuration, sauf en présence d'un artefact d'approbation ou de certification marketplace spécifique.
Vérification
Vérifiez la matrice canonique des capacités des clients et l'artefact d'approbation mentionné avant de publier une affirmation de statut.
Sécurité :
Ne revendiquez pas un statut GA, certifié, stable ou répertorié sur la seule base d'une configuration fonctionnelle.
Quelle URL dois-je utiliser ?
Symptôme
Un utilisateur du service hébergé hésite entre le démarrage rapide public, le point de terminaison MCP ou les instructions pour développeurs auto-hébergés.
Cause
L'intégration hébergée et les parcours auto-hébergés ou hérités ont des URL, des identifiants et des limites de données différents.
Action :
Les utilisateurs du service hébergé doivent commencer par https://xmemo.dev/mcp pour les clients MCP et https://xmemo.dev/product/docs pour la configuration guidée.
Vérification
Confirmez que l'URL d'hôte, le mode d'authentification et la limite du compte correspondent au déploiement hébergé ou auto-hébergé prévu avant de vous connecter.
Sécurité :
N'utilisez pas les instructions relatives à localhost, Supabase, Docker ou Python auto-hébergé comme premier parcours pour les utilisateurs du service hébergé public.
La mémoire apparaît sous le mauvais agent ou appareil.
Symptôme
Une mémoire est attribuée à un autre exécuteur ou apparaît scindée entre appareils après une mise à jour ou un redémarrage du client.
Cause
Le client a modifié ses en-têtes non secrets d'agent ou d'instance, ou un identifiant partagé est utilisé par plusieurs exécuteurs.
Action :
Vérifiez les en-têtes non secrets d'agent/appareil ou le profil client, puis conservez l'ID d'instance local au lieu de le régénérer.
Vérification
Écrivez un enregistrement synthétique depuis l'exécuteur prévu et confirmez que son attribution de source reste stable après la reconnexion.
Sécurité :
Les étiquettes d'attribution aident à vérifier la source, mais ne constituent pas une limite de sécurité ; les identifiants du compte contrôlent toujours l'accès.
Je ne parviens toujours pas à me connecter après avoir suivi les étapes.
Symptôme
La connexion reste indisponible après avoir réessayé la procédure OAuth ou de secret direct propre au client.
Cause
Le problème persistant peut être propre au client, au compte, ou dû à un enregistrement obsolète ou à une limite d'environnement que la documentation locale ne peut inspecter.
Action :
Ouvrez une demande auprès du Support en précisant le nom du client, le chemin de configuration, l'horodatage approximatif et si le client utilise OAuth ou XMEMO_KEY.
Vérification
Confirmez que le rapport d'assistance contient un symptôme reproductible et des métadonnées caviardées, puis attendez le diagnostic restreint au compte.
Sécurité :
Partagez uniquement des diagnostics caviardés ; n'envoyez jamais de jetons porteurs, de codes OAuth, de cookies ou de contenu de mémoire client.

Source : FAQ / Dépannage