Concepts Fondamentaux

1. Brain

Un Brain est le concept central du système, représentant une configuration d'IA avec des capacités spécifiques.

Propriétés Clés :

• ID : Identifiant unique
• Nom : Nom lisible par l'humain
• Moteur : Configuration pour le modèle d'IA sous-jacent (OpenAI, LlamaCPP)
• Modules : Extensions qui fournissent des fonctionnalités supplémentaires
• Persona : Définition de la personnalité qui façonne les interactions (peut être spécifique à une langue)
• PromptInit : Contexte/instructions initiales pour l'IA (peut être spécifique à une langue)
• Flow : Structure optionnelle de flux de conversation
• Abonnement : Limites d'utilisation et informations de facturation optionnelles

Responsabilités :

• Sert de conteneur pour les capacités et la configuration de l'IA
• Définit la personnalité et le comportement de l'IA
• Contient des modules qui étendent les fonctionnalités

2. Agent

Un Agent est une instanciation d'un Brain qui peut être déployée et avec laquelle on peut interagir de manière indépendante.

Propriétés Clés :

• ID : Identifiant unique
• BrainID : Référence au Brain parent
• Nom : Nom lisible par l'humain
• AuthSecret : Identifiant d'authentification
• StreamingEnabled : Si les réponses en streaming sont activées
• Configuration Vocale : Paramètres pour la synthèse vocale
• Statut : État actuel (OCCUPÉ/INACTIF)
• Instances : Plusieurs instances en cours d'exécution du même agent

Responsabilités :

• Fournit une interface pour interagir avec un Brain
• Gère l'état des conversations en cours
• Prend en charge la synthèse vocale et le streaming

3. Chat

Un Chat représente une session de conversation entre un utilisateur et un Agent.

Propriétés Clés :

• ID : Identifiant unique
• BrainID : Référence au Brain utilisé
• AgentID : Référence à l'Agent utilisé
• Messages : Tableau des messages dans la conversation
• Contexte : Métadonnées et état de la conversation
• Langue : La langue utilisée dans la conversation

Responsabilités :

• Stocke l'historique des conversations
• Maintient l'état et le contexte de la conversation
• Suit le flux des messages et l'utilisation des outils

4. Message

Un Message représente une interaction unique au sein d'un Chat.

Propriétés Clés :

• ID : Identifiant unique
• Rôle : Type d'expéditeur (UTILISATEUR, ASSISTANT, SYSTÈME)
• Contenu : Le texte réel du message
• RésultatsOutils : Résultats des outils utilisés dans le traitement du message
• Suggestions : Réponses ou suivis suggérés
• NœudFlow : Référence au nœud de flux qui a généré ce message
• Horodatage : Quand le message a été créé
• Actions : Actions qui peuvent être entreprises en réponse au message

Responsabilités :

• Stocke le contenu des interactions individuelles
• Associe l'utilisation d'outils aux messages
• Transporte des métadonnées pour le contrôle des flux et les éléments d'interface utilisateur

5. Flow

Un Flow définit un chemin de conversation structuré avec des nœuds qui guident les interactions.

Propriétés Clés :

• Nœuds : Étapes individuelles de conversation
• Points d'entrée : Conditions qui déclenchent le flux
• Sorties : Transitions vers d'autres nœuds
• Contenus : Contenu et comportement pour chaque nœud

Responsabilités :

• Structure les conversations en chemins logiques
• Contrôle l'accès aux outils à différentes étapes
• Fournit des expériences de conversation guidées
• Applique des exigences avant de progresser

6. Module

Un Module est une extension qui ajoute des fonctionnalités à un Brain.

Types Principaux :

• Externe : Intégration avec des API externes via REST
• ContextualKnowledgeWeaviate : Récupération de connaissances à partir d'une base de données vectorielle

Responsabilités :

• Étend les capacités du Brain
• Fournit un accès aux systèmes et données externes
• Permet de récupérer un contexte pertinent pour les conversations

7. Guardian

Un Guardian fournit une modération de contenu et une sécurité pour les interactions.

Types Principaux :

• PROMPTCHECK : Évalue la sécurité des entrées
• WORDCHECK : Filtre des mots spécifiques
• INTENTIONCHECK : Analyse l'intention des messages
• ATTACKCHECK : Détecte les menaces de sécurité potentielles
• ANONIMIZE : Supprime les informations personnellement identifiables

Responsabilités :

• Assure la sécurité des conversations
• Filtre le contenu inapproprié
• Prévient l'injection de prompts et autres attaques
• Protège les informations privées

8. Tool

Un Tool est une fonction qui peut être utilisée par un Brain pour effectuer des actions spécifiques.

Responsabilités :

• Fournit des capacités spécifiques au Brain
• Exécute des actions basées sur le contexte de la conversation
• Renvoie des résultats qui peuvent être incorporés dans les réponses