/ llmtxt.info
Français
English Deutsch Español Italiano

Le fichier llms.txt

Une carte Markdown servie à la racine ou sous un chemin précis pour les agents compatibles. Cette page couvre l'emplacement, la structure v2, la découverte et la validation.

Dernière mise à jour:

Ce qu'est le fichier

Le fichier llms.txt est un document Markdown qui cartographie des ressources choisies pour des agents compatibles, avec une note optionnelle par lien. Il a été proposé par Jeremy Howard (Answer.AI) en septembre 2024 comme convention, pas comme standard imposé. Pour le concept et l'état de l'adoption, commencez par qu'est-ce que llms.txt ; cette page se concentre sur le fichier lui-même.

Où le placer

La v2 autorise la racine, https://votredomaine.com/llms.txt, ou un chemin plus précis comme https://votredomaine.com/docs/llms.txt. Le fichier applicable le plus spécifique décrit le périmètre d'une page. Déclarez-le avec rel="describedby" dans le HTML ou un en-tête HTTP Link. Un fichier compagnon llms-full.txt peut consolider le contenu pour les clients qui prennent explicitement en charge cette convention.

Structure en bref

  • Un seul H1 avec le nom du site ou du projet. Obligatoire, première ligne.
  • Un blockquote optionnel après le H1 : résumé factuel.
  • Corps Markdown libre optionnel pour le contexte (sans titres).
  • Des sections H2, chacune une liste d'items - [nom](url): note. Le libellé Optional peut signaler éditorialement les liens secondaires, sans sémantique spéciale en v2.

Les règles complètes avec exemples annotés sont sur la référence du format.

Exemple minimal valide

llms.txt 
# Acme

> Acme est une plateforme d'analytics hébergée pour les équipes produit.

## Documentation

- [Démarrage rapide](https://acme.example/docs/start): installation, init, premier dashboard.
- [Référence API](https://acme.example/docs/api): catalogue complet des endpoints.

## Optional

- [Blog](https://acme.example/blog): nouveautés produit et tutoriels.

Erreurs courantes

  • URLs relatives ambiguës. Les liens absolus sont plus sûrs si le fichier est copié.
  • Discours marketing dans le résumé. Le blockquote doit rester factuel.
  • Copier tout le sitemap. Le fichier est une carte curée, pas un index.
  • HTML au lieu de Markdown. Le fichier doit être du Markdown texte brut.
  • Mauvais type MIME. Servez-le en text/plain (UTF-8).

Le servir correctement

Sur la plupart des stacks, c'est un fichier statique dans votre répertoire public : voir les guides par stack pour Next.js, Astro, WordPress ou Cloudflare Pages (guides en anglais). Servez-le avec Content-Type: text/plain; charset=utf-8 et un cache court pour que les mises à jour se propagent.

FAQ

llms.txt et llm.txt, c'est pareil ?

Le nom de la spec est llms.txt (pluriel). llm.txt est une faute courante ; servez le nom canonique.

Faut-il mettre à jour le fichier ?

Oui, comme un sitemap : des liens périmés érodent la confiance des outils qui le lisent. Régénérez-le quand vos pages clés changent.

Quelle taille doit-il faire ?

La proposition ne fixe aucune limite en octets. Gardez la carte ciblée sur les tâches visées, testez les clients pris en charge et séparez les vrais périmètres dans des fichiers de chemin.

Sources