🤖 Guide de configuration de l'IA

L'IA irrigue presque tous les modules d'OKNote : résumés de notes, traduction, génération de graphiques, synthèses de messagerie, réponses IA rédigées, rapports hebdomadaires et mensuels... tout partage une seule et même configuration. Configure une fois, débloque tout, avec une seule clé API d'un fournisseur de modèles.

1. Trois minutes pour configurer

Ouvre Réglages (⌘,) → Configuration IA :

1. Choisis un fournisseur : le menu déroulant propose des préréglages pour les principaux fournisseurs —

   Type	Fournisseurs
   Basés en Chine	DeepSeek, Zhipu GLM, Kimi (Moonshot), Qwen (Alibaba), Doubao (Volcengine), SiliconFlow, Tencent Hunyuan, Baidu Ernie
   Internationaux	OpenAI, Anthropic Claude, Google Gemini, xAI Grok, OpenRouter, Mistral, Groq
   Local / personnalisé	Ollama, LM Studio, Personnalisé (tout point de terminaison compatible OpenAI)

   Une fois choisi, l'URL de base se remplit automatiquement — tu n'as généralement pas besoin d'y toucher.

2. Saisis ta clé API : colle la clé générée sur le site du fournisseur (tutoriel ci-dessous).

3. Choisis un modèle : le champ suggère les modèles recommandés par ce fournisseur — clique simplement sur l'un d'eux.

4. Clique sur « Tester » : une connexion réussie affiche la réponse du modèle et la latence ; en cas d'échec, vérifie la clé et le solde de ton compte.

5. Enregistre. Terminé !

🔒 Ta clé API est stockée sur ton propre serveur, chiffrée en AES-256 — elle n'est jamais envoyée à un tiers.

2. Comment obtenir une clé API

Le principe est globalement le même partout : inscris-toi sur le site du fournisseur → ouvre la console développeur/API → crée une clé API → copie-la. Deux exemples :

DeepSeek (excellent rapport qualité-prix, très populaire en Chine)

1. Va sur platform.deepseek.com, inscris-toi et connecte-toi.
2. Dans le menu de gauche, ouvre « API Keys » et clique sur « Create API Key ».
3. Copie la clé générée (elle commence par sk-, affichée une seule fois) — recharge un petit montant et elle dure longtemps.

OpenAI

1. Va sur platform.openai.com, connecte-toi, et ouvre « API keys ».
2. Clique sur « Create new secret key », puis copie-la et conserve-la.

Zhipu (open.bigmodel.cn), Kimi (platform.moonshot.cn), Qwen (la console Bailian d'Alibaba Cloud) et d'autres fonctionnent de la même façon — crée une clé API sur la page « API Keys » de leur plateforme développeur.

Ollama, modèles locaux (entièrement gratuit, tes données ne quittent jamais ta machine)

1. Installe Ollama sur ton serveur (ou ta propre machine) — télécharge-le sur ollama.com.
2. Lance ollama pull qwen3 (ou n'importe quel modèle de ton choix) dans un terminal.
3. Dans OKNote, choisis « Ollama (local) » comme fournisseur. L'URL de base est par défaut http://localhost:11434, aucune clé API requise — saisis simplement le nom du modèle que tu as téléchargé et teste.

Remarque : les modèles locaux (Ollama / LM Studio), les fournisseurs personnalisés, et la configuration de plusieurs fournisseurs sont des fonctionnalités avancées réservées selon ton niveau de licence ; si une option affiche une icône de cadenas, elle n'est pas incluse dans ton forfait actuel.

3. Avancé : une IA différente par module

Les Réglages proposent un commutateur « Configuration par module » (réservé selon le niveau de licence). Active-le pour définir des fournisseurs/modèles distincts pour :

• IA Notes / Rapports — résumés de notes, traduction, graphiques, rapports hebdomadaires/mensuels de tâches
• IA Messagerie — résumés de messagerie, classification, réponses IA rédigées

Un schéma courant : utiliser un modèle puissant pour les notes/rapports (la qualité compte pour les rapports hebdomadaires), et un modèle rapide et économique pour les résumés de messagerie (le volume compte davantage). Laisse-le désactivé et tout partage une seule configuration — ça fonctionne très bien aussi.

Pour les déploiements en équipe, l'administrateur peut aussi partager sa configuration IA avec tous les membres, pour que personne d'autre n'ait à obtenir sa propre clé.

4. Une fois configurée, où l'utilises-tu ? — la carte complète des fonctionnalités IA

Module	Fonctionnalité	Où
Notes	Résumer / extraire des tags / traduire en anglais / traduire en japonais / générer des graphiques / questions-réponses libres	Ouvre n'importe quelle note, clique sur le bouton flottant ✨ en bas à droite pour ouvrir le panneau IA
Notes	Insérer la réponse de l'IA dans la note	Clique sur « Insérer dans la note » dans le panneau IA
Messagerie	Résumé IA (catégorisation et synthèse groupée des e-mails)	Barre latérale de la messagerie → Vues intelligentes → Résumé IA
Messagerie	Réponse IA rédigée (avec instructions personnalisées)	Ouvre un e-mail → « Réponse IA rédigée »
Tâches	Création rapide de tâches (langage naturel / voix)	Bouton flottant IA, en bas à droite de la vue Calendrier
Tâches	Génération de rapports IA hebdomadaires / mensuels	Vue Rapport → « Générer un rapport »

Le mode « Discussion » du panneau IA des notes mérite une mention spéciale : il répond en utilisant le contenu de la note actuelle comme contexte — ouvre un long compte rendu de réunion et demande simplement « qu'est-ce que je dois suivre ? ». « Générer un graphique » peut transformer des données présentes dans une note directement en un graphique en barres, en courbes ou en secteurs, et l'insérer dans le corps du texte.

5. FAQ

• Une fonctionnalité IA indique « non configurée » ? Retourne dans Réglages → Configuration IA, termine la configuration, et réussis le test ; si la configuration par module est activée, vérifie que le module concerné (Notes ou Messagerie) est lui aussi configuré.
• Le test de connexion échoue ? Vérifie, dans l'ordre : que la clé a été copiée en entier, que le compte du fournisseur dispose de crédit, et que le réseau de ton serveur peut joindre le point de terminaison API du fournisseur.
• Envie de changer de modèle ? Modifie le nom du modèle dans les réglages et enregistre — c'est effectif immédiatement.

---

Les deux derniers guides sont des configurations avancées pour les administrateurs : « 🔑 Après l'achat : activer votre licence sur ce serveur » et « 🌐 Accès public : votre propre domaine + Cloudflare ». Passe-les si cela ne te concerne pas.