Vue d'ensemble des Contrats (Interfaces)
Synapse Core est conçu comme un kit de construction. Chaque brique majeure est définie par une interface (un "contrat") que vous pouvez réimplémenter pour adapter le bundle à vos besoins exacts.
Pas besoin de tout implémenter
Synapse Core arrive avec des implémentations par défaut pour la plupart de ces briques. Vous ne remplacez que ce dont vous avez réellement besoin.
Cœur & Orchestration
| Interface | Rôle principal |
|---|---|
| LlmClientInterface | Le Moteur. Connecte Synapse à OpenAI, Gemini, Ollama, etc. |
| AiToolInterface | L'Action. Permet à l'IA d'appeler votre code PHP (Function Calling). |
| StatusAwareToolInterface | Le Feedback. Message personnalisé dans l'UI pendant l'exécution d'un outil. |
| AgentInterface | L'Orchestrateur. Agent programmatique pour des tâches complexes multi-étapes. |
RAG & Mémoire (Long-terme)
| Interface | Rôle principal |
|---|---|
| VectorStoreInterface | Le Stockage. Gère les documents vectorisés (PostgreSQL pgvector, Pinecone…). |
| EmbeddingClientInterface | Le Traducteur. Transforme le texte en vecteurs mathématiques. |
| TextSplitterInterface | Le Découpeur. Divise les documents en chunks optimisés pour le RAG. |
| RagSourceProviderInterface | La Source. Déclare une source de documents indexables (Drive, Notion, API…). |
Sécurité & Conformité
| Interface | Rôle principal |
|---|---|
| EncryptionServiceInterface | La Vie Privée. Chiffre vos messages et credentials en base de données. |
| PermissionCheckerInterface | Le Gardien. Contrôle qui peut lire, modifier ou utiliser quoi. |
| RetentionPolicyInterface | Le RGPD. Définit les règles de purge automatique. |
Personnalisation du Flux
| Interface | Rôle principal |
|---|---|
| ContextProviderInterface | L'Injection. Ajoute un prompt système et des données dynamiques à chaque échange. |
| ConfigProviderInterface | Le Réglage. Fournit la configuration runtime (SynapseRuntimeConfig) aux clients LLM. |
| ConversationOwnerInterface | Le Propriétaire. Identifie l'entité utilisateur propriétaire d'une conversation. |
| MessageFormatterInterface | Le Normalisateur. Convertit les entités SynapseMessage ↔ format OpenAI canonical. |
| SynapseDebugLoggerInterface | Le Débogueur. Enregistre les payloads bruts pour l'analyse d'erreurs et de qualité. |