89 lines
3.4 KiB
Markdown
89 lines
3.4 KiB
Markdown
# 🧠 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
|
|
1. **Paramètres** $\rightarrow$ **Smart Connections**
|
|
2. Section **API Settings** :
|
|
- **API Key** : votre clé OpenAI (ou autre provider)
|
|
- **Model** : `text-embedding-3-small` (rapide, peu cher)
|
|
3. **Sauvegarder**
|
|
|
|
### 2. Première indexation
|
|
1. Ouvrir la **palette de commandes** (`Ctrl/Cmd + P`)
|
|
2. Taper : `Smart Connections: Rebuild Index`
|
|
3. Attendre 1-5 minutes (selon taille du vault)
|
|
4. 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
|
|
1. Ouvrez une page (ex: `[[transformer-architecture]]`)
|
|
2. Scrollez en bas : Smart Connections liste les pages similaires
|
|
3. Cliquez pour naviguer
|
|
4. Si une suggestion est pertinente, **ajoutez un vrai wikilink** (lien explicite)
|
|
|
|
### Pendant l'écriture
|
|
1. Créez une nouvelle page
|
|
2. Smart Connections vous suggère des pages existantes à lier
|
|
3. Ajoutez les wikilinks pertinents
|
|
4. **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** $\rightarrow$ **Smart 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
|
|
|
|
- [Site officiel](https://smartconnections.app/)
|
|
- [Documentation](https://smartconnections.app/docs/)
|
|
- [Communauté Discord](https://discord.gg/smart-connections)
|
|
|
|
---
|
|
|
|
Avec Smart Connections, votre wiki passe de **base statique** à **base interrogable**. C'est le chaînon manquant entre documentation passive et assistant intelligent ! 🤖
|