Aller au contenu

Stockage

SmartAGT sépare les données structurées des fichiers. PostgreSQL et pgvector conservent les données applicatives, les sessions et les index. Le stockage intégré ou S3 conserve les documents, pièces jointes et fichiers produits.

Données structurées et fichiers ont des rôles distinctsLes stockages sont partagés par les processus qui en ont besoin
FrontendAccès à sa base
de sessions
BackendPersistance
APIConversations, configuration et fichiersRecherche dans les index autorisés
WorkersDocuments, passages et embeddingsJobs et état des traitements
FichiersIntégré : un serveur
S3 : évolutif
HTTPS
PostgreSQLsmartagt · smartagt_bffDonnées et sessions
PostgreSQL + pgvectorsmartagt_vectorIndex documentaires
Trois bases logiques peuvent partager une instance PostgreSQL

Le Frontend service conserve ses sessions dans sa base. L’API et les workers concernés accèdent aux fichiers en HTTPS.

Choix du stockage

Le stockage des fichiers se choisit à l’installation, selon l’évolution prévue de la plateforme.

  • Stockage intégré


    Pour un seul serveur. SeaweedFS, inclus dans le package Backend et géré par SmartAGT : aucune dépendance ni certificat à fournir.

    • PoC et installation sur un serveur
    • Fichiers sous le répertoire de données du Backend
    • Sauvegarde de ce répertoire à votre charge
    • Reste limité à un seul serveur
  • S3


    Évolutif. Votre service objet compatible S3 : MinIO, Ceph, NetApp StorageGRID ou S3 d’un fournisseur cloud.

    • Plusieurs serveurs et conteneurs
    • Haute disponibilité et sauvegarde portées par votre stockage
    • Endpoint HTTPS, bucket privé dédié et accès à fournir
    • Raccordement avant l’installation : Configurer S3

Si la plateforme doit un jour s’étendre à plusieurs serveurs, retenez S3 dès l’installation.

PostgreSQL et pgvector

Base Utilisation Clients principaux
smartagt Données applicatives, configuration, identités, jobs et métadonnées du stockage interne API et workers
smartagt_vector Index documentaires, extension vector API et worker RAG-Embed
smartagt_bff Sessions du Frontend service Frontend service

Le profil de référence utilise PostgreSQL 18. Les trois bases peuvent résider dans la même instance : leur séparation logique ne demande pas trois serveurs. pgvector ajoute la recherche vectorielle ; il ne conserve pas les fichiers originaux.

Persistance et clés

Un remplacement du package ou d’un conteneur doit retrouver les bases, les fichiers et les clés de chiffrement. Le Backend et le Frontend service conservent chacun leurs secrets : voir Secrets. Les données persistantes restent hors du répertoire des binaires.

Les images générées sont copiées dans le stockage géré : une URL fournisseur ne constitue pas leur conservation durable. Les images et résultats OCR conservés suivent les droits de leur portée. Les essais Studio et les pièces de conversation ont leurs propres règles de conservation, décrites dans le produit.