Aller au contenu

Déployer un PoC

Ce parcours installe SmartAGT sur une VM Linux ou Windows, avec PostgreSQL 18, pgvector et le stockage de fichiers intégré. Les modèles de conversation, d’embedding, d’OCR et d’image sont accessibles à distance.

Navigateur
Applications
Clients IA
SmartAGTVM · Linux ou Windows
FrontendInterface web
Sessions utilisateur
Backend5 processus
APIAgents et logique métier
SchedulerTâches différées
GatewayAccès aux modèles
RAG-IngestorExtraction et segmentation
RAG-EmbedEmbeddings et indexation
PostgreSQL 18Base données et vecteurs
SeaweedFSFichiers persistants
Modèles distantsConversation
Embedding
HTTPS :9000 Lien interne
géré par
SmartAGT
mTLS :8010 HTTPS :8000 HTTPS :8001 HTTPS :443 TLS* :5432 mTLS :8888 TLS* :5432 Sessions

Accès par défautAccès applications et IAFlux internes et sortants

Hôte
VM x64
Processeur
4 vCPU
Mémoire
16 Go de RAM
Système
Linux ou WindowsUbuntu 22.04+, Debian 12+, Windows Server 2022+
Disque
100 Go SSD
Base
PostgreSQL 18Extension pgvector installée ; sous Windows, compilée avec les outils C++ de Visual Studio

Seuls les flux entrant ou sortant du serveur sont présentés ici. Les interactions entre processus du serveur sont détaillées dans la matrice complète des flux.

Source Destination Protocole / port Utilité
Postes utilisateurs Serveur · Frontend service HTTPS 9000 Interface web
Applications Serveur · API Publique HTTPS 8000 Appels à l’API SmartAGT
Clients IA Serveur · Gateway HTTPS 8001 Accès aux modèles via Gateway
Serveur SmartAGT Internet HTTPS 443 Modèles distants, web et connecteurs

Les ports d’écoute sont personnalisables.

L’API Publique reste en boucle locale : exposez-la seulement si des applications doivent la joindre. La Gateway écoute sur toutes les interfaces : ouvrez le port 8001 au pare-feu si des clients IA d’autres hôtes doivent la joindre. Le lien interne entre Frontend et API, sur 8010, reste local au serveur et SmartAGT le gère : rien à configurer.

Chaque composant répartit ses fichiers en quatre emplacements : son package, sa configuration, ses données et ses journaux. Une mise à jour remplace uniquement le package.

Linux

/app
├── smartagt-backend-core/   package Backend, remplacé à la mise à jour
├── smartagt-bff-core/       package Frontend, remplacé à la mise à jour
└── config/
    ├── backend/             YAML et certificats du Backend
    └── bff/                 YAML et certificats du Frontend
/etc/smartagt/               environnements et secrets
/var/lib/smartagt/
├── backend/                 données du Backend
└── bff/                     données du Frontend
/var/log/smartagt/
├── backend/                 journaux du Backend
└── bff/                     journaux du Frontend

Windows

C:\app
├── smartagt-backend-core\   package Backend, remplacé à la mise à jour
├── smartagt-bff-core\       package Frontend, remplacé à la mise à jour
├── config\
│   ├── backend\             YAML, environnement et certificats du Backend
│   └── bff\                 YAML, environnement et certificats du Frontend
├── data\
│   ├── backend\             données du Backend
│   └── bff\                 données du Frontend
└── logs\
    ├── backend\             journaux du Backend
    └── bff\                 journaux du Frontend

Les dossiers de données et de journaux sont déclarés dans le YAML de chaque composant, par data_dir et log_dir. Tous les chemins sont listés dans Configuration.

Ce PoC est prévu pour tester l’ensemble des fonctionnalités de la plateforme, auprès d’un groupe allant jusqu’à 100 utilisateurs dans un cadre d’évaluation fonctionnelle. Les tests de charge, l’exécution locale de modèles lourds et les traitements intensifs demandent un dimensionnement adapté.

* Le TLS vers PostgreSQL s’active, si vous le souhaitez, avec la procédure PostgreSQL SSL.

Livrables attendus

  • Package Backend : composant socle de Platform, de la Gateway et des workers.
  • Package Frontend : composant socle de l’interface.
  • Licence d’évaluation.

Votre environnement doit respecter les prérequis système et réseau détaillés ci-dessus.

Préparer l’environnement

Réalisez ces deux prérequis avant d’installer SmartAGT.

Étape Opération Résultat
1 Préparer PostgreSQL Instance conforme, pgvector installé.
2 Préparer les bases Bases, rôles et extensions prêts.

Installer SmartAGT

L’environnement est prêt. Installez les packages, activez la licence, puis raccordez les modèles.

Étape Opération Résultat
1 Installer le Backend API et workers lancés.
2 Installer le Frontend Connexion HTTPS, lien interne actif.
3 Activer l’installation Mot de passe changé, licence active.
4 Prise en main Modèles raccordés, réponse sourcée.

Prise en main

Raccordez les modèles, choisissez l’embedding par défaut et vérifiez une réponse sourcée avec la Prise en main.

Les écrans, les agents et l’administration courante sont décrits dans la documentation accessible à l’intérieur de SmartAGT.

Mettre à jour le PoC

Pour procéder à la mise à jour du projet, suivez la procédure Mettre à jour.