Aller au contenu

Interface d'Administration

Synapse Admin inclut une interface d'administration complète pour piloter votre IA en temps réel, sans toucher au code.

🚀 Accès

Par défaut, l'interface est accessible via l'URL : /synapse/admin.

[!IMPORTANT] Sécurité : L'accès est protégé par la configuration synapse.admin_role (par défaut ROLE_ADMIN). Assurez-vous d'avoir ce rôle pour accéder aux pages.

📊 Tableau de Bord (Dashboard)

Le Dashboard de l'Administration Synapse est le point central pour monitorer votre système : * Analytics de Consommation : Vue d'ensemble des tokens utilisés et des coûts associés par jour/mois. * Monitoring par Module : Suivi détaillé de l'usage (Chat, Agents, Tâches système). * État des Services : Liste des providers (Gemini, OpenAI, etc.) actuellement activés.

💰 Gestion des Quotas (Spending Limits)

Nouveauté majeure de la V2, cette page permet de définir des limites de dépense : * Plafonds par utilisateur : Bridez la consommation de vos utilisateurs (ex: 5€ / mois). * Plafonds par agent : Limitez le budget d'un agent spécifique. * Périodes glissantes : Gestion intelligente des quotas sur 24h ou 30 jours via le cache.

⚙️ Paramètres Globaux (Settings)

Cette page permet de configurer le comportement par défaut du bundle : * Langue du Contexte : Définit la langue de l'IA et de l'interface par défaut (via le système de translation synapse_admin). * Rétention RGPD : Nombre de jours avant la purge automatique des messages. * Prompt Système Global : Instructions de base qui seront ajoutées à toutes les conversations. * Mode Debug : Active ou désactive le logging technique approfondi.

🤖 Agents

Configuration des agents IA spécialisés. Chaque agent combine :

  • System Prompt : Instructions de rôle et comportement
  • Preset LLM (optionnel) : Modèle, température, autres paramètres
  • Ton de réponse (optionnel) : Style de communication (zen, efficace, poétique, etc.)
  • Outils autorisés : Sélection des outils (AiToolInterface) accessibles par cet agent (NULL = tous)
  • Sources RAG autorisées : Sélection des sources de connaissance spécifiques
  • Contrôle d'accès : Rôles Symfony ou identifiants utilisateur autorisés (NULL = public)

Gestion : * Liste : Affiche tous les agents (builtins + custom) * Création/Édition : Formulaire complet de configuration * Outils visibles : Badge affichant le nombre d'outils assignés * Accès restreint : Indicateur "🔒" pour les agents avec contrôle d'accès

[!NOTE] Reportez-vous à Contrôle d'accès aux agents pour la configuration complète des permissions.

📚 Sources RAG (Retrieval-Augmented Generation)

Gestion des sources de documents indexés pour enrichir les réponses de l'IA.

  • Liste des sources : Affiche chaque source avec :
    • Nombre de documents indexés
    • Date de la dernière réindexation
    • Statut (pending, indexing, done, failed)
    • Bouton de réindexation
  • Création/Édition : Paramétrage du provider (Google Drive, Notion, fichiers locaux, etc.)
  • Visualisation des chunks : Tableau des documents indexés avec :
    • Contenu du chunk
    • Métadonnées (fichier source, page, etc.)
    • Score de pertinence (pour tests de requête)
  • Réindexation : Lance synapse:rag:reindex asynchrone (Messenger)
    • Affiche la progression : fichiers traités / fichiers totaux
    • Affiche les erreurs en cas d'échec

[!TIP] Utilisez php bin/console synapse:rag:test "ma requête" pour tester la pertinence des résultats RAG avant déploiement.

🚨 Alertes de Dépenses

Surveillance des dépassements de limite de dépense (SynapseSpendingLimit).

  • Tableau des dépassements récents : Historique des fois où un utilisateur/agent/preset a dépassé son plafond
  • Colonnes :
    • Utilisateur affecté
    • Type de limite (par utilisateur / par agent / par preset)
    • Période (jour calendaire / mois / jour glissant / mois glissant)
    • Montant du plafond
    • Dépassement (montant en trop)
    • Date/heure du dépassement
  • Actions : Voir le détail d'un dépassement, ajuster le plafond

🔧 Gestion des Outils (Tools)

Visualisez tous les outils (AiToolInterface) enregistrés dans votre application : * Inventaire : Liste exhaustive des outils disponibles pour le LLM. * Inspection de Schéma : Vérifiez les paramètres JSON que l'IA doit fournir pour chaque outil. * Documentation : Affiche les descriptions servies au modèle.

🤖 Modèles & Fournisseurs

  • Providers : Activez ou désactivez vos comptes (OpenAI, Gemini, OvhAi, etc.) et configurez vos clés API de manière sécurisée.
  • Modèles : Choisissez vos modèles préférés, gérez leurs capacités (vision, outils) et paramétrez leur tarification pour le calcul des coûts.

📝 Personas & Presets

Créez des "Personnalités" préconfigurées pour vos utilisateurs : * Presets : Définissez un modèle, une température et un prompt système spécifique pour un usage donné (ex: "Expert SQL", "Copywriter Email"). * Tests : Un simulateur de chat intégré permet de tester vos presets en direct avant de les déployer.

🔍 Logs de Debug

Si le mode debug est activé, vous pouvez inspecter chaque échange technique : * Payloads API : Voir exactement le JSON envoyé et reçu. * Flux d'Événements : Comprendre quel événement a été déclenché et à quel moment. * Diagnostics : Identifier rapidement pourquoi un outil n'a pas été appelé comme prévu.