Architecture
SmartAGT associe une interface web, une API et des traitements documentaires à PostgreSQL, un stockage de fichiers et des modèles d'IA. Les composants peuvent partager une VM ou être répartis sur plusieurs serveurs. Les schémas montrent leurs responsabilités, les parcours PoC et projet montrent leur implantation.
Architecture technique
Le Frontend service porte l'interface web. Le Backend exécute l'API métier et trois workers :
rag-ingestor, rag-embed et scheduler. Ce dernier entretient les index
RAG, synchronise l'annuaire Microsoft Entra ID et livre les courriels.
Sur VM, SeaweedFS est le stockage interne géré par SmartAGT, PostgreSQL conserve les données
applicatives, les index vectoriels et les métadonnées de ce stockage. Les modèles sont
raccordés selon les ressources retenues pour le projet. En conteneurs, S3 est obligatoire.
Sessions utilisateur
EmbeddingsRessources du projet
Le cadre Backend regroupe quatre processus, qui peuvent partager une machine. Toutes les liaisons réseau utilisent TLS, y compris les échanges locaux et ceux du stockage.
Le Frontend joint l’API par l’écoute Interne, en TLS mutuel sous une autorité SmartAGT. Les clients API externes utilisent l’écoute Public, les applications IA l’écoute Gateway. Vos certificats servent l’entrée utilisateur, l’écoute Public et le Gateway, jamais le lien interne.
Rôles et dépendances
| Composant | Rôle | Dépendances principales |
|---|---|---|
| Frontend service | Servir l'interface web et relayer les requêtes | Écoute Interne de l'API Backend, base de sessions PostgreSQL |
| API Backend | Exécuter les fonctions métier et les agents ; servir les écoutes Public et Interne | PostgreSQL, documents, modèles et connecteurs selon l'appel |
| AI Gateway | Exposer les modèles autorisés aux outils tiers, avec des clés dédiées, sur l'écoute Gateway | PostgreSQL de la Platform, fournisseurs de modèles, aucun appel HTTP vers Platform ou Frontend service |
| RAG-Ingestor | Extraire et segmenter les documents | PostgreSQL, stockage documentaire |
| RAG-Embed | Produire les embeddings et alimenter les index | PostgreSQL, modèle d'embeddings, index vectoriel |
| Scheduler | Exécuter les tâches différées : index, annuaire Entra et courriels | PostgreSQL, Microsoft Graph, stockage et transport mail selon la tâche |
| SeaweedFS | Conserver les fichiers documentaires | Volumes persistants, métadonnées dans la base PostgreSQL Backend en mode géré |
| PostgreSQL | Conserver données, sessions, index et état des traitements | Service de base de données avec pgvector pour les index vectoriels |
Les workers coordonnent leur travail à partir de l'état persisté dans PostgreSQL. Ils ne forment pas une chaîne d'appels HTTP entre eux. Les commandes de lancement figurent dans la page Exploitation.
Livraison et données
| Élément | Contenu |
|---|---|
| Package Backend | Un lanceur pour l'API, les trois rôles de workers et l'option AI Gateway, binaire SeaweedFS du mode géré |
| Package Frontend service | Interface web et serveur de sessions |
smartagt |
Données métier et état des traitements, métadonnées du filer en stockage géré |
smartagt_vector |
Index documentaires avec pgvector, même rôle PostgreSQL que Platform |
smartagt_bff |
Données de sessions, avec un rôle PostgreSQL distinct |
| Stockage documentaire | Volumes SeaweedFS ou bucket S3, fichiers et médias hors du dossier des binaires |
Les packages et la licence sont transmis séparément. Les modèles sont des services raccordés : le PoC utilise des modèles distants et ne charge pas leurs poids sur la VM applicative.
Stockage
Sur VM, mono ou multi-serveur, SeaweedFS est interne et géré par Platform. Les workers rejoignent le même stockage. Prévoyez les volumes persistants et les ressources. SmartAGT gère la configuration et les certificats internes de SeaweedFS.
En conteneurs, S3 est obligatoire. Un projet sur VM peut également raccorder un service S3. Le concept de stockage explique ces choix et le parcours projet leur placement.
Les ports et flux précisent qui joint chaque service. Les certificats et secrets expliquent les identités et la confiance nécessaires à ces liaisons. La page Inférence distingue les fournisseurs SaaS, sur site et locaux des modèles qu’ils exécutent.
Architecture logicielle
Les utilisateurs échangent avec les agents, les créateurs habilités les configurent, et les logiciels tiers peuvent les appeler par l'API SmartAGT. L'administration réunit les fonctions de gouvernance. Les fonctions et les ressources accessibles dépendent des droits et de la configuration de la plateforme.
Appels d'agents authentifiés
L'API reçoit les demandes des logiciels tiers. Les connecteurs permettent aux agents d'appeler des outils métier. Ces deux sens d'intégration sont distincts.
Parcours fonctionnels
- Utilisateurs et créateurs : échanger dans le Chat, découvrir les agents de la Marketplace et les utiliser selon ses droits, configurer des agents dans le Studio lorsqu'on y est habilité.
- Logiciels tiers : obtenir un jeton avec un compte de service, puis appeler un agent autorisé via l'API SmartAGT, en réponse complète ou en flux.
- Administrateurs : gérer les identités, les accès, les catalogues et les politiques, suivre les consommations, les quotas et les journaux selon les permissions attribuées.
- Agents : mobiliser les instructions, connaissances documentaires, éléments de mémoire, modèles et outils configurés pour leur usage.
Un processus HTTP distinct raccorde les outils tiers aux modèles par Chat Completions, en JSON ou SSE. Les clés, catalogues et politiques sont gouvernés par SmartAGT, les outils exécutent eux-mêmes leurs fonctions. Workspace fonctionne sans ce service, qui ne remplace pas l'API d'appels d'agents.
Voir Activer AI Gateway et ses flux. Le même artefact Backend porte Platform et Gateway, chaque processus ouvre ses propres ressources.