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 à chaque tour
Application des politiques issues des sections capabilities et enforcement de 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

Vos prompts et réponses passent inchangés. Vos clés API ne quittent jamais votre machine.

Installer la CLI

npm install -g @mnemom/mnemom

S'authentifier

Connectez-vous à votre compte Mnemom :

mnemom login

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 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.

# Au lieu de https://api.anthropic.com/v1/messages
curl -i https://gateway.mnemom.ai/anthropic/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "x-mnemom-agent: my-agent" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

La passerelle prend en charge les trois fournisseurs à leurs chemins standard :

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/*`

La plupart des SDK et frameworks vous permettent de remplacer l’URL de base. Définissez-la sur le chemin de la passerelle pour votre fournisseur et tout le reste fonctionne sans modification.

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.

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 \| unverified}`. 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). `unverified` est propre à integrity : l’analyseur a échoué, donc aucun verdict fiable n’existe — `enforce` retient la réponse (fail-closed, toujours 2xx), `observe`/`nudge` la transmettent et enregistrent l’état unverified. Jamais rapporté comme `pass`.
`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.

Analyse rapide :

const v = response.headers.get('X-Mnemom-Verdict')!;
const checkpoints = Object.fromEntries(v.split(';').map(s => s.trim().split('=')));
// checkpoints.front, checkpoints.autonomy, checkpoints.integrity, checkpoints.back

if (checkpoints.integrity === 'enforced') {
  // Un remplacement AIP du même tour s'est produit — exposez-le dans votre UI.
}
if (checkpoints.integrity === 'unverified') {
  // L'analyseur a échoué — aucun verdict fiable. En enforce, cette
  // réponse a déjà été retenue/remplacée ; en observe/nudge, elle a été transmise.
}

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 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 X-Mnemom-Agent des en-têtes de réponse ci-dessus, puis exécutez :

mnemom agents claim mnm-550e8400-e29b-41d4-a716-446655440000 --name my-agent --key $ANTHROPIC_API_KEY

Remplacez mnm-550e8400-e29b-41d4-a716-446655440000 par l’id réel de votre en-tête X-Mnemom-Agent.

Passez --name correspondant à la valeur x-mnemom-agent envoyée lors de l’appel à la gateway (omettez --name si vous avez fait cet appel sans l’en-tête). Si l’id, --name ou --key ne correspondent pas à un agent réel, la revendication retourne 404 — vérifiez l’id X-Mnemom-Agent et que --name/--key correspondent à 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é :

mnemom status --agent my-agent

Sortie

Agent:    my-agent (mnm-550e8400-e29b-41d4-a716-446655440000)
Gateway:  https://gateway.mnemom.ai (healthy)
Status:   Connected
Providers: anthropic, openai
Last seen: just now

Afficher les traces

Après avoir effectué des appels API via la passerelle, affichez ce qui a été tracé :

mnemom logs --agent my-agent

Sortie

2026-02-17T10:30:00Z  tr-abc123  recommend  bounded   verified  0.82
2026-02-17T10:30:05Z  tr-abc124  search     bounded   verified  0.76
2026-02-17T10:30:12Z  tr-abc125  respond    bounded   verified  0.91

Utilisez 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 :

mnemom integrity --agent my-agent

Sortie

Agent: mnm-550e8400-e29b-41d4-a716-446655440000
Checkpoints: 12
Verdicts:
  clear: 11
  review_needed: 1
  boundary_violation: 0
Integrity score: 0.94
Drift: none detected

Afficher votre carte d'alignement

Consultez la carte d’alignement assignée à votre agent :

mnemom card show --agent my-agent

Personnalisez-la en publiant votre propre carte :

mnemom card publish my-card.yaml --agent my-agent

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ête x-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.

curl https://gateway.mnemom.ai/anthropic/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "x-mnemom-agent: my-coder" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Chaque agent nommé obtient son propre historique de traces, scores d’intégrité et détection de dérive — même s’ils partagent une clé API. Les agents sont créés automatiquement au premier appel API ; revendiquez une fois (voir l’étape de revendication ci-dessus) pour lier l’agent à votre compte.

Vous pouvez également créer des agents de manière programmatique via l’API CRUD Agent si vous souhaitez les pré-créer avec des métadonnées avant leur première requête.

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 à chaque tour. 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 à chaque tour des blocs de réflexion, avec verdict (clear / review_needed / boundary_violation)

Ce qui N’est PAS stocké

Vos prompts, réponses et clés API ne sont jamais stockés par Mnemom. La passerelle traite les requêtes en mémoire et les transmet au fournisseur. Seules les métadonnées de trace structurées (actions, décisions, verdicts) et les résultats d’analyse des blocs de réflexion sont persistés.

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`	Applique le verdict dans le même tour pour les requêtes streaming comme non-streaming (HTTP 403 pour les requêtes non-streaming) ; en streaming, cela ajoute de la latence car la réponse est évaluée avant d’être délivrée.

Définissez le mode d’application en mettant à jour la carte d’alignement de l’agent. 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, activez integrity_mode, enregistrez. Le chemin le plus simple.
CLI : mnemom card edit ouvre le YAML de la carte d’alignement courante dans $EDITOR ; changez integrity_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

​Mnemom Gateway

​Agents nommés

​Fournisseurs pris en charge

​Compatibilité AIP

​Ce qui est tracé

​Ce qui N’est PAS stocké

​Modes d’application

​Prochaines étapes

Mnemom Gateway

Agents nommés

Fournisseurs pris en charge

Compatibilité AIP

Ce qui est tracé

Ce qui N’est PAS stocké

Modes d’application

Prochaines étapes