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.
Accès par défautAccès applications et IAFlux internes et sortantsSmartAGTVM · Linux ou Windows
Sessions utilisateur
Embedding
géré par
SmartAGT
mTLS :8010
HTTPS :8000
HTTPS :8001
HTTPS :443
TLS* :5432
mTLS :8888
TLS* :5432
Sessions
- 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, puis suivez l’assistant d’installation.
| É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 | Mise en service terminée avec l’assistant. |
Prise en main
Changez le mot de passe initial, puis suivez l’assistant d’installation 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.