> ## Documentation Index
> Fetch the complete documentation index at: https://www.mintlify.com/docs/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 et excluent les pages restreintes à des groupes d'utilisateurs.

  Pour plus d'informations sur l'impact de l'authentification sur les fonctionnalités d'IA, voir [Disponibilité des fonctionnalités](/docs/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` et autres ressources d'agent sans connaître au préalable leur emplacement :

* `Link` : Suit le format standard de l'en-tête HTTP `Link` pour la découverte de ressources. Annonce `llms.txt`, `llms-full.txt`, votre catalogue d'API, la [carte du serveur MCP](/docs/fr/ai/model-context-protocol#discovery-endpoint), l'[agent card](/docs/fr/ai/skillmd#agent-card) et l'[index des agent skills](/docs/fr/ai/skillmd#skills-discovery-endpoints).
* `X-Llms-Txt` : Un en-tête pratique pour les outils qui vérifient la prise en charge de `llms.txt`.

```http Response headers theme={null}
Link: </llms.txt>; rel="llms-txt", </llms-full.txt>; rel="llms-full-txt", </.well-known/api-catalog>; rel="api-catalog", </.well-known/mcp/server-card.json>; rel="mcp-server-card", </.well-known/agent-card.json>; rel="agent-card", </.well-known/agent-skills/index.json>; rel="agent-skills"
X-Llms-Txt: /llms.txt
```

Les sites qui utilisent l'authentification annoncent également leurs métadonnées de ressource protégée OAuth avec `rel="oauth-protected-resource"`. Si vous servez votre documentation sous un chemin de base, chaque chemin annoncé inclut ce préfixe.

<div id="llmstxt-structure">
  ## Structure du fichier 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 instructions personnalisées pour les agents** sous forme de bloc `Agent Instructions` après la description, si vous définissez [`markdown.instructions`](/docs/fr/ai/markdown-export#custom-agent-instructions) dans votre `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.
* **Des liens externes** dans une section `Optional`, pour toute URL absolue de votre navigation.

Le fichier `llms.txt` répertorie vos pages dans l'ordre où elles apparaissent dans la navigation de votre `docs.json`. Les pages qui ne figurent pas dans votre navigation mais qui sont indexées parce que vous avez défini `seo.indexing: "all"` apparaissent en dernier, par ordre alphabétique. 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. Mintlify utilise le premier paragraphe de la description et le tronque à 300 caractères. Les pages sans champ `description` apparaissent dans le fichier `llms.txt` sans description.

Les fichiers `llms.txt` et `llms-full.txt` répertorient les pages de votre langue par défaut et de votre version par défaut. Ils excluent les [pages masquées](/docs/fr/organize/hidden-pages) et les pages dont le frontmatter contient `noindex: true`, sauf si vous définissez `seo.indexing: "all"` dans votre `docs.json`.

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.

<Note>
  Les fichiers d'index `llms.txt` générés automatiquement ne peuvent pas dépasser 100 000 caractères. Pour les sites de documentation volumineux, Mintlify scinde l'index en fichiers liés sous `/_llms/` afin que les agents puissent découvrir chaque page sans charger un seul fichier trop volumineux. Cette limite ne s'applique pas à `llms-full.txt`.
</Note>

Si vous utilisez un reverse proxy ou maintenez une liste d'autorisation de chemins, transférez `/_llms/*` en plus de `/llms.txt` pour que les agents puissent suivre les liens de l'index généré. Pour une documentation hébergée sous un chemin de base, transférez `<base-path>/_llms/*` à la place. Les domaines personnalisés gérés par Mintlify ne nécessitent aucune configuration supplémentaire. Consultez [Reverse proxy](/docs/fr/deploy/reverse-proxy#routing-configuration) pour des conseils de routage.

```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)

## Optional

- [Community](https://example.com/community)
```

<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. Chaque page apparaît sous la forme de son titre, de son URL source, de sa description et de son contenu Markdown complet.

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.


## Related topics

- [Glossaire](/docs/fr/reference/glossary.md)
- [Référence des commandes de la CLI Mintlify](/docs/fr/cli/commands.md)
- [Documentation native à l’IA](/docs/fr/ai-native.md)