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

1. Ouvrez la page des clés API de Google AI Studio dans votre navigateur et connectez-vous avec votre compte Google.
2. 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.
3. Cliquez sur l'icône de copie à côté de votre nouvelle clé. C'est une longue suite de lettres et de chiffres.
4. Dans Agon, ouvrez Paramètres → Assistant IA. [SCREENSHOT: Paramètres → Assistant IA avec la liste des fournisseurs et le champ Clé API]
5. Sous Fournisseur d'IA, choisissez Google Gemini.
6. Collez la clé dans le champ Clé API et cliquez sur Vérifier et enregistrer.
7. 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

1. Ouvrez la page des clés API de la console Groq et connectez-vous ou créez un compte.
2. Cliquez sur Create API Key, donnez-lui un nom (par exemple « Agon ») et copiez la clé. Groq ne l'affiche qu'une seule fois.
3. 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.

1. Téléchargez et installez Ollama depuis ollama.com, puis téléchargez un modèle, par exemple en exécutant ollama pull llama3.1 dans un terminal. Ollama doit être en cours d'exécution chaque fois que vous utilisez l'assistant.

2. Quittez Agon.

3. Ouvrez le dossier de données d'Agon :

   • macOS : ~/Library/Application Support/Agon
   • Windows : %APPDATA%\Agon

4. Ouvrez le fichier nommé .env dans un éditeur de texte brut (sur macOS il est masqué : appuyez sur Cmd + Maj + . dans le Finder pour l'afficher). Ne modifiez pas et ne supprimez pas les lignes qu'il contient déjà : elles contiennent les clés secrètes qui protègent les données de votre studio. Ajoutez ces deux lignes à la fin, avec le nom du modèle que vous avez téléchargé :

   LLM_PROVIDER=ollama
   LLM_MODEL=ollama_chat/llama3.1

5. Enregistrez le fichier et relancez Agon.

Paramètres → Assistant IA affiche désormais Actif · modèle 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.

Le modèle local ne fonctionne pas Vérifiez qu'Ollama est en cours d'exécution et que le nom du modèle dans le fichier .env correspond à un modèle que vous avez téléchargé (ollama list les affiche). Redémarrez Agon après toute modification du fichier .env.

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.

Pages associées

• Assistant IA de support
• Mode Actions IA
• Guide RGPD pour les studio managers
• Paramètres