Comment configurer l'assistant IA
Connectez Agon au fournisseur d'IA de votre choix, et l'Assistant IA de support, le Mode Actions IA et les réponses de conseil en gestion se mettent à fonctionner. Le moyen le plus rapide est une clé API Google Gemini gratuite, et cela prend environ 3 minutes.
Comment fonctionne l'assistant IA dans Agon
Agon fonctionne sur votre propre ordinateur, tout comme la configuration de son assistant IA. L'assistant utilise une clé de fournisseur d'IA qui appartient à votre studio : vous créez la clé chez le fournisseur, vous la collez dans Agon, et Agon communique directement avec ce fournisseur. Agon n'exploite aucun service d'IA propre, et aucun service d'IA n'est fourni avec Agon.
Vous avez trois options :
| Option | Ce qu'il vous faut | Idéal pour |
|---|---|---|
| Google Gemini (recommandé pour commencer) | Un compte Google | Démarrer en quelques minutes |
| Groq | Un compte Groq | Un autre fournisseur aux réponses rapides |
| Un modèle local avec Ollama | Un ordinateur raisonnablement puissant | Garder tous les prompts sur votre propre machine |
Si vous ne configurez rien, l'assistant fonctionne quand même en mode de base (voir ci-dessous).
Qu'est-ce que le mode de base ?
Sans fournisseur d'IA, le panneau de l'assistant devient une recherche dans la documentation. Vous saisissez quelques mots-clés et Agon affiche les articles d'aide les plus pertinents, directement issus de cette documentation. Le mode de base :
- fonctionne entièrement sur votre ordinateur, sans connexion Internet et sans IA ;
- ne peut ni répondre à des questions libres, ni effectuer des actions IA, ni donner de conseils de gestion ;
- affiche un bouton Configurer l'IA dans les Paramètres qui vous ramène à cette configuration.
Paramètres → Assistant IA affiche Non configuré · mode de base tant qu'aucun fournisseur n'est connecté.
Avant de commencer
- Seul le compte studio manager peut configurer l'assistant IA.
- Lisez Confidentialité : où vont vos prompts ci-dessous, surtout si vous comptez mentionner des informations sur vos clients dans le chat.
- Traitez une clé API comme un mot de passe. Quiconque la possède peut utiliser votre compte chez le fournisseur.
Créer une clé API Gemini en 3 minutes
- Ouvrez la page des clés API de Google AI Studio dans votre navigateur et connectez-vous avec votre compte Google.
- Cliquez sur Create API key (Google peut l'appeler Get API key ; avec une interface en français, le libellé est traduit). Si Google vous demande de choisir ou de créer un projet, acceptez celui proposé par défaut.
- Cliquez sur l'icône de copie à côté de votre nouvelle clé. C'est une longue suite de lettres et de chiffres.
- Dans Agon, ouvrez Paramètres → Assistant IA. [SCREENSHOT: Paramètres → Assistant IA avec la liste des fournisseurs et le champ Clé API]
- Sous Fournisseur d'IA, choisissez Google Gemini.
- Collez la clé dans le champ Clé API et cliquez sur Vérifier et enregistrer.
- Agon teste immédiatement la clé auprès de Google. Quand elle fonctionne, vous voyez Clé API enregistrée et vérifiée. et un badge Clé active · Google Gemini.
C'est tout : ouvrez l'assistant et posez-lui une question.
Les écrans de Google changent de temps en temps. Si un bouton porte un autre nom, cherchez « API keys » dans le menu de Google AI Studio. Le lien Obtenir une clé API Google Gemini à côté de la liste des fournisseurs dans Agon ouvre toujours la bonne page.
Utiliser Groq à la place
- Ouvrez la page des clés API de la console Groq et connectez-vous ou créez un compte.
- Cliquez sur Create API Key, donnez-lui un nom (par exemple « Agon ») et copiez la clé. Groq ne l'affiche qu'une seule fois.
- Dans Agon, ouvrez Paramètres → Assistant IA, choisissez Groq sous Fournisseur d'IA, collez la clé dans Clé API et cliquez sur Vérifier et enregistrer.
Un badge Clé active · Groq confirme que tout fonctionne.
Utiliser un modèle local avec Ollama
Avec Ollama, le modèle d'IA s'exécute sur votre propre ordinateur : les prompts ne le quittent donc jamais. Il vous faut un ordinateur avec suffisamment de mémoire pour faire tourner un modèle. Les réponses sont généralement plus lentes que celles d'un fournisseur dans le cloud, et leur qualité dépend du modèle choisi. C'est une option avancée. Aucune clé API n'est nécessaire, et vous n'avez jamais besoin de modifier un fichier ni de redémarrer Agon.
- Téléchargez et installez Ollama depuis ollama.com, puis téléchargez au moins un
modèle, par exemple en exécutant
ollama pull llama3.1dans un terminal. Ollama doit être en cours d'exécution chaque fois que vous utilisez l'assistant. - Dans Agon, ouvrez Paramètres → Assistant IA. [SCREENSHOT: Paramètres → Assistant IA avec Ollama (local) sélectionné et le sélecteur de modèle]
- Sous Fournisseur IA, choisissez Ollama (local).
- Agon vérifie si Ollama est accessible sur votre ordinateur :
- Si Ollama n'est pas accessible, la page vous le signale et propose un lien Installer Ollama. C'est le message normal pour qui n'a pas encore installé ou démarré Ollama : c'est une indication, pas une erreur. Installez Ollama (ou assurez-vous qu'il est en cours d'exécution), puis revenez sur cette page.
- Si Ollama est en cours d'exécution mais qu'aucun modèle n'a encore été téléchargé, la page vous
demande d'ouvrir un terminal et d'exécuter
ollama pull <modèle>(par exempleollama pull llama3.1), puis de revenir ici.
- Une fois au moins un modèle installé, choisissez-le dans le menu déroulant Modèle — qui remplace le champ Clé API pour ce fournisseur — puis cliquez sur Vérifier et enregistrer.
Voilà : aucun fichier .env, pas besoin de quitter Agon, pas de redémarrage. Le changement prend effet
immédiatement, tout comme l'enregistrement d'une clé Gemini ou Groq.
Paramètres → Assistant IA affiche désormais Configuré · Ollama (local). Si vous enregistrez plus tard une clé de fournisseur avec Utiliser plutôt votre propre clé de fournisseur, cette clé a la priorité sur le modèle local.
Confidentialité : où vont vos prompts
- Directement de votre ordinateur au fournisseur choisi. Lorsque vous utilisez Gemini ou Groq, votre question et les informations dont l'assistant a besoin pour y répondre vont directement de l'ordinateur qui exécute Agon à ce fournisseur. Elles ne passent jamais par le développeur d'Agon ni par un serveur exploité pour Agon.
- Avec Ollama, rien ne quitte votre ordinateur.
- Votre clé reste sur votre ordinateur. Agon la stocke chiffrée dans la base de données locale de votre studio et ne l'affiche plus jamais après l'enregistrement. Supprimer la clé dans Paramètres → Assistant IA l'efface à tout moment.
- Les offres gratuites peuvent utiliser vos données. Les offres gratuites de certains fournisseurs peuvent utiliser les données que vous envoyez pour entraîner ou améliorer leurs modèles. Pour les questions qui contiennent des données de vos clients, utilisez une offre payante ou un modèle local. Les conditions évoluent : vérifiez les conditions actuelles et la politique de confidentialité de votre fournisseur avant de commencer : conditions de l'API Gemini · politique de confidentialité de Groq.
- Votre studio garde le contrôle. C'est votre studio qui a le contrat avec le fournisseur : au sens du RGPD, ce fournisseur est donc un sous-traitant de votre studio. Le guide RGPD explique ce que cela implique pour vous.
Une bonne habitude : ne collez pas d'informations sensibles sur vos clients (des notes de santé, par exemple) dans le chat à moins d'être à l'aise avec les conditions de votre fournisseur.
Si vous prévoyez une utilisation intensive
Chaque fournisseur limite le nombre de requêtes qu'une clé peut effectuer par minute et par jour. Les offres gratuites ont des limites basses. Si plusieurs personnes utilisent l'assistant en même temps, ou si vous utilisez le Mode Actions IA aux heures de pointe, vous pouvez voir un message indiquant que votre fournisseur d'IA limite les requêtes.
Pour y remédier, relevez vos limites auprès du fournisseur :
- Google Gemini : activez la facturation sur le projet Google Cloud auquel appartient votre clé. Google AI Studio affiche votre niveau actuel et comment passer au niveau supérieur.
- Groq : consultez vos limites et les options de mise à niveau dans la console Groq.
La même clé continue de fonctionner dans Agon après la mise à niveau. Vous n'avez pas besoin d'une nouvelle clé et il n'y a rien à changer dans Agon. Le fournisseur vous facture directement tout ce qui dépasse son offre gratuite. Une offre payante est aussi le choix recommandé pour les données de clients (voir la section sur la confidentialité ci-dessus).
Que faire si quelque chose ne fonctionne pas ?
Agon indique que ma clé n'est pas valide Vérifiez que vous avez copié la clé entière sans espaces superflus, et que le fournisseur choisi correspond à la clé : une clé Groq ne fonctionne pas comme clé Gemini. Assurez-vous que la clé n'a pas été supprimée dans la console du fournisseur. Une clé toute neuve peut mettre une minute à fonctionner : patientez et cliquez de nouveau sur Vérifier et enregistrer.
L'assistant indique que mon fournisseur d'IA limite les requêtes Vous avez atteint la limite de votre fournisseur. Attendez une minute et réessayez, ou relevez vos limites (voir Si vous prévoyez une utilisation intensive).
L'assistant n'affiche que des articles d'aide L'assistant est en mode de base car aucun fournisseur n'est connecté. Suivez les étapes ci-dessus pour ajouter une clé. Paramètres → Assistant IA affiche Non configuré · mode de base lorsqu'aucun fournisseur n'est actif.
J'obtiens « Cette action nécessite Agon AI, qui est désactivé » au milieu d'une action Le Mode Actions IA ne peut pas terminer une demande sans fournisseur. Ajoutez une clé dans Paramètres → Assistant IA, puis refaites votre demande.
Ma clé fonctionnait et maintenant l'assistant échoue La clé a peut-être été supprimée, a expiré ou a épuisé son quota chez le fournisseur. Créez une nouvelle clé et enregistrez-la avec Modifier dans Paramètres → Assistant IA.
Je veux changer de fournisseur ou remplacer ma clé Dans Paramètres → Assistant IA, cliquez sur Modifier à côté du badge Clé active, choisissez le fournisseur, collez la nouvelle clé et cliquez sur Vérifier et enregistrer.
Je veux arrêter d'utiliser ma clé Dans Paramètres → Assistant IA, cliquez sur Supprimer la clé et confirmez. Agon efface la clé de la base de données de votre studio et l'assistant passe immédiatement en mode de base, sans redémarrage. Si vous pensez que la clé a pu fuiter, supprimez-la (révoquez-la) également dans la console de votre fournisseur (Google AI Studio ou la console Groq) pour que personne d'autre ne puisse l'utiliser.
Paramètres → Assistant IA indique qu'Ollama (local) n'est pas accessible Ollama n'est pas installé ou n'est pas en cours d'exécution. Installez-le depuis ollama.com (ou démarrez-le s'il est déjà installé), puis rouvrez Paramètres → Assistant IA : la vérification se refait automatiquement, sans rien à redémarrer.
Aucun modèle n'apparaît dans le menu déroulant
Ouvrez un terminal et exécutez ollama pull <modèle> (par exemple ollama pull llama3.1) pour
télécharger un modèle, puis rouvrez le menu Fournisseur IA, ou quittez et revenez sur
Paramètres → Assistant IA, pour qu'il retrouve le modèle que vous venez de télécharger.
Questions fréquentes
L'assistant IA est-il payant ? Agon ne le facture pas. Votre fournisseur peut le faire : les offres gratuites ont des limites d'utilisation, et tout ce qui les dépasse vous est facturé directement par le fournisseur.
Le développeur d'Agon peut-il voir mes questions ? Non. Les prompts vont de votre ordinateur directement au fournisseur choisi, ou restent sur votre ordinateur avec Ollama.
Quel fournisseur choisir ? Gemini est le plus rapide à configurer. Pour les données de clients, une offre payante de n'importe quel fournisseur ou un modèle local est le choix le plus sûr.