IA

Les fonctionnalités IA d'Antimatter utilisent des modèles de votre choix : un fournisseur cloud ou un serveur sur votre propre réseau. Rien n'est envoyé nulle part tant que vous n'avez pas configuré un modèle. Cette page couvre les connexions aux modèles, chaque fonctionnalité, les données qu'elle envoie et comment la désactiver.

Les fonctionnalités IA

« Compatible OpenAI » désigne un serveur qui propose la même API HTTP qu'OpenAI. La plupart des serveurs de modèles que vous pouvez exploiter vous-même le sont (par exemple Ollama, vLLM, le serveur de llama.cpp, ou les serveurs de transcription vocale et de synthèse vocale), tout comme de nombreux fournisseurs cloud et passerelles tels que LiteLLM ou OpenRouter. Aucune licence n'est requise pour aucune de ces fonctionnalités.

Les fonctionnalités intégrées (réécriture, résumés, traduction et lecture à voix haute) n'ont pas besoin de l'application Agents : elles utilisent les connexions aux modèles que vous ajoutez dans la Console système.

Connexions aux modèles

Une connexion à un modèle est un fournisseur IA qu'Antimatter peut appeler : son adresse, sa clé et ses modèles. Vous l'ajoutez une fois, puis vous la sélectionnez pour chaque fonctionnalité qui doit l'utiliser. Il en existe deux types :

• Connexions au niveau du serveur, gérées par les administrateurs système dans Console système › IA › Connexions aux modèles. Seules celles-ci peuvent servir les fonctionnalités intégrées. Les applications peuvent également les utiliser, pour les personnes autorisées.
• Connexions communautaires, que les administrateurs d'une communauté ajoutent pour leur propre communauté dans les paramètres de la communauté (voir ci-dessous). Les applications les utilisent pour les membres de la communauté. Elles ne servent jamais les fonctionnalités intégrées.

La section IA de la Console système est visible pour les personnes pouvant gérer les connexions au niveau du serveur : les administrateurs système, par défaut. Sa page Connexions aux modèles liste les connexions au niveau du serveur et celles de chaque communauté.

Ajouter une connexion

Dans Console système › IA › Connexions aux modèles, cliquez sur Ajouter une connexion, puis remplissez le formulaire :

Tester la connexion vérifie l'adresse et la clé : le serveur demande au point de terminaison ses modèles, ou envoie une discussion d'un jeton. Une adresse modifiée est testée avec la clé enregistrée uniquement après l'enregistrement, ou si vous saisissez à nouveau la clé. Cliquez sur Ajouter la connexion pour enregistrer.

Le serveur effectue lui-même les requêtes, il doit donc pouvoir accéder à l'API : un serveur de modèle dans le même projet compose, sur votre réseau, ou sur Internet. Les requêtes sortantes respectent les variables HTTP_PROXY et HTTPS_PROXY.

La suppression d'une connexion efface sa clé. Les fonctionnalités qui l'utilisaient cessent d'utiliser l'IA jusqu'à ce que vous sélectionniez une autre connexion.

Limites et budgets

Chaque connexion comporte quatre limites. Une valeur vide ou 0 signifie qu'il n'y a pas de limite.

• Requêtes par minute et Par personne, requêtes par minute. Elles sont comptées séparément par chaque serveur : un cluster de trois serveurs autorise jusqu'à trois fois le débit.
• Jetons par mois et Par personne, jetons par mois : budgets de jetons, par mois civil (UTC), comptés dans la base de données pour l'ensemble du cluster. Plusieurs requêtes exécutées simultanément peuvent dépasser légèrement un budget.

Les limites par personne s'appliquent également à la réécriture et aux résumés : elles sont imputées à la personne qui effectue la réécriture, ou qui est propriétaire du résumé.

Utilisation

La liste affiche l'utilisation de chaque connexion ce mois-ci. Utilisation ouvre les détails : jetons entrants et sortants, requêtes, budget mensuel, utilisation par jour (UTC) et par usage (Réécrire, Résumés, Traduction automatique, Synthèse vocale, Personnes, via des applications, ou une application).

Chaque appel effectué par une personne ou une application via une connexion génère également un enregistrement d'audit : qui, la connexion, l'usage, le modèle, les nombres de jetons et s'il a réussi, jamais ce qui a été dit. Les fonctionnalités intégrées ne sont comptées que dans l'utilisation : la traduction seule génère un appel par message et par langue.

Connexions communautaires

Les administrateurs de communauté ajoutent leurs propres connexions dans les paramètres de la communauté, dans l'onglet Connexions aux modèles. Le formulaire est le même, sans Communautés : la connexion d'une communauté ne fonctionne que dans ses propres canaux, pour ses propres membres, et son audience ne peut nommer que ses propres équipes. Les rôles disposant de l'autorisation Gérer les connexions aux modèles peuvent également les gérer. Par défaut, les administrateurs de communauté en disposent.

La connexion d'une communauté ne peut pas accéder aux adresses privées ou de boucle locale (un serveur Ollama sur votre réseau, par exemple), sauf si Console système › Environnement › Développeur › Autoriser les connexions internes non approuvées à (ServiceSettings.AllowedUntrustedInternalConnections) les liste. Les connexions au niveau du serveur peuvent le faire.

Voir Paramètres de la communauté pour la partie des administrateurs de communauté.

La clé de chiffrement

Les clés et en-têtes supplémentaires des connexions aux modèles sont chiffrées dans la base de données (AES-256-GCM) à l'aide d'une clé de chiffrement. Une simple sauvegarde de la base de données ne les révèle pas. Le serveur recherche la clé dans l'ordre suivant :

1. La variable AM_AI_ENCRYPTION_KEY : 32 octets aléatoires, en base64. Créez-en une avec openssl rand -base64 32.
2. Sinon, le fichier ai-encryption.key à la racine du répertoire de données du serveur (FileSettings.Directory, ./data/ par défaut). Le serveur le crée, lisible uniquement par lui-même, la première fois qu'une connexion en a besoin. Les applications, les exports et les archives de fichiers ne peuvent pas y accéder.

Quand définir la variable :

• Avec le fichier compose du site. compose.yaml transmet AM_AI_ENCRYPTION_KEY depuis .env et conserve le fichier de clé dans le volume data lorsque la variable est vide. Il est préférable de définir la variable : la sauvegarde de .env contient alors la clé, séparément de la base de données. Ajoutez-la à .env et exécutez docker compose up -d :

  echo "AM_AI_ENCRYPTION_KEY=$(openssl rand -base64 32)" >> .env

  Si le serveur a déjà créé son fichier de clé, placez la clé qu'il détient dans .env à la place, afin que les clés enregistrées restent lisibles : docker compose exec antimatter cat /antimatter/data/ai-encryption.key l'affiche.
• Un cluster dont les fichiers sont dans S3. Ses serveurs ne partagent aucun répertoire, donc le serveur ne crée pas le fichier : définissez la même variable sur chaque serveur. Jusqu'à ce qu'elle soit définie, les connexions ne peuvent pas enregistrer de clés.
• Avec l'archive de la version ou les paquets, le fichier est dans data/ (/var/lib/antimatter/data pour les paquets). Vous pouvez le laisser là, ou définir la variable dans votre fichier d'environnement.

Pour changer la clé, définissez la nouvelle dans AM_AI_ENCRYPTION_KEY et l'ancienne dans AM_AI_ENCRYPTION_PREVIOUS_KEYS (plusieurs clés séparées par des virgules) : les clés enregistrées avec l'ancienne peuvent encore être lues. La clé d'une connexion est chiffrée avec la nouvelle clé lorsque vous la saisissez à nouveau. Conservez l'ancienne clé dans la liste jusqu'à ce que la clé de chaque connexion ait été ressaisie.

Les fonctionnalités intégrées

Dans Console système › IA › Fonctionnalités intégrées, sélectionnez pour chaque fonctionnalité une connexion globale au serveur et son modèle, ou Désactivé. Une fonctionnalité sans connexion n'utilise pas l'IA. Charger les modèles liste tous les modèles de la connexion ; par défaut, chaque fonctionnalité utilise le modèle de conversation de la connexion.

Chaque paramètre possède une clé ConnectionId et une clé Model, par exemple AISettings.Rewrite.ConnectionId (AM_AISETTINGS_REWRITE_CONNECTIONID). Un Model vide utilise le modèle par défaut de la connexion.

Les fonctionnalités intégrées utilisent les limites de la connexion, mais pas son audience : toute personne pouvant utiliser la fonctionnalité peut utiliser sa connexion. Une connexion nécessitant une attention, ou supprimée, fait échouer la fonctionnalité jusqu'à ce que vous en sélectionniez une autre : la page l'indique.

Agents IA

L'application Agents (id mattermost-ai) est activée par défaut. Sa configuration se fait en deux étapes : ajouter un service (une connexion à un fournisseur de modèles), puis créer des agents (des bots qui utilisent un service).

1. Ajouter un service

Accédez à Console système › Plugins › Agents et, sous Services IA, cliquez sur Ajouter un service IA. Choisissez le Type de service :

• Compatible OpenAI : pour un serveur de modèle que vous exécutez vous-même, ou tout fournisseur disposant d’une API de type OpenAI. Renseignez URL de base de l’API (par exemple http://ollama:11434/v1 ou http://vllm.internal:8000/v1) et Clé API uniquement si le serveur en exige une. Si le serveur ne prend en charge que l’API Chat Completions, désactivez Utiliser l’API Responses.
• OpenAI, Anthropic, Google Gemini, Google Vertex AI, AWS Bedrock, Azure, Cohere, Mistral : fournisseurs hébergés. Chacun nécessite sa Clé API (Bedrock : une région AWS et des identifiants ou un rôle IAM ; Vertex AI : un projet, une région et un compte de service ; Azure : l’URL de l’API également).

Ensuite, définissez le Modèle par défaut (une liste si le fournisseur peut signaler ses modèles, sinon saisissez le nom), ainsi que, si le fournisseur ne les signale pas, la Limite de jetons d'entrée et la Limite de jetons de sortie. Un Service de secours peut prendre le relais en cas d'échec. Enregistrez.

Le serveur effectue ces requêtes lui-même, il doit donc pouvoir accéder à l'API : un serveur de modèle dans le même projet compose, sur votre réseau, ou sur Internet. Les requêtes sortantes respectent les variables HTTP_PROXY et HTTPS_PROXY.

2. Créer des agents

Les agents sont créés sur la page Agents de l’application web : ouvrez-la via Gérer dans le sélecteur d’agents du panneau Agents (dans l’interface classique, également depuis le menu du produit). Son adresse est https://chat.example.com/plug/mattermost-ai/agents. Chaque agent possède un Nom d'affichage, un Nom d'utilisateur d'agent (la façon dont les personnes le mentionnent), un Service et, en option, un modèle, des Instructions personnalisées, ainsi que des interrupteurs pour Activer la vision (images) et Activer les outils. Son onglet Accès limite les canaux dans lesquels il peut être utilisé et les utilisateurs qui peuvent l'utiliser. Sous Fonctions IA dans la Console système, Bot par défaut choisit l'agent utilisé lorsqu'aucun n'est sélectionné, par exemple pour les résumés d'appels.

Fonctionnalités optionnelles de l'application Agents

• Recherche par intégration (expérimental, désactivé) : recherche sémantique sur les messages. Elle nécessite PostgreSQL avec l'extension pgvector et un modèle d'intégration (OpenAI ou compatible OpenAI). Elle envoie chaque message au modèle d'intégration, y compris les canaux privés et les messages personnels.
• Recherche web (désactivé) : permet aux agents de rechercher sur le web via Google, Brave ou un serveur SearXNG que vous exécutez.
• Outils natifs : avec les fournisseurs qui les proposent, les agents peuvent utiliser la recherche web propre du fournisseur (activée par défaut pour les nouveaux agents, si supportée), la récupération web et l'exécution de code. Ces opérations s'exécutent chez le fournisseur. Désactivez-les par agent.
• Protocole de contexte de modèle (MCP) : connectez les agents à des serveurs MCP auxquels vous faites confiance, pour des outils supplémentaires.
• Débogage : Sortie de trace (désactivé, journaux du serveur ou un point de terminaison OpenTelemetry) et Activer la journalisation de l'utilisation des jetons, qui écrit les nombres de jetons dans logs/agents/token_usage.log.

Conversion de la parole en texte : transcriptions d'appels et sous-titres

Les appels peuvent être transcrits, avec des sous-titres en direct, par un serveur de reconnaissance vocale offrant un point de terminaison /v1/audio/transcriptions compatible OpenAI. La configuration se trouve dans Appels et voix. Si Résumer les transcriptions est activé, l'agent par défaut publie également un résumé de chaque transcription.

Synthèse vocale : lecture à voix haute

Lorsque la synthèse vocale est activée, le menu de chaque message propose Lire à voix haute : le serveur envoie le texte du message à une API de synthèse vocale et lit l'audio. Paramètres dans Console système › Intégrations › Synthèse vocale :

Pour utiliser une connexion de modèle au lieu de l'adresse et de la clé ci-dessus, sélectionnez-la pour Synthèse vocale dans IA › Fonctionnalités intégrées. La page indique alors que les messages sont lus à voix haute avec cette connexion : URL de base de l’API et Clé API ne sont pas utilisés, Voix l'est toujours, ainsi que Modèle lorsque la connexion ne spécifie pas de modèle. Lire les messages à voix haute doit toujours être activé.

Avant l'envoi, le serveur supprime les blocs de code, les liens, les codes emoji et la mise en forme, et conserve au maximum 4000 caractères. Il demande un audio MP3 et conserve les 64 derniers résultats en mémoire, de sorte qu'un message lu deux fois n'est envoyé qu'une seule fois.

Traduction automatique

La traduction automatique affiche les messages d’un canal dans la langue de chaque lecteur. Configurez-la dans Console système › Configuration du site › Paramètres linguistiques, sous Traduction automatique :

Chaque fournisseur a ses propres champs :

• Connexion de modèle : une connexion au niveau du serveur et son modèle, la même configuration que Traduction automatique dans IA › Fonctionnalités intégrées (AISettings.AutoTranslation). Un modèle de traduction dédié est rapide et précis ; un LLM généraliste fonctionne également.
• LibreTranslate : Point de terminaison de l’API LibreTranslate et Clé API LibreTranslate (AutoTranslationSettings.LibreTranslate.URL, .APIKey). Un serveur LibreTranslate peut être exécuté sur votre propre réseau.
• API compatible OpenAI : URL de base de l’API (jusqu’à et y compris /v1 ; le serveur utilise son point de terminaison de complétion de discussion), Modèle et Clé API (AutoTranslationSettings.OpenAI.URL, .Model, .APIKey). Un petit modèle de traduction exécuté localement fonctionne bien.
• Service de l'application de chat IA (ancien) : le fournisseur des serveurs configurés avant la version 0.9.0, qui utilisaient un service de l'application Agents. Il n'a plus besoin de l'application : il traduit avec la connexion sélectionnée pour la traduction automatique dans IA › Fonctionnalités intégrées, ou sinon avec la connexion copiée depuis le service de l'application lors de la mise à niveau. Passer à la connexion de modèle déplace la configuration vers le fournisseur recommandé.

Une fois activée, les administrateurs de canal activent la traduction pour un canal dans ses paramètres (Traduction automatique), et chaque membre peut s’en exclure depuis le menu du canal (Traduire les messages). Dans les messages personnels et de groupe, n’importe quel membre peut l’activer ; avec la restriction activée, la traduction n’est pas disponible dans ces contextes. Les messages traduits affichent « Traduit de … » avec un lien vers l’original.

Le code, les liens, les mentions et les emojis sont remplacés par des espaces réservés avant l'envoi du texte, puis rétablis ensuite.

Où va chaque donnée

Pour garder tout cela sur votre réseau, pointez chaque fonctionnalité vers des serveurs que vous exploitez vous-même. Avec un fournisseur cloud, vérifiez ses conditions de conservation des données et informez vos utilisateurs des fonctionnalités qui envoient leurs messages à l'extérieur.

Désactiver l'IA

Il n'y a pas d'interrupteur unique : chaque fonctionnalité a le sien.

• Réécriture et résumés : définissez-les sur Désactivé dans Console système › IA › Fonctionnalités intégrées. Les utilisateurs continuent de lire les résumés dont ils disposent déjà.
• Connexions aux modèles : supprimez une connexion pour en stopper toute utilisation. Sans aucune connexion, ni les fonctionnalités intégrées ni les applications ne peuvent utiliser l'IA via le serveur.
• Agents : désactivez l'application Agents dans Console système › Plugins › Gestion des plugins. Cela supprime également les résumés d'appels.
• Transcription et sous-titres : AM_CALLS_ENABLE_TRANSCRIPTIONS=false et AM_CALLS_ENABLE_LIVE_CAPTIONS=false (les valeurs par défaut).
• Lire à voix haute : désactivez Lire les messages à voix haute (AM_TEXTTOSPEECHSETTINGS_ENABLE=false, la valeur par défaut), qu'il utilise une connexion ou non.
• Traduction : désactivez la traduction automatique (AM_AUTOTRANSLATIONSETTINGS_ENABLE=false, la valeur par défaut).

La désactivation de l'application Agents ne désactive pas les autres fonctionnalités : elles utilisent des connexions aux modèles ou leurs propres API.