> ## Documentation Index
> Fetch the complete documentation index at: https://linkly.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Utiliser le Chat IA
> Discutez directement avec une IA dans l'application de bureau : elle cherche, lit et recoupe les documents de votre ordinateur, puis répond en citant ses sources.
## Qu'est-ce que le Chatbot
Le Chatbot est la fenêtre de conversation intégrée à l'application de bureau Linkly AI. C'est aussi la **fenêtre ouverte par défaut** : à la première ouverture de l'application, c'est elle que vous voyez.
Sa grande différence avec un outil de discussion classique : **il embarque une panoplie complète d'outils de recherche et voit directement les documents que vous avez indexés**. Rien à téléverser, rien à copier-coller — posez votre question, il ira chercher, lire et recouper lui-même, puis répondra en citant ses sources.
Connectez-vous à votre compte Linkly AI pour accéder aux modèles officiels ; les outils de recherche sont déjà en place
Mots-clés recherchés, fichiers consultés, résultats renvoyés : tout se déplie
### Chatbot ou lanceur de recherche
L'application propose deux points d'entrée qu'il est facile de confondre :
| Point d'entrée | Pour quoi faire | Comment l'ouvrir |
| ---------------------------------------- | -------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
| [Lanceur de recherche](/docs/fr/use-launcher) | Vous savez déjà quel fichier vous cherchez : le localiser et le prévisualiser en quelques secondes | Raccourci global `⌘⇧L` / `Ctrl+Shift+L` |
| **Chatbot** (cette page) | Vous avez une question qui suppose de lire, comparer et synthétiser plusieurs documents | Clic sur l'icône de la barre d'état ; sur macOS, l'icône du Dock fonctionne aussi |
Un critère simple : **pour « trouver un fichier », le lanceur ; pour « poser une question », le Chatbot.**
**Le Chatbot n'a pas de raccourci global.** `⌘⇧L` / `Ctrl+Shift+L` ouvre toujours le lanceur de recherche, jamais le Chatbot. Pour ouvrir le Chatbot, cliquez sur l'icône de la barre d'état (ou sur l'icône du Dock sous macOS).
***
## Ouverture et interface
La fenêtre fait 1200 × 800 par défaut, se redimensionne librement, et descend au minimum à 880 × 640. **La fermer ne fait que la masquer : l'application continue de tourner en arrière-plan** — au prochain clic sur l'icône de la barre d'état, vous retombez immédiatement sur la conversation en cours.
L'interface est en trois colonnes :
Tout en haut, **Nouvelle conversation**. Juste en dessous, trois entrées : **Notes**, **Trouver des fichiers** (ouvre le lanceur de recherche) et **Paramètres**. Plus bas, la liste des conversations regroupées par date (Aujourd'hui / Hier / 7 jours précédents / Ce mois-ci / Plus tôt) ; un clic droit ou un survol sur une conversation permet de la **renommer** ou de la **supprimer**.
Tout en bas, une rangée de petits boutons : **Quota du modèle**, état de l'index, **Raccourcis clavier** et **Site officiel**.
Le fil des messages et la zone de saisie. La barre d'outils située à droite de la zone de saisie contient le **sélecteur de modèle** et le pourcentage d'**utilisation de la fenêtre de contexte**.
Deux onglets :
* **Fichiers de cette conversation** — répartis en **Référencés** et **Consultés**, ce sont les fichiers que l'IA a réellement manipulés au cours de l'échange
* **Fichiers de la bibliothèque** — une arborescence de fichiers avec recherche, dont le menu contextuel propose **Ajouter à la conversation**, **Afficher dans le Finder** / **Afficher dans l'Explorateur**, **Transcrire maintenant**, etc.
Un clic sur n'importe quel fichier ouvre directement l'aperçu de son contenu ; l'espace de travail peut aussi être agrandi et servir de liseuse.
### Raccourcis de la fenêtre
Les raccourcis ci-dessous **ne fonctionnent que lorsque la fenêtre du Chatbot a le focus** :
| Raccourci | Action |
| ---------------------- | -------------------------------------- |
| `⌘N` / `Ctrl+N` | Nouvelle conversation |
| `⌘⇧N` / `Ctrl+Shift+N` | Ouvrir les notes |
| `⌘B` / `Ctrl+B` | Afficher / masquer la barre latérale |
| `⌥⌘B` / `Ctrl+Alt+B` | Afficher / masquer l'espace de travail |
| `⌘,` / `Ctrl+,` | Ouvrir les paramètres |
### État de l'index
Le bouton d'index situé au bas de la barre latérale prend trois formes : **Indexation…** avec un indicateur qui tourne, **Index à jour** avec une coche, et **Erreur d'indexation** en rouge. Un clic ouvre **Paramètres → Index**.
Si l'IA affirme ne pas trouver un fichier dont vous êtes sûr de l'existence, regardez d'abord ce bouton : le plus souvent, l'indexation n'est pas terminée, ou bien le dossier concerné n'a jamais été ajouté.
***
## Cibler une portée avec @
C'est la fonction la plus utilisée du Chatbot, et aussi la plus souvent mal comprise. Tapez `@` dans la zone de saisie : un sélecteur s'ouvre et propose quatre types d'objets :
* **une bibliothèque locale** ([en savoir plus](/docs/fr/use-libraries))
* **une bibliothèque cloud** ([en savoir plus](/docs/fr/use-cloud-library))
* **un dossier**
* **un fichier**
Une fois la sélection faite, une rangée d'étiquettes apparaît au-dessus de la zone de saisie. Aucune limite stricte au nombre de mentions dans un même message : **ce qui dépasse d'une ligne est replié en `+N`**, et le survol affiche la liste complète.
**`@` est une suggestion de portée adressée à l'IA, pas un filtre strict.**
Les objets sélectionnés sont inscrits en tête de votre message sous forme de références (chemin, identifiant de bibliothèque, id de document), et une consigne fixe du prompt système explique au modèle comment les interpréter. L'application **ne lit à l'avance le contenu d'aucun document** : le texte est toujours récupéré par le modèle lui-même, via ses outils de recherche.
Autrement dit : vous **indiquez à l'IA où chercher en priorité**, vous ne lui **interdisez pas** de chercher ailleurs. Dans l'immense majorité des cas elle s'y tient, mais il peut arriver qu'elle s'en écarte, en particulier si la réponse ne se trouve effectivement pas dans la portée indiquée.
**`@` s'applique message par message, ce n'est pas un réglage valable pour toute la conversation.** Si vous mentionnez une bibliothèque dans un message et pas dans le suivant, la portée redevient globale. Pour rester cadré sur plusieurs tours, mentionnez-la à chaque message.
### Deux groupes, deux comportements
Le sélecteur est divisé en deux groupes dont le comportement diffère nettement :
| Groupe | Comportement |
| ---------------------------------- | -------------------------------------------------------------------------------------------- |
| **Bibliothèques de connaissances** | Tout est listé dès l'ouverture, il n'y a plus qu'à choisir |
| **Fichiers et dossiers** | **Il faut d'abord saisir un mot-clé** pour obtenir des propositions, 8 au maximum par défaut |
De plus, le groupe **Fichiers et dossiers** **ne fait correspondre que le nom du fichier (basename), jamais le chemin**. Pour mentionner `~/Projets/2026/bilan-annuel.docx`, saisir `bilan` ou `annuel` fonctionne, mais `Projets` ne remontera pas ce fichier (seulement le dossier `Projets` lui-même).
### Quatre conditions pour qu'une bibliothèque cloud apparaisse
Si une bibliothèque cloud reste introuvable dans le sélecteur, vérifiez ces points un à un :
1. vous êtes connecté à votre [compte Linkly AI](/docs/fr/linkly-account) (ou une clé API Cloud est configurée)
2. la bibliothèque a bien été liée **depuis le site web**
3. dans **Paramètres → Bibliothèques → Bibliothèques cloud connectées**, son interrupteur est activé
4. cette bibliothèque cloud **n'est liée à aucune bibliothèque locale**
Le point 4 est un choix délibéré : une bibliothèque cloud déjà liée n'apparaît qu'à travers l'entrée locale correspondante, pour éviter que le même contenu soit listé deux fois dans le sélecteur. Pour la cibler, mentionnez simplement la bibliothèque locale.
### Pas d'envoi de fichiers
Le Chatbot **ne permet ni de téléverser un fichier ni d'ajouter une pièce jointe**. Les objets référencés avec `@` doivent **déjà être indexés**. Pour faire lire un nouveau fichier à l'IA, ajoutez d'abord son dossier dans **Paramètres → Dossiers**, ou déposez-le directement dans `~/LinklyAI` (ce dossier est surveillé par défaut), puis attendez la fin de l'indexation pour le mentionner.
***
## Choisir un modèle et suivre son quota
### Deux origines possibles pour les modèles
| Origine | Comment la configurer |
| --------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
| **Modèles officiels Linkly AI** | Il suffit de se connecter depuis **Paramètres → Compte**, aucune clé à renseigner |
| **N'importe quel point de terminaison compatible OpenAI** | **Paramètres → IA → Fournisseurs → Fournisseur personnalisé**, puis URL de base et clé API |
La seconde catégorie couvre aussi bien les API tierces dans le cloud que les serveurs qui tournent sur votre machine, **Ollama** et **LM Studio** (pour lesquels la clé peut généralement rester vide). À l'ajout, 12 préréglages permettent de remplir l'adresse en un clic : OpenAI, DeepSeek, Mistral, Groq, OpenRouter, Qwen, MiniMax, Moonshot, Zhipu, SiliconFlow, Ollama, LM Studio.
Un préréglage **ne pré-remplit que l'adresse**, jamais la liste des modèles. Une fois l'adresse saisie, l'étape suivante permet de découvrir automatiquement les modèles depuis le point de terminaison `/v1/models` du fournisseur, ou de saisir un identifiant de modèle à la main.
Le changement de modèle se fait depuis la **barre d'outils à droite de la zone de saisie**, où les modèles sont regroupés par fournisseur. **Paramètres → IA** permet de définir le **Modèle par défaut** des nouvelles conversations, ainsi qu'une **Langue de réponse** fixe.
**Le modèle de conversation doit prendre en charge les appels d'outils (function calling).** Les modèles qui n'en sont pas capables n'apparaissent tout simplement pas dans la liste : tout le savoir-faire du Chatbot repose sur l'appel d'outils de recherche ; sans eux, il ne resterait qu'une fenêtre de discussion ordinaire, aveugle à vos fichiers.
### Comment le quota est calculé
Le quota des modèles officiels Linkly AI ne se compte **ni en tokens ni en nombre de requêtes** pris isolément : il s'agit d'un **pot commun**. Chaque modèle possède son propre **multiplicateur**, affiché sous forme de badge dans le sélecteur de modèle — plus il est bas, plus le modèle est économe.
Le quota est réparti sur **trois fenêtres temporelles parallèles, calculées indépendamment** :
| Fenêtre | Rôle |
| -------- | --------------------------------------------------- |
| 5 heures | Éviter une consommation concentrée sur peu de temps |
| 7 jours | Consommation hebdomadaire |
| 30 jours | Consommation mensuelle |
Dès qu'une seule de ces fenêtres est saturée, vous êtes limité — même s'il reste de la marge sur les deux autres. Pour consulter l'état : cliquez sur le bouton de **quota** au bas de la barre latérale, trois anneaux de progression s'affichent avec leur heure de réinitialisation respective.
Lorsque le quota est épuisé, une **bannière ambre** apparaît au-dessus de la zone de saisie et indique la limite atteinte ainsi que l'heure de reprise. Elle peut être fermée, mais le blocage réel a lieu côté serveur : la fermer ne vous donne pas un message de plus. Les comptes gratuits ne voient pas les modèles réservés au plan Pro dans la liste (le serveur les a déjà filtrés) ; en revanche, si votre abonnement Pro expire alors que votre modèle par défaut en fait partie, l'envoi déclenche une autre bannière, qui propose de passer à Pro.
Les modèles tiers et locaux ne consomment pas le quota Linkly AI : ils sont facturés selon les conditions du fournisseur concerné.
Le détail du pot commun, des multiplicateurs et du catalogue officiel est présenté dans [Le service de modèles officiel](/docs/fr/model-service).
***
## Conversations et compactage du contexte
### Les conversations
Toutes les conversations sont stockées dans une **base SQLite locale**. **Aucune limite de nombre, aucun nettoyage automatique, aucune durée de conservation** : tant que vous ne supprimez rien, tout reste. Les paramètres d'entrée des appels d'outils, leurs résultats, leur statut, leurs erreurs, ainsi que le raisonnement du modèle sont eux aussi conservés : quelques jours plus tard, une vieille conversation se déplie avec tous ses détails intacts.
Le titre est généré automatiquement : un titre provisoire est d'abord extrait de votre premier message, puis le titre définitif est produit en arrière-plan par le même modèle. **Une conversation renommée à la main n'est jamais écrasée.**
### Le compactage du contexte
Quand une conversation s'allonge, l'ensemble des messages finit par ne plus tenir dans la fenêtre de contexte du modèle. Linkly AI répond à cela par le **compactage** (compaction) :
* **le déclenchement automatique intervient à 80 % de la fenêtre de contexte du modèle**
* **le déclenchement manuel** se fait en saisissant `/compact` dans la zone de saisie
**Si la taille de la fenêtre de contexte du modèle est inconnue, aucun compactage automatique n'aura jamais lieu.**
Cette taille provient du champ `context_length` renvoyé par le point de terminaison `/v1/models` du fournisseur. Les fournisseurs personnalisés, ainsi qu'Ollama et LM Studio en local, ne le fournissent souvent pas : le pourcentage d'utilisation ne peut alors pas s'afficher, et le compactage automatique ne se déclenche pas — la conversation ne fait que s'allonger jusqu'à ce que le modèle finisse par renvoyer une erreur. Avec ce type de modèle, surveillez vous-même la longueur et lancez un `/compact` manuel ou une nouvelle conversation au bon moment.
Le compactage fonctionne **en mode append-only**, et c'est un point essentiel :
* seule **la portion la plus ancienne des messages** est repliée en un résumé ; **les messages d'origine ne sont jamais supprimés**
* les messages repliés **restent visibles** dans l'interface, ils n'entrent simplement plus dans le contexte envoyé au modèle
* **la portion la plus récente est conservée mot pour mot**, sans aucun résumé
Le résumé lui-même est structuré en six sections : objectif de l'utilisateur / chacun des messages de l'utilisateur / conclusions clés / documents consultés / outils et résultats de recherche (y compris les résultats négatifs) / questions en suspens. Le raisonnement du modèle est écarté lors du compactage.
Ce que vous voyez à l'écran, c'est un séparateur dépliable inséré au milieu du fil : **Messages précédents compactés (N)**. Un clic affiche le résumé, et les messages d'origine restent lisibles juste après.
**Le compactage automatique à 80 % n'est précédé d'aucun avertissement** : il se produit silencieusement. Ce n'est que lorsque le contexte est réellement saturé (100 %) qu'une bannière **Cette conversation a rempli la fenêtre de contexte** apparaît, accompagnée d'un bouton **Compacter**.
Pour suivre la progression à l'avance, surveillez le pourcentage d'**utilisation de la fenêtre de contexte** dans la barre d'outils de la zone de saisie.
Quand vous changez de sujet, ouvrir une nouvelle conversation (`⌘N` / `Ctrl+N`) est presque toujours plus avantageux qu'un compactage : celui-ci coûte un appel de modèle supplémentaire et fait perdre des détails, alors qu'une nouvelle conversation part propre, coûte moins cher et va plus vite.
***
## Comprendre ce que fait l'IA
Le Chatbot expose délibérément son déroulé : c'est la clé pour juger de la fiabilité d'une réponse.
### Les appels d'outils
Chaque recherche, chaque lecture de fichier correspond à un appel d'outil. Plusieurs appels consécutifs sont **repliés en un groupe** : celui-ci se déplie automatiquement pendant l'exécution pour montrer la progression, puis se referme une fois terminé, afin de garder le fil lisible.
**Déplier un groupe donne accès aux paramètres d'entrée et aux résultats complets** : quels mots-clés ont été cherchés, quelle portée a été appliquée, combien de résultats sont revenus, lequel a échoué. Quand une réponse est fausse, la cause saute souvent aux yeux à cet endroit précis (mots-clés mal choisis, ou dossier qui n'a jamais été indexé).
### Les citations
Dans la réponse, chaque fait tiré d'un document se termine par une **marque de citation** cliquable qui renvoie à la source. Les fichiers cités et consultés sont automatiquement regroupés dans **Fichiers de cette conversation**, à droite dans l'espace de travail, ce qui permet de les vérifier un à un.
***
## Export
Le Chatbot propose un **export élément par élément** ; les fichiers produits atterrissent dans le dossier de téléchargement du système :
| Élément exporté | Formats disponibles | Point d'entrée |
| -------------------------- | ------------------- | ------------------------------------------------ |
| Une réponse de l'IA | Markdown / HTML | **Télécharger la réponse**, sous la réponse |
| Un tableau dans un message | CSV / Markdown | **Télécharger le tableau**, au-dessus du tableau |
**Il n'existe pas d'export de conversation complète**, ni de format PNG ou XLSX. Pour conserver un échange entier, il faut aujourd'hui l'exporter élément par élément, ou passer par une sélection et une copie.
***
## Questions fréquentes
C'est voulu. Le raccourci global `⌘⇧L` / `Ctrl+Shift+L` est associé au [lanceur de recherche](/docs/fr/use-launcher) ; le Chatbot n'a pas de raccourci global propre, il s'ouvre depuis l'icône de la barre d'état (ou l'icône du Dock sous macOS). Les raccourcis internes comme `⌘N` ou `⌘B` n'ont d'effet qu'une fois la fenêtre du Chatbot au premier plan.
Parce que `@` est une **suggestion de portée**, pas un filtre strict. Les objets sélectionnés sont joints en tête du message sous forme de références, et c'est le modèle qui décide de leur usage : il cherche généralement en priorité dans cette portée, mais peut l'élargir s'il n'y trouve rien.
Pour un cadrage vraiment strict, le plus fiable reste de le dire explicitement dans le message, par exemple : « Cherche uniquement dans la bibliothèque ml-papers, et dis-le franchement si tu ne trouves rien. »
Vérifiez dans cet ordre :
1. **Avez-vous saisi un mot-clé ?** Le groupe **Fichiers et dossiers** n'affiche de propositions qu'après une saisie, avec 8 résultats au maximum par défaut : un terme trop large se fait évincer par d'autres fichiers.
2. **Est-ce bien le nom du fichier ?** La correspondance ne porte que sur le nom lui-même, jamais sur le chemin : chercher un dossier intermédiaire ne remonte pas le fichier.
3. **Le fichier est-il indexé ?** Regardez le bouton d'état de l'index au bas de la barre latérale, ou vérifiez dans **Paramètres → Dossiers** que le répertoire a bien été ajouté.
Aucune suppression automatique. Les conversations résident dans une base locale, **sans limite de nombre ni durée de conservation**, y compris les paramètres d'entrée et les résultats complets de chaque appel d'outil. Les conversations dont vous n'avez plus besoin se suppriment à la main depuis la liste de gauche.
Cela dépend du modèle choisi. Avec les modèles officiels Linkly AI ou n'importe quelle API tierce dans le cloud, le contenu des messages est transmis au service de modèle correspondant — **y compris les extraits de documents retrouvés par l'IA**.
Si vous ne voulez rien laisser sortir de votre machine, ajoutez un fournisseur local Ollama ou LM Studio dans **Paramètres → IA** et sélectionnez l'un de ses modèles : la conversation reste alors entièrement locale (à condition que le modèle local prenne en charge les appels d'outils).
Les capacités de recherche sont exactement les mêmes. La différence tient à **l'endroit où vous travaillez** :
* **Le Chatbot** — utilisable immédiatement, sans configuration MCP, avec une arborescence de fichiers, un panneau de citations et un aperçu des documents, c'est-à-dire une interface pensée pour lire de la documentation.
* **[MCP](/docs/fr/use-mcp) / [CLI](/docs/fr/use-cli)** — branchent les outils de recherche de Linkly AI dans les outils IA que vous utilisez déjà : indiqué pour écrire du code, faire tourner un agent, ou toute situation qui implique d'autres chaînes d'outils.
Les deux peuvent servir en parallèle, sans interférence.
Oui. Le compactage est append-only : **les messages d'origine ne sont jamais supprimés**, ils n'entrent simplement plus dans le contexte envoyé au modèle. Dépliez le séparateur **Messages précédents compactés (N)** dans le fil pour retrouver l'intégralité du texte.
Attention toutefois : à partir de ce moment-là, **le modèle ne voit plus que le résumé**, et non les messages d'origine. S'il « oublie » un détail, il suffit de le lui redonner dans un nouveau message.
***
## Pour aller plus loin
* [Utiliser le lanceur de recherche](/docs/fr/use-launcher) — localiser un fichier précis en quelques secondes
* [Utiliser les bibliothèques](/docs/fr/use-libraries) — regrouper vos documents par thème pour rendre `@` plus efficace
* [Utiliser les bibliothèques cloud](/docs/fr/use-cloud-library) — rendre une bibliothèque disponible 24h/24 indépendamment de votre machine
* [Présentation des outils](/docs/fr/tools-intro) — la description complète des outils de recherche qui font tourner le Chatbot
* [Questions fréquentes](/docs/fr/faq) — les questions générales d'installation, d'indexation et de connexion
* [Utiliser les notes](/docs/fr/use-notes) — les notes en cartes, dans cette même fenêtre
* [Le service de modèles officiel](/docs/fr/model-service) — la description complète du service officiel et du mécanisme de quota
* [Le compte Linkly AI](/docs/fr/linkly-account) — ce que débloque la connexion, et la différence entre Gratuit et Pro