llms.txt

Si vous voulez que des outils d'IA comme ChatGPT, Claude ou Copilot donnent des réponses précises sur votre produit, ils ont besoin d'un accès structuré à votre documentation, pas seulement de ce qui a été inclus dans leurs données d'entraînement.

Chaque site Jamdesk génère llms.txt et llms-full.txt en suivant la spécification llmstxt.org. Les outils d'IA lisent ces fichiers au lieu d'explorer chaque page individuellement.

Ce que Jamdesk génère

Jamdesk génère les deux au moment du build et les diffuse depuis le même CDN que votre documentation.

Vérifiez vos fichiers

Vérifiez que vos fichiers existent après votre premier build :

curl https://docs.acme.com/llms.txt
curl https://docs.acme.com/llms-full.txt

Format de fichier

Le fichier llms.txt répertorie chaque page avec son titre, sa description et son URL, regroupées en sections qui reflètent votre navigation :

# Your Project Documentation

> Documentation for Your Project

## Get Started

- [Getting Started](https://your-project.jamdesk.app/getting-started): Set up your first project in 5 minutes
- [Configuration](https://your-project.jamdesk.app/configuration): Configure your project settings

## API Reference

- [Authentication](https://your-project.jamdesk.app/authentication): How to authenticate API requests

Le fichier llms-full.txt contient le contenu Markdown complet de chaque page, concaténé avec des limites de page marquées par des titres.

Structure

llms.txt suit la proposition llmstxt.org : un titre H1, un résumé en citation, et vos onglets et groupes de navigation sous forme de sections ## de liens Markdown.

Sites multilingues

Les sites disposant de plusieurs langues obtiennent un ensemble distinct de fichiers pour chaque langue, afin qu'un outil d'IA puisse récupérer uniquement la langue dont il a besoin. Pour un site en anglais (la langue par défaut) et en français :

Le llms-full.txt racine conserve toutes les langues, donc les outils qui le lisent déjà ne voient aucun changement. Pointez un agent vers le fichier propre à une langue lorsqu'il n'a besoin que de cette langue :

curl https://jamdesk.com/docs/fr/llms-full.txt

Une langue obtient ses propres fichiers dès qu'elle compte au moins une page. Les sites avec une seule langue ne conservent que les fichiers racine.

Sites protégés par connexion

Sur un site protégé par mot de passe ou par authentification JWT, llms.txt et llms-full.txt renvoient les visiteurs vers la page de connexion, et les URL .md répondent 401. Une clé API du projet ouvre ces trois accès pour les outils qui ne peuvent pas se connecter. Créez-en une dans Project Settings > API Keys et envoyez-la dans Authorization: Bearer <key> :

curl https://docs.example.com/llms.txt \
  -H "Authorization: Bearer jd_live_..."

curl https://docs.example.com/using/scope.md \
  -H "Authorization: Bearer jd_live_..."

Avec une clé, les URL .md renvoient les pages qui apparaissent dans la recherche. Les pages réservées à des groupes, les pages masquées et les pages avec search: false répondent 404. Une clé qui n'est pas valide pour le site reçoit une erreur JSON 401 avec invalid_api_key. Sans clé, rien ne change.

La clé n'ouvre jamais les pages HTML ni le chat IA, qui exigent toujours une connexion. Les requêtes avec clé partagent avec le serveur MCP une limite de 120 par minute et par clé. Au-delà, la réponse est un 429 avec Retry-After: 60.

Directive d'agent sur chaque page

Chaque page comporte également une note invisible, silencieuse pour les lecteurs d'écran, destinée aux agents d'IA et pointant vers llms.txt, et chaque export Markdown commence par une citation reliant l'index. Les agents qui arrivent sur votre HTML trouvent le chemin Markdown sans avoir à explorer le site.

Comment c'est construit

• Généré au moment du build, en même temps que votre HTML
• Diffusé depuis le CDN avec la même politique de cache que votre documentation
• Mis à jour automatiquement à chaque build
• Aucune configuration nécessaire ; toutes les pages sont incluses par défaut

Désactiver llms.txt

llms.txt et llms-full.txt sont publiés par défaut. Pour arrêter de les générer (par exemple, si vous ne voulez pas que des outils d'IA exploitent votre contenu), définissez seo.ai.llmsTxt sur false dans votre docs.json :

{
  "seo": {
    "ai": {
      "llmsTxt": false
    }
  }
}

Lors de votre prochain build, Jamdesk ignore les deux fichiers, y compris chaque copie par langue, et les URL actives /llms.txt et /llms-full.txt renvoient 404.

Robots d'exploration IA

Le fichier robots.txt par défaut de Jamdesk autorise tous les principaux robots d'exploration IA (Claude, ChatGPT, Copilot, Gemini). Votre documentation est accessible aux outils d'IA dès le départ.

Et ensuite ?