# La doc pour votre agent

> Comment un agent lit cette documentation : les outils docs_search et docs_read du MCP Fransys, llms.txt, chaque page en Markdown, et l'index de recherche.

Source : https://docs.fransys.cloud/agents/pour-votre-agent/ Vérifié sur la console le 2026-10-23.

## Trois façons de lire la doc

Votre agent lit la même documentation que vous, sans le menu ni la mise en page :

| Adresse | Ce qu'elle contient |
|---|---|
| `https://docs.fransys.cloud/llms.txt` | Le sommaire : une ligne par page, avec sa description et son lien en Markdown. |
| `https://docs.fransys.cloud/llms-full.txt` | Toute la doc en un seul fichier. |
| `https://docs.fransys.cloud/<page>.md` | Une page en Markdown. Ajoutez `.md` à l'adresse d'une page, sans la barre finale. |

Sur chaque page, **Copier pour un agent** copie sa version Markdown, et **Ouvrir dans Claude** ou **Ouvrir dans ChatGPT** ouvre une conversation qui part de la page.

## Le dire à votre agent

Ajoutez une ligne aux instructions de votre projet (`CLAUDE.md`, `AGENTS.md`, règles de Cursor) :

```md
Pour tout ce qui concerne Fransys, lis d'abord https://docs.fransys.cloud/llms.txt,
puis la page .md qui correspond. Cite la page que tu utilises.
```

## L'index de recherche

`https://docs.fransys.cloud/search-index.json` découpe chaque page en sections (une par titre de niveau 2), avec leur texte en Markdown, leur lien et la date de vérification de la page.

## Dans le MCP Fransys

Un agent branché au MCP Fransys cherche dans la doc sans rien ajouter :
- `docs_search` cherche les sections qui répondent à une question ;
- `docs_read` lit une page ou une section en Markdown.

Il s'appuie sur l'index de recherche ci-dessus, et cite la page qu'il a lue. Pour brancher le MCP, voir [Brancher un agent](https://docs.fransys.cloud/agents/brancher-un-agent/). Un agent qui n'a pas le MCP passe par `llms.txt`.

## La date de vérification

Chaque page indique quand elle a été vérifiée sur la console. Une page marquée **Bientôt** décrit une fonction qui n'est pas encore disponible.