> ## Documentation Index > Fetch the complete documentation index at: https://docs.mnemom.ai/llms.txt > Use this file to discover all available pages before exploring further. # Démarrage rapide Mnemom Gateway > Gouvernance complète des agents — vérification, analyse d'intégrité et application des politiques — en 5 minutes sans modification de code # 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](/concepts/ap-traces) vérifiables * Vérifications d'intégrité [AIP](/concepts/integrity-checkpoints) à chaque tour * Application des politiques issues des sections `capabilities` et `enforcement` de la carte d'alignement * Protection [Safe House](/concepts/safe-house) configurée via la [carte de protection](/concepts/protection-card) * Vérification par rapport à la [carte d'alignement](/concepts/agent-cards) de l'agent Vos prompts et réponses passent inchangés. Vos clés API ne quittent jamais votre machine. Ces démarrages rapides sont disponibles en [espagnol (Español)](/es/quickstart/overview) et en [français (Français)](/fr/quickstart/overview) — six pages par langue ont été traduites. Vous cherchez à lancer un **agent de codage gouverné** plutôt que de câbler les appels API de votre propre application ? Voir [`mnemom agent`](/gateway/agent) — installez-le une fois, exécutez `mnemom agent`, et il lance Claude Code à travers la gateway avec un agent déjà configuré pour vous. `mnemom agent` est disponible sur invitation uniquement. ```bash theme={null} npm install -g @mnemom/mnemom ``` Connectez-vous à votre compte Mnemom : ```bash theme={null} mnemom login ``` Cela ouvre un flux de connexion via navigateur et stocke votre token d'authentification dans `~/.mnemom/auth.json`. Sur une machine sans navigateur local (SSH, un conteneur), utilisez plutôt `mnemom login --no-browser` — voir la [référence CLI](/gateway/cli#authentication). 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é. 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. ```bash theme={null} # Instead of 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"}] }' ``` Le même appel vers OpenAI utilise le chemin `/openai` et l'en-tête `Authorization: Bearer` : ```bash theme={null} # Instead of https://api.openai.com/v1/chat/completions curl -i https://gateway.mnemom.ai/openai/v1/chat/completions \ -H "Authorization: Bearer $OPENAI_API_KEY" \ -H "x-mnemom-agent: my-agent" \ -H "content-type: application/json" \ -d '{ "model": "gpt-5", "messages": [{"role": "user", "content": "Hello"}] }' ``` Et vers Gemini, le chemin `/gemini` avec l'en-tête `x-goog-api-key` : ```bash theme={null} # Instead of https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash:generateContent curl -i https://gateway.mnemom.ai/gemini/v1beta/models/gemini-2.5-flash:generateContent \ -H "x-goog-api-key: $GEMINI_API_KEY" \ -H "x-mnemom-agent: my-agent" \ -H "content-type: application/json" \ -d '{ "contents": [{"parts": [{"text": "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. La passerelle ajoute des en-têtes de réponse qui portent le verdict Safe House, des métadonnées de corrélation pour le support, et des entrées d'avis. Une intégration conforme doit analyser et observer ces en-têtes — au minimum les exposer en cas de problème. | En-tête | Quand il est émis | Que faire | | - | - | - | | `X-Mnemom-Request-Id` | Toujours | UUIDv4 par requête. **Journalisez-le toujours.** 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), sauf sur une longue réponse non-streaming validée de manière anticipée (voir la note ci-dessous) | 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). `front` est un cumul sur chaque surface entrante que la requête a portée — le message *et* chaque résultat d'outil filtré dans cette même requête — donc `front=enforced` sur un `200` signifie qu'un résultat d'outil a été retenu ou décoré avant que le modèle ne le voie. Voir [Quand la porte d'entrée s'active](/concepts/safe-house#when-the-front-door-runs). `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 (par 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.** | | `X-Mnemom-Effective-Mode` | Uniquement quand un tour s'est exécuté dans un autre mode que celui configuré | Aujourd'hui une seule valeur : `passthrough; reason=balance_depleted; configured=enforce` — le solde µ d'un agent en `enforce` était épuisé, donc le tour a été transmis sans les contrôles Trust OS. Le `X-AIP-Verdict: clear` / `integrity=pass` d'une telle réponse ne signifie **pas** que le tour a été contrôlé. Rechargez votre solde pour rétablir l'application. | | `X-Mnemom-Deferred` | Sur une longue réponse non-streaming que la gateway a validée de manière anticipée | Voir la note ci-dessous. | Une requête non-streaming vers `/anthropic/v1/messages`, `/openai/v1/chat/completions` ou `/openai/v1/responses` encore en cours après environ 75 secondes est validée de manière anticipée : la gateway envoie un `200` dont le corps commence par des octets de maintien (retours à la ligne), puis le JSON final (les espaces en tête sont du JSON valide, les clients JSON l'analysent donc sans changement). Sur une telle réponse, `X-AIP-Verdict` vaut `pending`, `X-Mnemom-Verdict` et `X-Policy-Verdict` sont **absents** (n'interprétez jamais leur absence comme un succès), et `X-Mnemom-Deferred` indique ce que les en-têtes anticipés n'ont pas pu porter. Une erreur après la validation ferme la connexion en cours de corps — une erreur de transport que votre SDK peut réessayer — plutôt qu'un corps d'erreur dans le `200`. Analyse rapide : ```typescript theme={null} 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') { // Same-turn AIP replacement happened — surface that in your UI. } if (checkpoints.integrity === 'unverified') { // Analyzer failed — no trustworthy verdict. In enforce this response // was already withheld/replaced; in observe/nudge it was forwarded. } ``` Consultez la [référence des en-têtes](/api-reference/headers) pour l'ensemble canonique complet + les parseurs par langage, et la [référence des erreurs](/api-reference/errors) pour le mapping verdict-vers-statut. 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 : ```bash theme={null} mnemom agent 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 active (définie avec `mnemom org use `), ou dans votre organisation personnelle si vous n'en avez pas défini ; passez `--org ` pour revendiquer dans une organisation partagée spécifique. * 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](/guides/agent-claim-flow). Vérifiez que la passerelle est accessible et que votre agent est connecté : ```bash theme={null} mnemom status --agent my-agent ``` Cela affiche une checklist d'authentification / passerelle / connectivité API, puis l'ID de votre agent, l'URL de la passerelle et un lien vers le tableau de bord, suivis d'un résumé des traces une fois que l'agent a du trafic. Après avoir effectué des appels API via la passerelle, affichez ce qui a été tracé : ```bash theme={null} mnemom logs --agent my-agent ``` Chaque trace s'affiche comme son propre bloc — horodatage, action, type et (si présent) l'extrait de raisonnement et toute violation de politique. Utilisez `mnemom logs --agent my-agent --limit 20` pour afficher plus d'entrées. Affichez l'activité comportementale AAP de votre agent — nombre total de traces, combien ont été vérifiées comme propres, et les éventuelles violations : ```bash theme={null} mnemom activity --agent my-agent ``` ```text Output theme={null} Agent Activity (AAP) Score: 94.0% [█████████░] Total: 12 traces Verified: 11 Violations: 1 ``` `mnemom integrity` est un alias déprécié pour cette même commande — `mnemom activity` est le nom actuel. Malgré son nom, ceci expose la vérification des traces AAP, pas les [points de contrôle d'intégrité](/concepts/integrity-checkpoints) AIP par tour ; les données de point de contrôle AIP ne sont pas encore exposées via la CLI. Consultez la carte d'alignement assignée à votre agent : ```bash theme={null} mnemom card show --agent my-agent ``` Personnalisez-la en publiant votre propre carte : ```bash theme={null} mnemom card publish my-card.yaml --agent my-agent ``` Les données de votre agent sont disponibles sur [mnemom.ai/dashboard](https://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 hache `SHA256(apiKey + '|' + agentName)` pour dériver un ID d'agent unique. Consultez [Identité d'agent](/concepts/agent-identity) 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. ```bash theme={null} 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-les 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](/api-reference/endpoint/post-agents) 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 Fable 5.1, Claude Fable 5, Claude Opus 5.5, Claude Opus 5, Claude Sonnet 5.5, Claude Sonnet 5, Claude Opus 4.8, Claude Opus 4.7, Claude Sonnet 4.6, Claude Haiku 4.5 | Complet (blocs de réflexion analysés directement) | `x-api-key` | | OpenAI | GPT-6.1 Sol, GPT-6 Astra, GPT-5.6 Sol, GPT-5.6 Terra, GPT-5.6 Luna, GPT-5, GPT-5 Codex, o3, o3-mini | Non disponible via la gateway pour l'instant | `Authorization: Bearer` | | Gemini | Gemini 3.8 Flash, Gemini 3.5 Flash-Lite, Gemini 2.5 Pro, Gemini 2.5 Flash | 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, Fable) | Complet | Blocs de réflexion analysés directement | | 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, aucun appel au LLM d'analyse | | OpenAI (tous les modèles, y compris la série o) | Non disponible | La porte `/openai` de la gateway proxifie Chat Completions, qui ne renvoie jamais de contenu de raisonnement — voir [Provider Support](/concepts/provider-support#2-openai--no-thinking-trace-inspection-through-the-gateway-today) pour la divulgation complète | **É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](https://github.com/mnemom/aap) 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` | Bloque dans le même tour pour les requêtes streaming comme non-streaming. La requête se termine toujours avec un statut `2xx` — le corps de la réponse est remplacé par un message d'intervention en voix d'agent et `X-Mnemom-Verdict` rapporte `integrity=enforced`. 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}`](/api-reference/endpoint/put-agents-agent-id-alignment-card) avec la carte canonique complète. Consultez le [guide de gestion des cartes](/guides/card-management) pour le flux lecture-modification-écriture et le [schéma de carte d'alignement](/specifications/alignment-card-schema) pour les exigences de champs. ## Prochaines étapes * [Voir la vue d'ensemble du protocole](/protocols/overview) pour comprendre comment AAP, AIP et CLPI fonctionnent ensemble * [Configurer l'application des politiques](/guides/policy-management) pour définir des règles de gouvernance pour l'utilisation des outils de votre agent * [Explorer les concepts](/concepts/alignment-cards) pour comprendre les cartes d'alignement, les traces et l'intégrité * [Vue d'ensemble CLPI](/concepts/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](/gateway/enforcement) pour la documentation détaillée des modes d'application * [Auto-héberger](/fr/quickstart/self-hosted) si vous avez besoin d'un contrôle complet de résidence des données This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.