Chatbot IA — Connecter Mistral AI : récupérer la clé API et la configurer dans Thaïs
Le chatbot IA de Thaïs a besoin d'une clé API pour fonctionner : c'est le mot de passe technique qui autorise Thaïs à dialoguer avec le fournisseur de modèle. Ce guide couvre Mistral AI de bout en bout : créer la clé chez le fournisseur, puis la renseigner dans Thaïs.
Tout se passe dans le module CONFIG → Chatbot IA → onglet Mistral AI.
1. À savoir avant de commencer
Fournisseur | Mistral AI |
|---|---|
Où créer la clé | |
Format de la clé | une longue suite de caractères (sans préfixe particulier) |
Modèle proposé par défaut dans Thaïs |
|
Pourquoi le choisir | le champion français, hébergé en Europe — le choix privilégié si la confidentialité et le RGPD sont votre priorité. |
⚠️ L'abonnement à l'application Le Chat ne donne pas accès à l'API : la clé API se crée dans la console développeur, avec sa propre facturation.
2. Créer votre clé API chez Mistral AI
- Connectez-vous sur console.mistral.ai.
- Ouvrez la rubrique API Keys (adresse directe : console.mistral.ai/api-keys).
- Cliquez sur Create new key, nommez-la — par exemple
Thais-PMS— puis validez. - Copiez la clé immédiatement : elle ne sera plus réaffichée ensuite.
🔑 La clé ne s'affiche qu'une seule fois. Copiez-la tout de suite, collez-la dans Thaïs dans la minute qui suit. Si vous l'avez perdue, ce n'est pas grave : supprimez-la et créez-en une nouvelle.
Activer la facturation
Une clé sans crédit ne fonctionne pas. C'est la cause n°1 des « le chatbot ne répond pas » juste après une installation.
- Ouvrez Workspace → Billing et activez un plan (une vérification par téléphone peut être demandée).
- Un palier d'essai gratuit existe, avec des limites d'appels par minute : suffisant pour tester, parfois juste en usage quotidien.
- Pour un usage régulier, ajoutez un moyen de paiement afin d'éviter les blocages de débit.
3. Renseigner la clé dans Thaïs
Ouvrez le module CONFIG, puis Chatbot IA dans le menu de gauche : vous arrivez sur l'onglet Fournisseurs, qui regroupe les cinq fournisseurs pris en charge (DeepSeek, Anthropic, OpenAI, Mistral AI, OpenRouter).
- Sélectionnez l'onglet Mistral AI.
- Collez votre clé dans le champ Clé API.
- Cliquez sur Sauvegarder en bas de page.
Une fois la clé enregistrée, Thaïs ne l'affiche plus en clair : le libellé devient « Clé API (clé enregistrée : …xxxx) » avec les 4 derniers caractères, ce qui vous permet de vérifier quelle clé est en place sans jamais l'exposer.
Choisir le modèle
Le sélecteur Modèle reste grisé tant qu'aucune clé n'est enregistrée — le message « Enregistrez une clé API pour découvrir les modèles disponibles » vous le rappelle. C'est normal : Thaïs a besoin de la clé pour interroger le fournisseur et récupérer la liste des modèles auxquels votre compte a droit.
Après la sauvegarde, ouvrez le sélecteur et choisissez votre modèle. En cas de doute, gardez celui proposé par défaut (mistral-large-latest).
Régler les deux derniers paramètres
Paramètre | Rôle | Valeur conseillée |
|---|---|---|
Itérations max | Nombre d'aller-retours que le chatbot peut enchaîner pour aller chercher l'information avant de répondre. | 5 (3 suffit pour des questions simples) |
Température | Créativité de la réponse. Basse = factuelle et stable, haute = plus libre. | 0,2 — on veut des réponses fiables, pas créatives |
Activer le fournisseur
- Cochez Activer ce fournisseur.
- Cliquez sur Sauvegarder.
ℹ️ Un seul fournisseur peut être actif à la fois. En activant Mistral AI, Thaïs désactive automatiquement les autres. Vos clés déjà enregistrées ne sont pas perdues pour autant : vous pouvez rebasculer d'un fournisseur à l'autre en deux clics, ce qui est très pratique pour comparer les réponses ou pour dépanner en cas de panne chez un éditeur.
Un message de confirmation s'affiche en bas de page. Le champ Prompt système, commun à tous les fournisseurs, sert à donner le contexte de votre établissement au chatbot : il n'est pas à modifier pour une première mise en route.
4. Vérifier que tout fonctionne
Posez une question simple au chatbot, par exemple « Combien de chambres sont libres ce soir ? ». Si la réponse arrive, la configuration est bonne.
Symptôme | Cause la plus probable | Ce qu'il faut faire |
|---|---|---|
Le sélecteur Modèle reste grisé | Aucune clé enregistrée pour cet onglet | Collez la clé, puis Sauvegarder avant de revenir au sélecteur |
Erreur d'authentification / clé invalide | Clé incomplète (copier-coller partiel) ou clé supprimée chez le fournisseur | Recréez une clé et collez-la en entier, sans espace avant ni après |
« Quota dépassé » ou aucune réponse | Compte sans crédit chez le fournisseur | Créditez le compte Mistral AI |
Le chatbot répond mais ignore vos données | Le fournisseur n'est pas celui que vous croyez | Vérifiez quel onglet porte la mention Actif |
Rien ne change après modification | Sauvegarde oubliée | Cliquez sur Sauvegarder en bas de page |
5. Sécurité : traitez la clé comme un code de carte bancaire
- Ne la partagez jamais par e-mail ni par chat, y compris avec notre support : nous n'avons jamais besoin de votre clé.
- Une clé par usage : créez-en une dédiée à Thaïs, jamais celle qui sert déjà ailleurs. En cas de problème, vous la révoquez sans rien casser d'autre.
- Fuite suspectée ? Supprimez la clé chez Mistral AI, créez-en une nouvelle et collez-la dans Thaïs. La clé supprimée devient inutilisable dans la seconde.
- Surveillez la consommation sur la console du fournisseur : c'est le meilleur détecteur d'un usage anormal.
Besoin d'aide ? Notre équipe support répond directement depuis le chat de Thaïs — inutile de nous transmettre votre clé API.
Mis à jour le : 26/08/2026
Merci !