3.4 KiB
🧠 Guide de Configuration Smart Connections
🎉 Plugin Surprise
Vous avez aussi Smart Connections installé ! C'est un RAG local sur votre wiki : il indexe vos 146 pages et permet de poser des questions à votre propre base de connaissances.
🎯 À quoi ça sert ?
Imaginez pouvoir demander à votre wiki :
- "Quelle est la différence entre Docker et Kubernetes ?"
- "Liste-moi les pages sur l'auto-hébergement"
- "Résume-moi le concept de PQC"
Smart Connections fait exactement ça, localement (pas d'API externe), en utilisant des embeddings pour trouver les passages les plus pertinents.
⚙️ Configuration Initiale
1. Activer l'indexation
- Paramètres
\rightarrowSmart Connections - Section API Settings :
- API Key : votre clé OpenAI (ou autre provider)
- Model :
text-embedding-3-small(rapide, peu cher)
- Sauvegarder
2. Première indexation
- Ouvrir la palette de commandes (
Ctrl/Cmd + P) - Taper :
Smart Connections: Rebuild Index - Attendre 1-5 minutes (selon taille du vault)
- Pour 146 pages, ~2 minutes
3. Utilisation
Une fois indexé :
- Dans chaque page, une section "Smart Connections" apparaît en bas
- Liste des pages les plus similaires automatiquement
- Chat (option payante ou via plugin supplémentaire) pour poser des questions
🚀 Cas d'Usage pour votre Wiki
1. Découverte de contenu
Quand vous ouvrez une page, Smart Connections suggère les 3-5 pages connexes que vous n'auriez peut-être pas découvertes.
2. Navigation sémantique
Contrairement aux wikilinks (qui sont explicites), Smart Connections trouve des liens cachés entre pages.
Exemple : la page firewall pourrait suggérer vpn et zero-trust automatiquement, même si ces liens n'existent pas encore.
3. Question-Réponse (avec le chat)
Le chat intégré (disponible dans les versions récentes) permet de :
- Poser des questions sur votre wiki
- Obtenir des réponses sourcées (avec liens vers les pages)
💡 Workflow Recommandé
Pendant la lecture
- Ouvrez une page (ex:
[[transformer-architecture]]) - Scrollez en bas : Smart Connections liste les pages similaires
- Cliquez pour naviguer
- Si une suggestion est pertinente, ajoutez un vrai wikilink (lien explicite)
Pendant l'écriture
- Créez une nouvelle page
- Smart Connections vous suggère des pages existantes à lier
- Ajoutez les wikilinks pertinents
- Double bénéfice : votre recherche sémantique + votre graphe explicite s'enrichissent mutuellement
🆓 Alternatives Gratuites (sans API)
Si vous ne voulez pas payer OpenAI, vous pouvez utiliser :
- Ollama (local) avec
nomic-embed-text(gratuit, privé) - LM Studio avec un modèle d'embedding
- Configuration : Paramètres
\rightarrowSmart Connections $\rightarrow) Custom API (OpenAI-compatible)
📊 Performance Attendue
Avec 146 pages :
- Indexation : 1-3 minutes
- Coût OpenAI : ~$0.01 (one-time)
- Coût par recherche : gratuit (embeddings en cache)
- Stockage local : ~5 Mo
📚 Ressources
Avec Smart Connections, votre wiki passe de base statique à base interrogable. C'est le chaînon manquant entre documentation passive et assistant intelligent ! 🤖