# Synchroniser et vérifier l'index

Le résultat : l’index de l’assistant reflète la dernière version publiée de ta doc.

**Avant de commencer** : un projet dans la console et un site publié qui porte l’identifiant du projet dans `docs.json`.

## Quand la console relit ton site

La console relit le site dans quatre cas :

| Déclencheur     | Ce qui le lance                                          |
| --------------- | -------------------------------------------------------- |
| **À la main**   | Le bouton **Synchroniser** de l’aperçu du projet.        |
| **Automatique** | Un passage toutes les quinze minutes, sur chaque projet. |
| **Host**        | Une mise en production dans Host.                        |
| **Création**    | La création du projet.                                   |

Le journal des publications de la console indique le déclencheur de chaque lecture.

Une lecture identique à la précédente n’écrit rien : la console compare le contenu publié avec son index, et ne traite que ce qui change.

## Ce que fait une synchronisation

1. Elle lit `/_hgdc/corpus.json` sur ton site et vérifie que le fichier porte l’identifiant du projet.
2. Elle découpe chaque page en passages, un par section.
3. Elle compare les passages avec l’index. Seuls les passages nouveaux ou modifiés sont traités.
4. Elle supprime les passages qui ne sont plus publiés.

Pendant qu’elle tourne, l’état affiche **Synchronisation…**.

## Lire l’état

| État dans la console   | Sens                                                   |
| ---------------------- | ------------------------------------------------------ |
| **Jamais synchronisé** | Aucune lecture n’a encore réussi.                      |
| **Synchronisation…**   | Une lecture est en cours.                              |
| **À jour**             | La dernière lecture a réussi.                          |
| **Échec**              | La dernière lecture a échoué. Le message dit pourquoi. |

Une lecture planifiée qui échoue ne s’inscrit dans le journal que si elle change quelque chose : une panne déjà signalée ne se répète pas à chaque passage.

## Vérifier après une publication

1. Publie ta doc.
2. Ouvre l’aperçu du projet et clique sur **Synchroniser**. La console confirme : « Synchronisation lancée. L’index se met à jour dans un instant. »
3. Attends l’état **À jour**.
4. Pose une question dont la réponse vient de la modification. La section citée doit être la nouvelle.

Tu peux aussi attendre la synchronisation automatique, dans un quart d’heure au plus.

## Limites

- Quatre synchronisations par minute et par projet, dix par minute et par organisation. Au-delà, la console répond : « Attends une minute avant de relancer la synchronisation. »
- Une seule synchronisation à la fois sur un projet. Une lecture restée en cours plus de quinze minutes est close en échec.
- Une doc de plus de 6 000 passages n’est pas indexée. Le détail des limites est dans [Limites](/docs/reference/limites/).

## Si ça ne marche pas

Lis le message de l’état **Échec**, puis cherche-le dans [Erreurs de synchronisation](/docs/reference/erreurs-de-synchronisation/). La plupart des messages se règlent sur le site : corrige, reconstruis, republie, puis clique sur **Synchroniser**.

Quand le budget quotidien de calcul sémantique est atteint, la console le signale : une partie de l’index reste alors en recherche par mots, et le reste s’indexe le lendemain.