Mnemom Gateway
La Mnemom Gateway est une passerelle IA transparente qui s’interpose entre votre application et n’importe quel fournisseur LLM. Elle fournit la stack de confiance Mnemom complète dès le départ :- AP-Traces vérifiables
- Vérifications d’intégrité AIP en temps réel
- Application des politiques issues des sections
capabilitiesetenforcementde la carte d’alignement - Protection Safe House configurée via la carte de protection
- Vérification par rapport à la carte d’alignement de l’agent
S'authentifier
Connectez-vous à votre compte Mnemom :Cela ouvre un flux de connexion via navigateur et stocke votre token d’authentification dans
~/.mnemom/auth.json.Vos clés API fournisseur ne sont pas envoyées à Mnemom. Seuls les hachages SHA-256 sont utilisés pour identifier votre agent. Le hachage ne peut pas être inversé pour récupérer votre clé.
Effectuer un appel API
Utilisez l’URL de la passerelle à la place de l’URL directe du fournisseur. Incluez l’en-tête La passerelle prend en charge les trois fournisseurs à leurs chemins standard :
x-mnemom-agent pour nommer votre agent — il sera créé automatiquement au premier appel dans le Sandbox Mnemom sans propriétaire. Avant que les commandes de lecture (mnemom status, logs, integrity, card show) puissent le résoudre, vous devez revendiquer l’agent sur votre compte (étape suivante). Utilisez -i pour afficher les en-têtes de réponse afin de capturer l’id X-Mnemom-Agent nécessaire pour la revendication.| Fournisseur | Chemin Gateway | Équivalent Direct |
|---|---|---|
| Anthropic | gateway.mnemom.ai/anthropic/* | api.anthropic.com/* |
| OpenAI | gateway.mnemom.ai/openai/* | api.openai.com/* |
| Gemini | gateway.mnemom.ai/gemini/* | generativelanguage.googleapis.com/* |
Ce qu'il faut lire au retour
La passerelle ajoute des en-têtes de réponse qui portent le verdict Safe House, les métadonnées de corrélation du support et les entrées d’avis. Une intégration conforme doit les analyser et les observer — au minimum les exposer en cas de problème.
Analyse rapide :Consultez la référence des en-têtes pour l’ensemble canonique complet + les parseurs par langage, et la référence des erreurs pour le mapping verdict-vers-statut (quand
| En-tête | Quand émis | Que faire |
|---|---|---|
X-Mnemom-Request-Id | Toujours | UUIDv4 par requête. Toujours journaliser. Collez-le dans un ticket de support et nous pouvons récupérer chaque ligne de log pour la requête. |
X-Mnemom-Verdict | Toujours (gateway) | Structuré front=…; autonomy=…; integrity=…; back=… avec chaque valeur dans {pass | observed | nudged | enforced}. Analysez-le ; l’état à quatre points de contrôle indique ce que Safe House a observé (front+back), ce que CLPI a fait sur les appels d’outils (autonomy), et ce que AIP a fait sur le raisonnement (integrity). |
X-Mnemom-Advisory | Quand la gateway a des avis | JSON compact [{source, text, severity?, id?}, …]. Exposez les entrées dans votre UI opérateur / logs. Omis entièrement quand vide. |
X-Mnemom-Agent | Quand la requête est liée à un agent nommé | L’identifiant d’agent que la gateway a résolu pour votre requête (ex. mnm-a1b2c3d4…). Utile pour le recoupement des lignes du tableau de bord. |
X-Mnemom-Session | Sur les sessions multi-tours | Token de corrélation de session stable. Renvoyez-le au tour suivant pour maintenir la continuité de session. |
Retry-After | Sur 429 et certains 503 | Secondes à attendre avant de réessayer. Respectez-le. |
enforced devient une quarantaine 422 ou un blocage 403).Revendiquer votre agent
La passerelle a créé votre agent dans le Sandbox Mnemom partagé (sans propriétaire). Le revendiquer prouve que vous détenez la clé fournisseur et le déplace dans votre compte afin que toutes les commandes de lecture puissent le résoudre.Copiez la valeur Remplacez
X-Mnemom-Agent des en-têtes de réponse ci-dessus, puis exécutez :mnm-550e8400-e29b-41d4-a716-446655440000 par l’id réel de votre en-tête X-Mnemom-Agent.- Passez
--namecorrespondant à la valeurx-mnemom-agentenvoyée lors de l’appel à la gateway (omettez--namesi vous avez fait cet appel sans l’en-tête). Si l’id,--nameou--keyne correspondent pas à un agent réel, la revendication retourne404— vérifiez l’idX-Mnemom-Agentet que--name/--keycorrespondent à l’appel à la gateway. - La clé est hachée localement (SHA-256) et n’est jamais envoyée à Mnemom.
- L’agent atterrit dans votre organisation personnelle par défaut ; passez
--org <slug>pour revendiquer dans une organisation partagée. - L’opération est idempotente — peut être exécutée plusieurs fois sans risque.
Une réponse
503 signifie que votre organisation personnelle est encore en cours de provisionnement. Attendez quelques secondes et réessayez. Pour les erreurs 403 inter-locataires ou non-membre, consultez le guide du flux de revendication d’agent.Vérifier le statut
Vérifiez que la passerelle est accessible et que votre agent est connecté :
Sortie
Afficher les traces
Après avoir effectué des appels API via la passerelle, affichez ce qui a été tracé :Utilisez
Sortie
mnemom logs --agent my-agent -l 20 pour afficher plus d’entrées.Vérifier l'intégrité
Affichez les scores d’intégrité AIP pour l’activité récente de votre agent :
Sortie
Afficher votre carte d'alignement
Consultez la carte d’alignement assignée à votre agent :Personnalisez-la en publiant votre propre carte :
Explorer le tableau de bord
Les données de votre agent sont disponibles sur mnemom.ai/dashboard une fois connecté. Le tableau de bord affiche :
- Timeline de conscience — Une vue chronologique de chaque trace, point de contrôle d’intégrité et action d’application
- Carte d’alignement — Les valeurs et limites déclarées de votre agent
- Scores d’intégrité — Historique des verdicts AIP et analyse des tendances
- Alertes de dérive — Notifications quand le comportement diverge de l’alignement déclaré
- Journal d’application — Enregistrements des nudges et blocages (si l’application est activée)
Agents nommés
Si vous exécutez plusieurs agents derrière la même clé API, utilisez l’en-têtex-mnemom-agent pour donner à chacun une identité distincte. Le chemin du fournisseur reste inchangé — la passerelle dérive un ID d’agent unique par SHA256(apiKey + '|' + agentName). Consultez Identité d’agent pour la dérivation complète de l’ID, les chemins de création automatique vs enregistrement programmatique, et comment la rotation des clés interagit avec l’identité de l’agent.
Fournisseurs pris en charge
| Fournisseur | Modèles | Support Thinking / AIP | En-tête d’authentification |
|---|---|---|---|
| Anthropic | Claude Opus 4.7, Sonnet 4.6, Haiku 4.5 | Complet (blocs de réflexion analysés directement) | x-api-key |
| OpenAI | GPT-5.2, GPT-5.2 Pro, GPT-5 | Via résumés de raisonnement (confiance réduite) | Authorization: Bearer |
| Gemini | Gemini 2.5 Pro, Gemini 3 Pro | Complet (parties de réflexion analysées directement) | x-goog-api-key |
Compatibilité AIP
| Fournisseur / Modèle | Support AIP | Méthode |
|---|---|---|
| Modèles de raisonnement Anthropic (Opus, Sonnet) | Complet | Blocs de réflexion analysés directement |
| Série GPT-5 Thinking OpenAI | Partiel | Résumés de raisonnement (confiance réduite) |
| Gemini 2.5/3 avec thinking | Complet | Parties de réflexion analysées directement |
| Modèles sans raisonnement | Traçage uniquement | Verdict clear synthétique |
| OpenAI legacy (o3/o4-mini) | Non pris en charge | Raisonnement chiffré |
Éléments thinking dans les réponses proxiées. Safe House / AIP active le thinking étendu pour analyser le raisonnement de l’agent en temps réel. Les réponses proxiées incluent donc un élément de contenu
thinking dans le tableau content aux côtés du bloc text standard. Les clients qui supposent des tableaux de contenu texte uniquement doivent être mis à jour pour gérer ou ignorer les blocs thinking. Les tokens de sortie thinking sont facturés comme des tokens de sortie standard — ce comportement est intentionnel et ne peut pas être désactivé.Ce qui est tracé
La Mnemom Gateway construit des AP-Traces qui enregistrent :- Action — Ce que l’agent a fait (type, nom, catégorie)
- Décision — Quelles alternatives ont été envisagées et pourquoi l’une a été sélectionnée
- Escalade — Si l’agent a escaladé vers un humain et pourquoi
- Vérification — Si la trace est cohérente avec la carte d’alignement déclarée de l’agent
- Intégrité — Analyse AIP en temps réel des blocs de réflexion, avec verdict (
clear/review_needed/boundary_violation)
Ce qui N’est PAS stocké
Modes d’application
La Mnemom Gateway prend en charge trois modes d’application lorsqu’une violation d’intégrité est détectée :| Mode | Comportement |
|---|---|
observe | Détecte les violations, les enregistre, n’agit pas (par défaut) |
nudge | Détecte les violations, injecte un retour dans la prochaine requête de l’agent via le prompt système. L’agent le voit et peut s’auto-corriger. |
enforce | Blocage dur avec HTTP 403 pour les requêtes non-streaming. Bascule vers nudge pour le streaming. |
integrity_mode et autonomy_mode sont des champs de premier niveau sur la carte d’alignement ; le point de terminaison legacy /v1/agents/{id}/enforcement a été retiré le 2026-05-14.
Trois chemins, choisissez celui qui convient à votre flux de travail :
- Tableau de bord : ouvrez
https://mnemom.ai/dashboard/agents/{your-agent-id}/card, activezintegrity_mode, enregistrez. Le chemin le plus simple. - CLI :
mnemom card editouvre le YAML de la carte d’alignement courante dans$EDITOR; changezintegrity_mode: nudge, enregistrez, la CLI publie et recompose. - Programmatique :
PUT /v1/alignment/agent/{agent_id}avec la carte canonique complète. Consultez le guide de gestion des cartes pour le flux lecture-modification-écriture et le schéma de carte d’alignement pour les exigences de champs.
Prochaines étapes
- Voir la vue d’ensemble du protocole pour comprendre comment AAP, AIP et CLPI fonctionnent ensemble
- Configurer l’application des politiques pour définir des règles de gouvernance pour l’utilisation des outils de votre agent
- Explorer les concepts pour comprendre les cartes d’alignement, les traces et l’intégrité
- Vue d’ensemble CLPI pour comprendre la couche de gouvernance (application des politiques, récupération de la confiance, ancrage on-chain)
- En savoir plus sur l’application pour la documentation détaillée des modes d’application
- Auto-héberger si vous avez besoin d’un contrôle complet de résidence des données