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.