Configuration de l'IA
Campbooks utilise l'IA pour le tri de la boîte de réception, l'analyse de documents, les brouillons de réponse et l'assistant Scout. L'IA est facultative — l'application fonctionne entièrement sans elle, et ces fonctionnalités s'activent dès que vous ajoutez une clé de fournisseur. Vous pouvez mélanger des fournisseurs et les affecter à différentes tâches.
Deux rôles : texte et vision
Quel que soit le nombre de tâches IA, la configuration se résume à choisir deux modèles :
- Un modèle texte — alimente le tri, le chat, les résumés, les brouillons de réponse et les rappels. Tout fournisseur convient.
- Un modèle vision — lit les pièces jointes de documents pour les classifier et les extraire. Doit être un fournisseur compatible vision (OpenAI, Anthropic ou Gemini).
Si vous définissez une seule clé OpenAI, elle couvre les deux rôles plus les embeddings utilisés pour la recherche sémantique. C'est la configuration la plus simple possible.
Les services IA
Sous le capot, ces deux rôles se répartissent entre huit services, chacun pouvant utiliser un fournisseur différent si vous souhaitez un contrôle granulaire :
| Service | Rôle | Fonction |
|---|---|---|
| Analyse de documents | Vision | Classifier et extraire les pièces jointes |
| Classification d'e-mails | Texte | Catégoriser les e-mails entrants |
| Analyse d'e-mails | Texte | Extraire les éléments d'action et les signaux |
| Extraction de rappels | Texte | Repérer les engagements datés et les transformer en rappels |
| Chat e-mail | Texte | Discuter d'un fil d'e-mail spécifique |
| Brouillon de réponse | Texte | Générer des brouillons de réponse aux e-mails |
| Chat de rédaction | Texte | Assister lors de la rédaction d'un message |
| Chat global | Texte | L'assistant Scout |
Fournisseurs
Campbooks prend en charge cinq fournisseurs. Trois sont compatibles vision (nécessaires pour l'analyse de documents) ; les cinq gèrent le texte.
| Fournisseur | Vision | Résidence des données | Clé d'environnement |
|---|---|---|---|
| OpenAI | ✓ | US | OPENAI_API_KEY |
| Anthropic (Claude) | ✓ | US | ANTHROPIC_API_KEY |
| Gemini | ✓ | US | GEMINI_API_KEY |
| Mistral | — | EU | MISTRAL_API_KEY |
| DeepSeek | — | Chine | DEEPSEEK_API_KEY |
La résidence des données est importante pour le RGPD. Mistral traite en EU, c'est pourquoi c'est le choix par défaut préféré pour les utilisateurs européens ; les autres impliquent des transferts internationaux, et DeepSeek (Chine) ne bénéficie d'aucune décision d'adéquation de l'UE. La région du fournisseur est affichée dans les paramètres IA afin que vous puissiez choisir en connaissance de cause.
Modèles
Chaque fournisseur expose plusieurs modèles ; choisissez-en un par service (la valeur par défaut est en gras) :
| Fournisseur | Modèles |
|---|---|
| Anthropic | claude-sonnet-4-6, claude-haiku-4-5, claude-opus-4-7, claude-sonnet-4-5 |
| OpenAI | gpt-4o, gpt-4o-mini, gpt-4-turbo, gpt-4, o3-mini, o4-mini |
| Mistral | mistral-large-latest, mistral-medium-latest, mistral-small-latest, ministral-8b-latest |
| DeepSeek | deepseek-v4-pro, deepseek-chat, deepseek-reasoner |
| Gemini | gemini-2.5-flash, gemini-2.5-pro, gemini-2.0-flash, gemini-1.5-pro, gemini-1.5-flash |
D'où viennent les clés
Il y a deux façons de fournir des clés :
- Auto-hébergé (à l'échelle de l'instance) : définissez les clés d'environnement du fournisseur ci-dessus dans
.env. AvecSELF_HOSTED=1, l'application les lit et chaque espace de travail peut utiliser l'IA sans saisir sa propre clé. - Par espace de travail (apportez la vôtre) : un utilisateur ajoute une clé dans Paramètres → IA. Elle est chiffrée au repos et limitée à cet espace de travail.
Ajouter un adaptateur IA
- Allez dans Paramètres → IA et cliquez sur Ajouter un adaptateur.
- Choisissez le fournisseur (OpenAI, Anthropic, Mistral, DeepSeek ou Gemini).
- Saisissez la clé API — ou laissez-la vide pour utiliser la clé d'environnement de l'instance (auto-hébergé).
- Définissez optionnellement une URL de point de terminaison personnalisée pour router via une passerelle compatible OpenAI ou un serveur de modèle auto-hébergé/local (l'URL est validée pour bloquer les requêtes vers l'infrastructure interne).
- Choisissez le modèle.
Ensuite, assignez l'adaptateur aux services qui doivent l'utiliser — ou définissez simplement les deux rôles lors de la configuration et laissez-les se répartir.
Affecter des adaptateurs aux services
Chaque service peut utiliser un adaptateur différent. Dans Paramètres → IA, développez un service et choisissez son adaptateur. Le changement prend effet immédiatement — vous pouvez donc utiliser un modèle rapide et économique pour la classification et un modèle plus performant pour l'analyse et le chat.
L'analyse de documents nécessite un fournisseur vision. Si vous assignez un fournisseur texte uniquement (DeepSeek ou Mistral) à l'analyse de documents, l'application ne vous laissera pas enregistrer. Utilisez OpenAI, Anthropic ou Gemini pour ce service.
Recherche sémantique
Les embeddings alimentent la recherche sémantique dans les e-mails et les documents, et sont produits par OpenAI ou Gemini. Sans aucun des deux configuré, la recherche fonctionne quand même — elle se rabat sur la correspondance par mots-clés (ILIKE).
Tests
Après avoir configuré un adaptateur, testez-le en envoyant un message dans Scout ou en retraitant un document. En cas d'erreur, vérifiez que la clé API et (si défini) le point de terminaison sont corrects, que le nom du modèle est accepté par le fournisseur, et que le fournisseur prend en charge la fonctionnalité utilisée (p. ex. la vision pour l'analyse de documents).