> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify-mintlify-d32b5473.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# llms.txt

> Générez automatiquement les fichiers llms.txt et llms-full.txt pour que les outils d'IA comme ChatGPT et Claude indexent et comprennent votre doc.

export const PreviewButton = ({children, href}) => {
  return <a href={href} className="text-sm font-medium text-white dark:!text-zinc-950 bg-zinc-900 hover:bg-zinc-700 dark:bg-zinc-100 hover:dark:bg-zinc-300 rounded-full px-3.5 py-1.5 not-prose">
        {children}
      </a>;
};

Le [fichier llms.txt](https://llmstxt.org) est une norme du secteur qui aide les LLM à indexer le contenu plus efficacement, comme un sitemap le fait pour les moteurs de recherche. Les outils d'IA peuvent utiliser ce fichier pour comprendre la structure de votre documentation et trouver le contenu pertinent pour les requêtes des utilisateurs.

Mintlify héberge automatiquement, à la racine de votre projet, un fichier `llms.txt` qui répertorie toutes les pages disponibles de votre documentation. Ce fichier est toujours à jour et ne nécessite aucun entretien. Vous pouvez également ajouter un fichier `llms.txt` personnalisé à la racine de votre projet.

<Note>
  L'authentification affecte `llms.txt` et `llms-full.txt` de manière différente selon la configuration de votre site :

  * **Sites entièrement authentifiés** : Les deux fichiers nécessitent une authentification. Les outils d'IA qui ne peuvent pas s'authentifier ne peuvent pas y accéder.
  * **Sites partiellement authentifiés** : Les deux fichiers sont accessibles publiquement, mais ne listent que les pages publiques. Les pages restreintes à des groupes d'utilisateurs sont exclues.

  Pour plus d'informations sur l'impact de l'authentification sur les fonctionnalités d'IA, voir [Disponibilité des fonctionnalités](/fr/deploy/authentication-setup#feature-availability).
</Note>

Affichez votre `llms.txt` en ajoutant `/llms.txt` à l'URL de votre site de documentation. Mintlify héberge également le fichier à l'emplacement `/.well-known/llms.txt` pour assurer la compatibilité avec les outils qui suivent la convention `.well-known`.

<PreviewButton href="https://mintlify.com/docs/llms.txt">Ouvrir le llms.txt de ce site.</PreviewButton>

Mintlify ajoute des en-têtes HTTP à chaque réponse de page afin que les outils d'IA puissent découvrir vos fichiers `llms.txt` sans connaître au préalable leur emplacement :

* `Link: </llms.txt>; rel="llms-txt", </llms-full.txt>; rel="llms-full-txt"` : Suit le format standard de l'en-tête HTTP `Link` pour la découverte de ressources.
* `X-Llms-Txt: /llms.txt` : Un en-tête pratique pour les outils qui vérifient la prise en charge de `llms.txt`.

<div id="llmstxt-structure">
  ## Structure de llms.txt
</div>

Un fichier `llms.txt` est un simple fichier Markdown qui contient :

* **Le titre du site** en tant que H1.
* **La description du site** sous forme de citation en dessous du titre, provenant du champ `description` de votre configuration `docs.json`.
* **Des sections de contenu structurées** avec des liens et une description de chaque page de votre documentation.
* **Des liens vers les spécifications d'API** pointant vers vos spécifications OpenAPI et AsyncAPI, si votre documentation en inclut.

Le fichier `llms.txt` répertorie vos pages par ordre alphabétique selon leur emplacement dans votre référentiel, en commençant au répertoire racine. Les liens des pages dans le fichier `llms.txt` incluent une extension `.md` afin que les outils d'IA puissent récupérer directement la version Markdown de chaque page.

La description de chaque page provient du champ `description` de son frontmatter. Les descriptions sont tronquées à 300 caractères et au premier saut de ligne. Pour les pages de référence d'API, la description inclut également les informations de spécification issues du champ de frontmatter `openapi` ou `api`. Les pages sans champ `description` apparaissent dans le fichier `llms.txt` sans description.

Cette approche structurée permet aux LLMs de traiter efficacement votre documentation à un niveau global et de repérer le contenu pertinent pour les requêtes des utilisateurs, améliorant ainsi la précision et la rapidité des recherches documentaires assistées par l'IA.

```mdx Example llms.txt theme={null}
# Titre du site

> Une brève description du site de documentation.

## Documentation

- [API](https://example.com/docs/api.md) : Liste des endpoints et utilisation
- [Installation](https://example.com/docs/install.md) : Étapes de configuration
- [Prise en main](https://example.com/docs/start.md) : Guide d'introduction

## OpenAPI Specs

- [openapi](https://example.com/docs/openapi.json)

## AsyncAPI Specs

- [asyncapi](https://example.com/docs/asyncapi.yaml)
```

<div id="llms-fulltxt">
  ## llms-full.txt
</div>

Le fichier `llms-full.txt` regroupe l'intégralité de votre site de documentation en un seul fichier servant de contexte pour les outils d'IA et l'indexation par les LLM.

Mintlify héberge automatiquement un fichier `llms-full.txt` à la racine de votre projet. Affichez votre `llms-full.txt` en ajoutant `/llms-full.txt` à l'URL de votre site de documentation. Mintlify héberge également le fichier à l'emplacement `/.well-known/llms-full.txt` pour assurer la compatibilité avec les outils qui suivent la convention `.well-known`.

<PreviewButton href="https://mintlify.com/docs/llms-full.txt">Ouvrir le llms-full.txt de ce site</PreviewButton>

<div id="custom-files">
  ## Fichiers personnalisés
</div>

Pour ajouter un fichier `llms.txt` ou `llms-full.txt` personnalisé, créez un fichier `llms.txt` ou `llms-full.txt` à la racine de votre projet. L'ajout d'un fichier personnalisé remplace le fichier généré automatiquement portant le même nom. Si vous supprimez un fichier personnalisé, Mintlify restaure le fichier généré automatiquement.

Votre fichier `llms.txt` ou `llms-full.txt` personnalisé doit comporter le titre du site en tant que niveau de titre H1. Le reste du contenu est facultatif. Consultez [Format](https://llmstxt.org/#format) dans la spécification `llms.txt` pour plus d'informations sur les sections facultatives et les bonnes pratiques.
