Utiliser la documentation avec l’IA
Chaque page de ce site est aussi publiée en Markdown brut, de sorte qu’un assistant IA peut lire la documentation sans analyser le site web. Vous pouvez fournir à l’assistant une URL ou un fichier, ou le connecter à Babel Desktop, qui effectue les recherches dans la documentation à sa place.
Fichiers pour les assistants IA
Le build du site publie ces fichiers à côté des pages :
| URL | Contenu |
|---|---|
https://docs.babelfor.net/llms.txt | Index de toutes les pages, regroupées par section (Obfuscator, Licensing, Desktop, API Reference), avec une description d’une ligne et un lien vers la copie Markdown de chaque page |
https://docs.babelfor.net/llms-full.txt | Toutes les pages dans un seul fichier, dans l’ordre de la navigation. Chaque page commence par son titre et par une ligne Source: qui contient l’URL de la page. Le fichier pèse quelques mégaoctets |
https://docs.babelfor.net/md/<path>.md | Copie Markdown d’une seule page. Le chemin est l’adresse de la page, par exemple /md/desktop/stack-decoder.md pour le Décodeur de pile, ou /md/desktop.md pour la page de la section Desktop |
https://docs.babelfor.net/docs-index.json | Index de recherche de toutes les sections, utilisé par les outils de documentation de Babel Desktop |
Les copies Markdown ont le même contenu que les pages. Les procédures deviennent des listes numérotées, les remarques des paragraphes cités et les onglets des sous-titres. Les liens et les images pointent vers https://docs.babelfor.net, et fonctionnent donc encore lorsque le texte est copié ailleurs.
Les fichiers sont régénérés à chaque publication du site et décrivent toujours la version actuelle.
Utiliser les fichiers avec Claude, ChatGPT et d’autres assistants
Choisissez le fichier qui correspond à la question. Pour une question sur une seule fonctionnalité, une page suffit et laisse à l’assistant plus de place pour votre code et vos journaux. Pour les questions générales, fournissez-lui l’index ou le fichier complet.
Trouver la page
Ouvrez llms.txt et cherchez les pages qui traitent de votre question, ou parcourez ce site et ajoutez /md devant le chemin et .md à la fin : https://docs.babelfor.net/licensing/licensing-modes devient https://docs.babelfor.net/md/licensing/licensing-modes.md.
La fournir à l’assistant
Si l’assistant peut ouvrir des pages web, collez l’URL dans la conversation. Sinon, téléchargez le fichier et joignez-le, ou copiez son texte dans le message. Les fichiers volumineux comme llms-full.txt peuvent ne pas tenir dans une seule conversation ; dans ce cas, fournissez llms.txt à l’assistant et laissez-le demander les pages dont il a besoin.
Poser la question
Demandez à l’assistant de répondre à partir de la documentation fournie et de citer l’URL Source: ou le lien de la page qu’il a utilisée, afin que vous puissiez vérifier la réponse sur le site.
Quelques exemples de demandes :
Lisez https://docs.babelfor.net/llms.txt et dites-moi quelles pages expliquent comment exécuter Babel Obfuscator dans un build CI sous Linux. Lisez ensuite ces pages et énumérez les étapes.
À partir de https://docs.babelfor.net/md/obfuscator/nuget-package/configuration.md , ajoutez le chiffrement des chaînes et l’obfuscation du flux de contrôle à ce fichier de projet.
Voici llms-full.txt. Quelle est la différence entre une licence flottante et l’activation de licence, et laquelle convient à une application de bureau vendue par poste ?
Ces fichiers sont des pages publiques et statiques. Les ouvrir ou les joindre ne fait que les télécharger depuis https://docs.babelfor.net ; rien de ce qui concerne votre code ou vos projets n’est envoyé à babelfor.NET. Ce que vous collez dans un assistant, comme du code source, des fichiers de projet ou des traces de pile, est régi par les conditions propres à cet assistant.
Utiliser la documentation depuis Babel Desktop
Si Babel Desktop est installé, connectez votre assistant à son serveur MCP. C’est l’option recommandée. Le serveur comprend trois outils de documentation, docs_search, docs_read et docs_list, si bien que la même connexion répond aux questions pratiques puis applique la modification dans l’application : l’assistant cherche comment marche une fonctionnalité, cite la page, puis modifie les paramètres du projet ou lance l’obfuscation.
Activer le serveur MCP
Dans Babel Desktop, ouvrez Paramètres, choisissez MCP et cochez Activer le serveur d’automatisation. Il est recommandé d’exiger un jeton d’accès. Voir Activer le serveur.
Connecter l’assistant
Cliquez sur Copier la configuration et ajoutez-la à la configuration MCP de votre client ou, pour Claude Code, cliquez sur Copier la commande Claude Code et exécutez la commande. La configuration contient l’adresse du serveur, http://127.0.0.1:8765/mcp avec le port par défaut, et l’en-tête X-Babel-Token lorsqu’un jeton est exigé. Voir Connecter un client.
Poser une question
Demandez comment réaliser une opération dans Babel. L’assistant cherche dans la documentation, lit la section correspondante et répond avec des liens vers les pages.
Les outils de documentation ne demandent aucun autre paramètre. Ils sont disponibles dès que le serveur est en cours d’exécution. Babel Desktop télécharge les pages depuis https://docs.babelfor.net et y effectue les recherches sur votre machine. Il en conserve une copie dans votre profil utilisateur, de sorte que les outils répondent encore lorsque vous êtes hors ligne. Voir Outils de documentation Babel pour plus de détails.