AI Factory

AI Factory · Manuel d’exploitation

Déployer, gouverner
et exploiter la Factory.

Partez d’un cas fictif ou préparez une installation privée. Suivez les accès, le travail des agents, les décisions humaines et la reprise après incident.

Vue d’ensemble

Dans Pilotage → Portefeuille et tâches, reliez un objectif de la Factory à ses projets, puis aux tâches de chaque BU. Le portefeuille suit l’échéance, la responsabilité, les dépendances et les preuves de travail.

  1. PlanifierLe chef de projet crée les tâches.
  2. AffecterLe manager attribue ou délègue.
  3. VérifierL’architecte valide le travail technique.
  4. DéciderLe Workbench enregistre la décision sensible.

GitHub Pages présente des cas fictifs. Compose et Kubernetes peuvent héberger une installation privée avec ses propres identités, données et services de modèles.

Explorer les schémas d’architecture et le plan 2D

Atlas visuel · 05 circuits

La Factory en cinq circuits

Des vues conceptuelles qui mènent à une démo ou à une procédure d’exploitation.

  1. Un poste de coordination relié à deux espaces de travail par un tracé lumineux.

    01 / Orchestration

    Du projet au sous‑agent

    Attribuez une tâche, autorisez son lancement selon la politique de la BU et vérifiez les preuves et les tokens remontés.

  2. Une salle de revue où le tracé de la demande aboutit à une table de décision.

    02 / Décisions

    Une décision humaine traçable

    Vérifiez le dossier et sa révision avec un approbateur indépendant, puis retrouvez le résultat dans le portefeuille.

  3. Trois zones de serveurs reliées par un chemin qui se divise.

    03 / Routage

    Tester les flux de modèles

    Simulez une route, une panne ou une contrainte de confidentialité. Comparez les destinations, les tokens et les coûts estimés.

  4. Une table d’analyse avec des groupes de blocs translucides et un écran de restitution.

    04 / Usages

    L’Observatoire des usages IA

    Explorez l’adoption par équipe, outil et période à partir de vues agrégées et soumises à un seuil de confidentialité.

  5. Un point de contrôle sépare les postes de travail d’une salle de serveurs.

    05 / Exploitation

    Protéger et restaurer

    Qualifiez les accès et les sorties réseau, puis répétez la reprise en vérifiant le journal de décisions restauré.

Premiers pas

Approbateur ou responsable de BU

Vérifiez la révision de la tâche et le périmètre du décideur.

Préparer une décision

Ingénieur plateforme ou exploitant

Choisissez le mode d’installation, configurez l’identité et planifiez la reprise.

Comparer les environnements

Essayer la démonstration publique
  1. Ouvrez la Factory puis Pilotage → Portefeuille et tâches.
  2. Dans le tableau des tâches, dépliez le résumé des tâches déléguées sous une tâche en cours.
  3. Comparez un relevé de tokens déclaré et une valeur inconnue. Les exemples illustrent l’interface.
  4. Ouvrez le Laboratoire de flux IA pour simuler une route de modèle et observer l’effet d’une panne ou d’une règle de sécurité.
Qualifier une installation privée en préproduction
  1. Préparez deux comptes de test distincts et des données synthétiques. Connectez-vous par le proxy SSO.
  2. Créez un objectif, un projet et une tâche parente en cours. Déléguez une sous-tâche courte à un agent activé, par exemple synthétiser trois faits fictifs.
  3. Vérifiez les états successifs, le résultat et les compteurs remontés. Pour une tâche technique, vérifiez le passage en revue.
  4. Soumettez une tâche sensible, rendez une décision dans le Compagnon avec le compte habilité, puis vérifiez le nouvel état dans le portefeuille.

Environnements et prérequis

GitHub Pages
Un navigateur suffit. Le tableau de bord, le Compagnon de démonstration et le Laboratoire de flux présentent des scénarios fictifs. Certaines préférences, idées et simulations restent dans le navigateur.
Compose en simulation
Un moteur Docker Linux, Docker Compose et un fichier d’environnement issu de .env.example. Le profil sim utilise des fournisseurs factices pour qualifier le démarrage et les flux de la pile.
Compose privé
Un moteur Docker dédié au même périmètre de confiance, des images vérifiées, un stockage persistant, TLS et OIDC, une politique BU, des secrets opérateur et des routes modèle qualifiées.
Kubernetes privé
Helm, un namespace dédié en mode restricted, un CNI qui applique les NetworkPolicy, un Ingress qui impose HTTPS, OIDC et une classe de stockage qualifiée. Le cœur et Alloy s’installent via le chart.

La CI utilise des identités et des données fictives. Elle valide notamment le redémarrage de PostgreSQL avec Compose et, sur Kind, la persistance de l’API après recréation d’un pod et restauration sur un second volume. Qualifiez vos contrôleurs, pilotes de stockage et services externes sur la cible.

Exécution CI de référence pour Compose et Kubernetes

Identités et périmètres

Sur Compose, configurez FACTORY_AUTH=sso, FACTORY_AUTH_MODE=proxy, FACTORY_TRUSTED_PROXIES, FACTORY_ROLE_MAP et FACTORY_BU_POLICY. Sur Kubernetes, le profil privé applique la frontière de confiance dans le pod et monte la politique BU depuis un secret référencé. Gardez le tableau de bord et l’API sur la même origine. Chaque groupe qui accorde un rôle doit porter le périmètre métier concerné.

Direction
Un groupe administrateur global ["*"] pilote objectifs et projets.
Responsables de BU
project_lead planifie, manager affecte, architect réalise la revue technique.
Employés et agents
La politique relie l’identité vérifiée à sa fiche ou au catalogue des agents. L’évaluation de l’agent doit être valide.

Pour l’autonomie, une BU peut autoriser le démarrage, le soumettre à un feu vert humain ou le bloquer. Renouvelez les autorisations de démarrage en attente après un redémarrage de l’API.

Configuration des groupes et sécurité par BU

Déposer des idées au Coin café

Moteur des sous-agents

Le moteur prend en charge les sous-tâches de lecture et de préparation dont la BU et l’agent sont configurés. Une tâche parente active peut déléguer sur un seul niveau, dans la limite de quatre sous-tâches, annulations comprises.

  1. Configurez un cas d’usage local chat-sensitive de niveau C3/C4, et un agent évalué associé à ce cas dans la BU.
  2. Dans LiteLLM, provisionnez une clé virtuelle limitée à ce cas, à l’alias et aux routes de chat. Associez son empreinte au dossier dans la politique stricte. Conservez la clé brute dans le gestionnaire de secrets.
  3. Montez le fichier privé en lecture seule. Sur Compose, ajoutez docker-compose.portfolio.yml et renseignez FACTORY_PORTFOLIO_RUNNER_SOURCE avec son chemin absolu sur l’hôte. Sur Kubernetes, référencez un secret existant avec api.portfolioRunner.existingSecret et configurez telemetry.litellmURL selon le guide du chart.
  4. Testez un refus pour une clé ou une BU différente, puis une exécution valide avec une entrée synthétique.
Voir la structure du fichier privé

Les identifiants ci-dessous sont fictifs. La clé du fichier doit correspondre à celle provisionnée pour ce cas d’usage.

{
  "version": 1,
  "bindings": [{
    "agent_id": "ag-support-research",
    "unit": "cc-relation",
    "usecase_id": "uc-41",
    "virtual_key": "<clé virtuelle de ce cas>"
  }]
}

Chaque tentative produit une réponse texte, avec un appel limité à 60 secondes et 512 tokens de sortie. Examinez le résultat avant de le réutiliser dans un processus métier.

Provisionner la clé et le routage LiteLLM

Décisions Workbench

Activez FACTORY_WORKBENCH_MODE=portfolio et FACTORY_WORKBENCH_CYBER_AUDIT=on sur l’installation protégée. Une tâche sensible soumise, et revue techniquement si nécessaire, passe en Relais Workbench. L’API rattache le dossier à la révision exacte de la tâche. Le journal de sécurité reste actif pendant le parcours.

Un approbateur global habilité et distinct des personnes impliquées ouvre le Compagnon de décision. La décision porte sur la tâche et ses preuves. Les opérations CRM et ERP suivent leurs propres circuits d’exécution.

Approuver
La tâche passe à Terminée et peut débloquer ses dépendances.
Refuser
La tâche passe à Annulée. Une dépendance qui exige son achèvement reste en attente.
Demander des modifications
La tâche repasse à Prête. La nouvelle soumission ouvre une décision distincte.

Le portefeuille expose l’issue et la date. Le dossier Workbench conserve l’approbateur et le motif dans son périmètre d’accès.

Modèles et connecteurs

Modèles
Le moteur intégré utilise la route locale chat-sensitive. L’assistance privée peut utiliser un modèle interne configuré. Le Laboratoire de flux calcule des scénarios synthétiques dans le navigateur.
CRM
Salesforce, HubSpot et Twenty disposent d’adaptateurs de lecture pour préparer le dossier Workbench à partir de l’opportunité. Qualifiez les droits et les champs nécessaires sur un bac à sable du fournisseur.
ERP
Le Workbench fournit un contrat d’exécution pour un connecteur fourni par l’hôte. Vérifiez l’idempotence côté ERP, la relecture indépendante et le circuit de réconciliation avant une écriture réelle.
MCP
Le serveur MCP local donne accès aux opérations Workbench prévues pour son identité. Gardez la préparation, l’approbation et l’exécution dans les périmètres appropriés.

Guide CRM, MCP et Workbench · Modes et limites du Workbench

Supervision et incidents

Consultez l’état des tâches, les preuves et le total de tokens dans le portefeuille. Distinguez les relevés du fournisseur, les valeurs déclarées et les compteurs encore inconnus. Un total marqué partiel ne couvre que les relevés disponibles.

Une sous-tâche reste prête

Contrôlez l’achèvement des dépendances, l’évaluation de l’agent, sa liaison au cas d’usage et la politique d’autonomie. En mode validation humaine, demandez au manager de fournir l’autorisation de démarrage.

Une exécution se bloque ou expire

Vérifiez l’état de LiteLLM et du modèle local, la liaison de la clé et les règles réseau. Après interruption, le moteur peut mettre deux minutes à libérer la tentative. Le manager vérifie la cause, puis réaffecte la tâche pour reprendre.

Les événements techniques portfolio.runner_attempt_finished et portfolio.runner_tick_failed facilitent le triage. Le résultat détaillé reste consultable depuis la tâche par les personnes habilitées.

Une décision tarde à apparaître

Vérifiez que la décision a été enregistrée sur le dossier correspondant et que l’API accède aux deux bases. Laissez la réconciliation s’exécuter et rechargez la vue. Conservez les identifiants et les horodatages pour l’incident, puis vérifiez le périmètre autorisé avant de partager une trace.

La sonde est verte et une intégration échoue

/api/v1/ready contrôle les chemins locaux et la configuration d’accès de l’API. Exécutez ensuite un test fonctionnel du fournisseur OIDC, du modèle et des destinations de télémétrie. Vérifiez DNS, TLS, les politiques réseau et les droits d’accès.

Les journaux n’arrivent pas dans Loki ou le SIEM

Vérifiez l’authentification TLS, l’accès de la collecte à la source et les politiques réseau. Sur Kubernetes, contrôlez la lecture de pods/log dans le seul namespace prévu. Testez séparément la livraison vers le SIEM de l’entreprise et l’accès aux fichiers d’audit.

Mesures, traces et preuves d’exploitation

Passage en production

  1. Choisir la révision à qualifier. Pour un pilote privé, partez de la révision auditée 27800aa et construisez les images localement avec la configuration validée. Lorsqu’un bundle signé couvre cette révision ou une révision ultérieure qualifiée, vérifiez le manifeste, les sommes et les attestations d’images, puis utilisez le Compose et docker-compose.release-lock.yml issus de ce même bundle. Placez tous les overlays de politiques et du Portefeuille avant ce fichier de verrouillage et chargez-le avec l’ultime option -f. La version v1.1.1 et son fichier images.txt servent de référence historique.
  2. Préparer le tenant. Configurez TLS, le SSO, la politique BU, les secrets de la passerelle et le modèle local. Définissez FACTORY_DEMO_MODE=never et FACTORY_GUARDRAIL_MODE=block. Gardez les services internes sur leurs réseaux privés.
  3. Valider le rendu Compose. Utilisez exactement les profils et fichiers de la cible. Le JSON peut contenir des secrets. Passez-le directement au précontrôle.
docker compose --project-name ai-factory \
  -f docker-compose.yml -f docker-compose.release-lock.yml \
  --env-file /secure/ai-factory/production.env --profile sso \
  config --format json | python scripts/check_production.py

La commande illustre le cas d’un bundle. Pour une construction depuis les sources, utilisez les fichiers Compose de la révision auditée et passez la configuration validée au même précontrôle. Utilisez le nom du projet existant pour conserver ses volumes. Ajoutez -f docker-compose.portfolio.yml et le fichier du moteur uniquement si vous activez les sous-agents. Ajoutez --profile local-gpu si vous utilisez le service GPU fourni, ou --private-gpu-host NOM au précontrôle pour chaque nom DNS privé externe approuvé.

  1. Démarrer et vérifier la santé. Appliquez up -d --no-build avec le bundle vérifié ou up -d --build avec le code source audité. Gardez les fichiers, variables et profils passés au précontrôle. Contrôlez les services avec docker compose ps dans la même configuration.
  2. Recetter avant d’ouvrir les accès. Rejouez la recette privée. Vérifiez le refus inter-BU et la séparation de l’approbateur, puis simulez une panne du modèle et un redémarrage après décision.
  3. Définir l’exploitation. Affectez les responsabilités d’astreinte, fixez les budgets et la rétention, chiffrez les sauvegardes et vérifiez une restauration sur un environnement isolé.

Déploiement Compose et vérification du bundle · Durcissement de la pile

Pilote Kubernetes

  1. Choisissez le profil demo avec port-forward local pour une qualification fictive, ou private avec HTTPS, OIDC, politique BU et secrets existants.
  2. Si le bundle contient le chart, utilisez son archive Helm et values.release.json. Pour un essai depuis les sources, préparez le chart avec python scripts/package_helm.py et utilisez des images compatibles avec la révision testée.
  3. Gardez une réplique API, un PVC et une stratégie de remplacement sans chevauchement. Préparez l’interruption de service d’une mise à niveau et testez une restauration sur un PVC distinct.
  4. Vérifiez une connexion valide, un refus inter-BU et le rejet des en-têtes d’identité falsifiés. Rejouez les tests avec votre contrôleur Ingress, votre CNI et votre fournisseur OIDC.
  5. Pour Alloy, provisionnez le secret de destination et limitez le trafic sortant à l’API Kubernetes, à DNS et au Loki autorisé. Qualifiez aussi la réception réelle au SIEM.

Le chart installe le cœur d’AI Factory et, sur option, Alloy. Les services de modèles et de télémétrie sont exploités par l’opérateur et reliés selon les besoins du profil privé.

Installer le chart Helm · Exploiter les volumes et Alloy

Sauvegarde et retour arrière

Conservez les bases du portefeuille et du Workbench et les fichiers d’audit dans le volume privé de l’API. Suspendez les écritures et les traitements avant de prendre une sauvegarde cohérente. Associez l’archive à la version et à la politique BU. Une copie de fichiers SQLite actifs peut manquer des écritures du journal.

Restaurer sans rejouer les opérations
  1. Restaurez sur une cible isolée avec la version et les politiques qualifiées. Gardez le moteur désactivé pendant la vérification.
  2. Contrôlez l’intégrité des bases, les décisions en attente et le cloisonnement BU. Renouvelez les autorisations de démarrage qui doivent encore servir.
  3. Vérifiez les tâches en cours et comparez le point de reprise avec les événements confirmés après la sauvegarde. Le manager arbitre les reprises nécessaires.
  4. Réactivez le moteur après qualification d’une tâche de test et d’une décision Workbench.

Pour un retour arrière, désactivez le moteur et conservez un instantané de l’état récent. Pour une archive de fichiers sur Kubernetes, sauvegardez le contenu du volume et préservez les permissions de la racine du PVC de destination. Si les données ont migré, restaurez un point compatible et réconciliez les écritures postérieures avec l’exploitant.

Référence du portefeuille et de l’API