Aller au contenu

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.

01Les composants de la plateformeVue technique d'ensemble
FrontendInterface web
Sessions utilisateur
BackendAPI et workers
APIAgents & logique métierPublic 8000 · Interne 8010
RAG-IngestorExtraction & segmentation
RAG-EmbedEmbeddings & indexation
SchedulerTâches différées
ModèlesConversation
Embeddings
Ressources du projet
PostgreSQLDonnées & index vectoriels
SeaweedFSDocumentsInterne sur VM
Sessions Frontend
Dépendances entre composants

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 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.

02Les usages, les agents et leur gouvernanceVue logicielle et fonctionnelle
UtilisateursÉchanger & créer
Logiciels tiersAppeler un agent
AdministrateursGouverner & suivre
Usages & création
ChatMarketplaceStudio
Intégration applicative
API SmartAGTComptes de service

Appels d'agents authentifiés

Gouvernance & pilotage
Accès & politiquesCataloguesQuotasAudit & supervision
Agents SmartAGTInstructions · Connaissances · Mémoire · Connecteurs
SmartAGTFonctions et ressources selon vos droits
Modèles d'IAPrivés ou fournisseurs
Outils métierActions via connecteurs
Acteurs, fonctions et ressources raccordées

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.
SmartAGT AI GatewayService facultatif

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.