Documentation de la Navin Platform
Voici la documentation de la Navin Platform : le portail, les guides du développeur, MCP, la sécurité et la gouvernance, l'architecture et les briques. Chaque page existe en français et en anglais avec la même structure ; la page d'accueil anglaise est ../en/README.md. La carte complète du site est ../index.md.
Par où commencer
- Démarrer : un premier agent sécurisé
- Guide d'utilisation du portail
- Guides du développeur
- Référence de l'API : API du Control Plane (
/api/control-planesur le site de documentation) et API du Navin Manager (/api/manager)
Guide d'utilisation du portail
Vue d'ensemble
- Vue d'ensemble (
/)
Administration
- Tenants (
/admin/tenants) - Projets et environnements (
/admin/projects) - Organisations et unités métier (
/admin/organizations) - Membres et rôles (
/admin/members) - Clés d'API (
/admin/api-keys) - Identités de service (
/admin/service-identities) - Groupes d'annuaire (
/admin/group-mappings) - Licence et support (
/admin/license)
Gestion des LLM
- Fournisseurs (
/llm/providers) - Registre des modèles (
/llm/models) - Routage et repli (
/llm/router) - Config LiteLLM (
/llm/litellm) - Projets LLM (
/llm/projects) - Clés LiteLLM (
/llm/keys) - Versions de modèles (
/llm/versions) - Mode d'isolation (
/llm/isolation) - Résolveur de capacités (
/llm/resolver) - Budget de contexte (
/llm/context) - Playground passerelle (
/llm/playground)
Agents
- Registre (
/agents/registry) - Exécutions (
/agents/runs) - Approbations (
/agents/approvals) - Planifications (
/agents/schedules) - Déclencheurs (
/agents/triggers) - Sessions (
/agents/sessions) - Applications (
/agents/applications)
Capacités
- Outils (
/capabilities/tools) - Serveurs MCP (
/capabilities/mcp) - Skills (
/capabilities/skills) - Plugins (
/capabilities/plugins) - Connecteurs (
/capabilities/connectors) - Canaux (
/capabilities/channels) - Livraisons webhook (
/capabilities/webhooks)
Marketplace
- Catalogue des packs (
/marketplace/catalog) - Installations (
/marketplace/installs) - Pipeline de changement (
/marketplace/changes)
Données et connaissances
- Bases de connaissances (
/data/knowledge) - Mémoire (
/data/memory) - Testeur DLP (
/data/dlp) - Rétention (
/data/retention) - Lignage (
/data/lineage) - Prompts (
/data/prompts) - Quarantaine RAG (
/data/quarantine) - Profils de stockage (
/data/storage)
Multimodal
- Médiathèque (
/multimodal/media) - Tâches (
/multimodal/jobs) - Voix en direct (
/multimodal/voice) - Consentements vocaux (
/multimodal/consents)
Qualité
- Suites d'évaluation (
/quality/suites) - Exécutions d'évaluation (
/quality/runs) - Portes qualité (
/quality/gates) - Red team (
/quality/redteam) - Comparaisons A/B (
/quality/comparisons)
Sécurité et gouvernance
- Posture de sécurité (
/security/posture) - Politiques (
/security/policies) - Journal des décisions (
/security/decisions) - Registre de gouvernance (
/security/governance) - Risque et conformité (
/security/risk) - Incidents (
/security/incidents) - Secrets (
/security/secrets) - Clés de chiffrement (
/security/encryption-keys) - SOC et AI-SDR (
/security/soc) - Kill Switch (
/security/kill-switch) - Délégations (
/security/delegations) - Permissions (ReBAC) (
/security/permissions) - Accès d'urgence (
/security/break-glass) - Simulateur de politiques (
/security/policy-simulator) - Sécurité des fichiers (
/security/file-security)
Observabilité
- SLO et budgets d'erreur (
/observability/slo) - Métriques en direct (
/observability/metrics) - Traces (
/observability/traces) - Journal des requêtes (
/observability/logs)
FinOps
- Synthèse (
/finops/summary) - Événements d'usage (
/finops/usage) - Grilles tarifaires (
/finops/price-cards) - Quotas (
/finops/quotas) - Allocation GPU (
/finops/gpu) - Rapprochement (
/finops/reconciliation) - Alertes (
/finops/alerts) - Réglages FinOps (
/finops/settings)
Audit
- Événements et chaîne (
/audit/events) - Corrélations (
/audit/correlations) - Preuves et scellés (
/audit/evidence) - Conservations légales (
/audit/legal-holds)
Portail développeur
- Kit développeur (
/developer/kit) - Contrats (
/developer/contracts) - Référence API (
/developer/api) - Démarrage SDK (
/developer/sdk) - Catalogue des briques (
/developer/bricks) - Feuille de route (
/developer/roadmap)
Studio développeur
- Studio de prompts (
/studio/prompts) - Studio de skills (
/studio/skills) - Studio MCP (
/studio/mcp) - Studio de connecteurs (
/studio/connectors) - Atelier de plugins (
/studio/plugins) - Studio de politiques (
/studio/policies) - Bibliothèque Navin (
/studio/navin-library)
Guides du développeur
- Premiers pas : un premier agent sécurisé
- Guide de développement d'agent
- Guide de développement MCP
- Héberger des serveurs MCP
- Runtime MCP par utilisateur et par projet
- Sécurité MCP
- Guide de développement de skill
- Guide de développement de plugin
- Guide de développement des packs : plugins, serveurs MCP, skills, prompts et connecteurs
- Guide de développement de connecteur
- Guide de développement de prompt
- Guide de développement de politiques
- Guide de tests
- Guide de migration
- Marketplace de packs complets
- Bibliothèque Navin : compétences, plugins, MCP, canaux et règles par projet
- Sécurité des fichiers : ClamAV et YARA-X avant toute ingestion
- Administration du stockage client (brique E-13)
- Portail développeur et documentation vivante
- Référence API (OpenAPI et exemples)
- Référence ExecutionContext
- Référence ActionContext
Sécurité et gouvernance
- Sécurité de la plateforme Enterprise AI
- Approbations et contrôle humain
- Audit Gateway et Evidence Service : modèle de sécurité
- Authentification et autorisation
- Configuration de sécurité
- Protection des données du RAG
- Pipeline de sécurité des fichiers : modèle de sécurité
- Gouvernance de la Navin Platform
- Durcir une installation de production
- Identité héritée de bout en bout : Context Authority, délégations, mandats, accès d'urgence
- Plan d'identité et de politiques : guide d'exploitation
- Matrice des injections et attaques
- Rétention, confidentialité et protection des données personnelles
- Risques, conformité et preuves
- Procédures d'incident de sécurité
- Secrets, clés de chiffrement et coffre-fort IT
- Runbook SOC, AI-SDR, Kill Switch et reprise
- Tests de sécurité
- Modèle de menaces
Architecture
- Enterprise AI Platform - Vue d'ensemble de l'architecture
- Architecture de la plateforme
- Modèle de données PostgreSQL
- Correspondance du monorepo cible avec le dépôt réel
Décisions d'architecture
- ADR-0101 : politique de licences de la distribution
- ADR-0102 : Runtime Navin sans graphe déclaré
- ADR-0103 : Rôles de vLLM et LiteLLM, LiteLLM épinglé en 1.106.5
- ADR-0104 : Format d'appel compatible OpenAI par défaut, appels par le Model Gateway
- ADR-0105 : Effort de raisonnement jamais converti en silence
- ADR-0106 : Tenancy plateforme, tenant, projet, environnement avec RLS forcée
- ADR-0107 : Règle FinOps des jetons et trois montants
- ADR-0108 : Opik au lieu de Langfuse
- ADR-0109 : Perses au lieu de Grafana, remplacée par l'ADR-0169
- ADR-0110 : OpenSearch au lieu de Loki
- ADR-0111 : SeaweedFS et stockage du client au lieu de MinIO
- ADR-0112 : OpenBao ou coffre du client (exception MPL-2.0)
- ADR-0113 : Redis comme cache seulement
- ADR-0114 : PostgreSQL source de vérité
- ADR-0115 : Context Authority et règle d'intersection des délégations
- ADR-0116 : Audit chaîné, scellés et outbox
- ADR-0117 : Registre Kill Switch, état souhaité et état observé sur reçus
- ADR-0118 : Licences signées sans prix ni limite
- ADR-0119 : Agent de nœud Go et opérateur Kubernetes testé par envtest
- ADR-0120 : Marketplace de packs signés
- ADR-0121 : Garde de sortie, seul chemin sortant
- ADR-0122 : Anglais et français partout
- ADR-0123 : Honnêteté des tests : PASSED seulement avec preuve
- ADR-0124 : SSH limité au bootstrap, exploitation par agents, opérateur et API
- ADR-0125 : Propriété des services (PLATFORM_MANAGED, CLIENT_MANAGED) et six modes de déploiement
- ADR-0126 : Haute disponibilité configurée n'est pas haute disponibilité validée
- ADR-0127 : Sauvegarde, restauration et PRA distincts de la HA, sur le stockage du client
- ADR-0128 : Console unique avec un espace Platform Manager, console Manager autonome conservée
- ADR-0148 : Pile frontend du portail (design system, graphiques, graphes, formulaires, client API)
- ADR-0149 : Routes serveur des interfaces SDK B9.3 (identité de service, audit applicatif, annulation d'approbation, objets de stockage)
- ADR-0150 : Moteur d'opérations interne du Platform Manager à la place de Temporal
- ADR-0151 : Matrice de compatibilité tenue par le catalogue signé, pas par une table compatibility_matrix
- ADR-0154 : Index d'audit partitionné par event_time et vue aux noms de la référence
- ADR-0155 : Plans du worker, operation_id des opérations longues et compensation des actions externes
- ADR-0156 : Hiérarchie du tenant, champs communs stampés par PostgreSQL et identifiant runtime séparé
- ADR-0157 : Résumé borné des spans dans PostgreSQL et objectifs SLO en base
- ADR-0158 : Provenance SLSA, portes G6/G9, contenus de pack, kill switch et import hors ligne de la marketplace
- ADR-0159 : Pipeline unique de gestion du changement
- ADR-0162 : Sauvegarde et PRA, centre de configuration et liens profonds dans l'espace Platform Manager du portail
- ADR-0163 : Test dédié par écran du portail et atelier de plugins par manifeste
- ADR-0164 : Bibliothèque Navin activée par projet, règles de projet, MCP et canaux rattachés au projet
- ADR-0165 : Hébergement des serveurs MCP dans le Navin Manager et isolation par projet de la passerelle MCP
- ADR-0166 : Haute disponibilité déclarée par service dans le catalogue du Navin Manager, analyse obligatoire des fichiers par ClamAV et YARA-X avant toute ingestion
- ADR-0167 : Runtime MCP isolé par tenant, projet et utilisateur sur le ToolHive Kubernetes Operator
- ADR-0168 : Deux moteurs d'inférence locale gérés, vLLM et Ollama, derrière LiteLLM
- ADR-0169 : Retrait de Perses et d'Infisical OSS : tableaux de bord dans le Navin Manager et le portail, secrets dans OpenBao ou le coffre du client
- ADR-0170 : MCP internes uniquement, catalogue MCP de l'entreprise dans SeaweedFS, destruction dès la panne, réveil à l'appel et traçabilité par défaut
- ADR-0171 : Durcissement de l'installation pour la production bancaire : réseau isolé, Quadlet, profils de sécurité, Trusted Hub, retour arrière
- ADR-0172 : Labellisation des données et affinage des modèles : Label Studio et LLaMA-Factory dans le catalogue
État de l'implémentation et preuves
- Architecture
- Conformité à l'architecture produit
- Blocages
- Catalogue des composants gérés (ManagedComponent)
- Décisions
- Reprise du projet
- Rapport de licences des dépendances (SBOM SPDX)
- Préparation de la livraison
- Exigences de la plateforme
- Feuille de route des lots
- État d'avancement de la plateforme
- Preuves de test
- Fichiers d'audit des lots de vérification du kit
- Fichiers de lot de conformité
Briques
- Briques de la plateforme
- A01 - Portail central
- A02 - Control Plane API
- A03 - Identité humaine
- A04 - Identité machine
- A05 - Autorisations
- A06 - Policy Engine
- A07 - Policy Enforcement
- A08 - Secrets et chiffrement transit
- A09 - Certificats
- A10 - Gestion multi-tenant
- A11 - Registre de gouvernance
- A12 - Workflow d'approbation
- A13 - Risque et conformité
- A14 - Gestion des incidents
- B01 - Proxy LLM unifié
- B02 - Inférence locale
- B03 - Registre des providers
- B04 - Registre des modèles
- B05 - Routeur de modèles
- Matrice des modalités des modèles (B-06)
- B06 - Résolveur de capacités
- B07 - Politique d'effort de raisonnement
- B08 - Gestionnaire de fenêtre de contexte
- B09 - Comptabilité des tokens
- B10 - Registre des prix des modèles
- B11 - Rapprochement des coûts
- B12 - Évaluation des modèles
- B13 - Gestion des GPU locaux
- B14 - Bascule des providers
- C-01 Runtime d'agents
- C-02 Exécution durable
- C-03 Contrôleur de boucle d'agent
- C-04 Gestionnaire de sous-agents
- C-05 Communication agent à agent
- C-06 Gestionnaire de checkpoints
- C-07 Gestionnaire de sessions
- C-08 Moniteur de heartbeat
- C-09 Planificateur
- C-10 Déclencheurs d'événements
- C-11 Humain dans la boucle
- C-12 Bac à sable d'exécution
- C-13 Limites de ressources
- C-14 Kill switch d'agent
- C-15 Rejeu d'exécution
- D-01 Registre d'outils
- D-02 Passerelle d'outils
- D-03 Registre MCP
- D-04 Passerelle MCP
- D-05 Registre de skills
- D-06 Chargeur de skills
- D-07 Registre de plugins
- D-08 Runtime de plugins
- D-09 Registre de connecteurs
- D-10 Hub de connecteurs
- D-11 Courtier de credentials
- D-12 Passerelle de webhooks
- D-13 Passerelle de canaux
- D-14 Passerelle API
- E-01 Classification des données
- E-02 Passerelle DLP
- E-03 Service de tokenisation
- E-04 Service de chiffrement
- E-05 Traitement de documents
- E-06 Pipelines RAG
- E-07 Base vectorielle
- E-08 Stockage relationnel
- E-09 Gestionnaire de contexte
- E-10 Gestionnaire de mémoire
- E-11 Lignage des données
- E-12 Rétention des données
- E-13 Stockage objet
- F-01 Vision
- F-02 Génération et édition d'images
- F-03 Traitement vidéo
- F-04 Génération vidéo
- F-05 Reconnaissance vocale (STT)
- F-06 Diarisation des locuteurs
- F-07 Synthèse vocale (TTS)
- F-08 Voix temps réel (duplex)
- F-09 Détection d'activité vocale (VAD)
- F-10 Streaming audio
- F-11 DLP multimodale
- F-12 Stockage et traitement des médias
- G-01 Traçage distribué
- G-02 Pipeline de télémétrie
- G-03 Traçage IA (prompts, réponses, outils, scores)
- G-04 Entrepôt analytique
- G-05 Métriques
- G-06 Journaux
- G-07 Tableaux de bord
- G-08 Alertes
- G-09 Évaluation
- G-10 Red teaming
- G-11 Preuves d'audit (WORM)
- G-12 Surveillance de sécurité
- G-13 Orchestrateur qualité
- G-14 Corrélation d'audit
- H-01 Service de quotas
- H-02 Registre des coûts
- H-03 Moteur de tarification
- H-04 Comptabilité GPU
- H-05 Mise à l'échelle automatique
- H-06 Plateforme Kubernetes
- H-07 Réseau
- H-08 GitOps
- H-09 Infrastructure as code
- H-10 Admission par politiques
- H-11 Analyse des images
- H-12 SBOM
- H-13 Signature
- H-14 Sauvegarde et reprise après sinistre
- H-15 CI/CD
- H-16 Registre d'artefacts
- Applications gouvernées et agents tiers
Installation
- Installer la Navin Platform sur un site déconnecté
- Lancer la Navin Platform avec Docker Compose
- Configurer la Navin Platform pour la première fois
- Topologies d'hébergement
- Installer la Navin Platform
- Installer la Navin Platform sur Kubernetes avec Helm
- Lancer la Navin Platform en développement local avec make
- Ports et flux réseau
- Installer la Navin Platform à partir des paquets OS
- Dimensionnement et matériel
- Configurer les certificats TLS
- Désinstaller la Navin Platform
- Mettre à niveau la Navin Platform
- Vérifier l'installation
Référence
- Référence de configuration du Control Plane
- Référence des valeurs Helm
- Référence de compatibilité OS
SDK, API, exploitation et versions
- Enterprise AI Platform SDKs
- Control Plane API v1 - contract shared by backend, portal, SDKs, CLI
- Contrats API principaux de l'architecture / Main API contracts of the architecture
- Exploitation - Enterprise AI Platform
- Notes de version Enterprise AI 1.0.0