Aller au contenu

Ressources et systèmes

Profil du PoC

Élément Profil de référence
Machine Une VM x64, 4 vCPU, 16 Go de RAM
Disque 100 Go SSD
Système Linux x86_64 (Ubuntu 22.04 LTS, Debian 12 ou plus récents) ou Windows Server 2022 x64 ou plus récent : minimums
Base de données PostgreSQL 18, pgvector compilé pour PG18, extension unaccent
Fichiers SeaweedFS géré, binaire inclus dans le package Backend
Modèles Conversation, embedding, OCR et image sur des services distants
Accès utilisateur Nom DNS de la VM, HTTPS vers le Frontend service sur TCP 9000
Administration sudo sous Linux ou console Windows élevée pour l'installation

Ce profil fixe le scénario documentaire ; il ne garantit pas un nombre d'utilisateurs simultanés. Aucun GPU n'est demandé sur la VM, puisque l'inférence est distante. Le parcours PoC donne l'ordre d'installation.

Systèmes d'exploitation

Système Minimum requis Validé
Linux x86_64, glibc 2.35 ou plus, systemd : Ubuntu 22.04 LTS, Debian 12 ou plus récents Ubuntu 24.04 LTS
Windows Windows Server 2022 x64 ou plus récent, PowerShell 5.1 64 bits Windows Server 2022

Les binaires Linux sont compilés avec la glibc 2.35 : RHEL 9 et ses dérivés (glibc 2.34) ne sont pas pris en charge.

Dépendances de l'hôte

Linux Windows
systemd Services et pare-feu Windows ; NSSM en mode alternatif
curl, pour les contrôles des procédures Outils C++ de Visual Studio, pour compiler pgvector sur le serveur ou sur un poste de préparation
Préparer PostgreSQL Préparer PostgreSQL

Les exécutables SmartAGT embarquent leur runtime : aucun Python n'est à installer sur le serveur. Sous Linux, le package Backend embarque aussi libmagic dans son dossier magic/ et l'emploie même si l'hôte a la sienne. Pour employer celle du système, installez son paquet et retirez libmagic.so.1 et magic.mgc de ce dossier.

Réseau et certificats

Réseau privé

SmartAGT est conçu pour un réseau privé, sans exposition directe à Internet : Exposition réseau.

Sur un serveur, le Frontend service, l’API Publique et la Gateway répondent par défaut en HTTPS avec un certificat autosigné généré par SmartAGT. En cluster, chaque nœud Frontend reçoit son certificat à l’installation. Pour un usage durable, préparez vos propres certificats, reconnus par les postes et les applications : Installer vos certificats.

Préparez aussi la confiance des services externes raccordés. Le chiffrement de PostgreSQL est recommandé en production : PostgreSQL SSL. Alignez le DNS et l’heure du système. Le lien entre Frontend service et API et le stockage géré utilisent des certificats émis par SmartAGT : aucun certificat n’est à fournir pour eux.

Le pare-feu amont autorise le réseau des postes vers TCP 9000 de la VM. Les ports de données restent réservés aux composants. Sur le serveur de l’API, les ports TCP 8010 et 8011 restent disponibles pour l’écoute Interne et le guichet local de rattachement, tous deux en boucle locale sur une VM unique. Un reverse proxy peut présenter le Frontend service sur 443 dans le parcours projet.

Les ports et flux précisent les sources et destinations.

Dimensionnement projet

Besoin Ressource à étudier
Charge conversationnelle CPU/RAM applicatifs, concurrence fournisseur, connexions et pools PostgreSQL selon les conversations simultanées et la durée des appels
Ingestion documentaire Débit et capacité des volumes, index vectoriels, workers RAG et API d’embedding selon le corpus et les ingestions simultanées
Traitements locaux Mémoire et CPU, cache des poids et dépendances pour l’OCR, les modèles locaux ou les grandes pages
Fichiers générés Taille des images et objets, rétention et accès au stockage
Haute disponibilité Répartition des rôles, données partagées, disponibilité de PostgreSQL et du stockage
AI Gateway Processus et pools supplémentaires, débit des clients externes

Chaque worker d'ingestion peut employer plusieurs processus pour lire un PDF natif. Dans smartagt.ingestion, ingestor_pool_size absent ou à 0 fixe le nombre de processus à la moitié du nombre de processeurs logiques visibles, affinité comprise, avec un minimum de 1 et un maximum de 4. Sur le profil à 4 vCPU, cela donne 2 processus par worker. Une valeur entière positive fixe ce nombre ; une valeur négative empêche le démarrage. Si plusieurs workers partagent un hôte, attribuez à chacun un budget explicite. Préservez une réserve CPU et mémoire pour les conversations et les modèles locaux ; l'embedding local et l'inspection OCR peuvent rester dominants dans la durée d'ingestion. Ce budget ne garantit pas une latence stable des recherches avec des modèles locaux sur le même hôte : validez le dimensionnement sous charge.

À titre indicatif, la lecture d'un PDF natif de 47 Mo contenant du texte et des images a atteint environ 0,50 Go de mémoire résidente sous Windows pour un worker et ses quatre processus réunis. Ce relevé exclut les services d'embedding et d'OCR et ne constitue pas un plafond : mesurez votre corpus avant de dimensionner plusieurs workers.

Les pipelines OCR locaux du catalogue fonctionnent sur CPU. Leurs poids, les pages décodées et les appels concurrents demandent une réserve mémoire et un cache disque supplémentaires. L'accès au dépôt des poids sert à leur préparation explicite ; l'extraction lit ensuite le cache local, accessible au compte du service. Tesseract et ses données de langue ne sont pas requis.

Ces besoins ne sont pas inclus implicitement dans les 16 Go du PoC. Les architectures projet expliquent les conséquences sur le placement des composants.