# Mettre ta doc en ligne et activer l'assistant

Ta doc tourne sur ton poste. Ce tutoriel la publie, relie le site à la console et active l’assistant. Il faut un compte HGDC pour la console.

**Avant de commencer** : une doc qui se construit en local ([Ta première doc en local](/docs/demarrer/premiere-doc/)), un dépôt GitHub, un projet dans Host, et un compte HGDC. Pour créer le projet dans la console, il faut être **admin** de l’organisation.

1. **Publier avec Host**

   Importe le dépôt de ta doc dans Host. À chaque mise en production, Host construit le site et le sert sur l’adresse de ton projet. La console lit ce site publié : tant qu’il n’est pas en ligne, il n’y a rien à indexer.

   Le détail de la publication se trouve dans la [documentation de Host](https://host.hgdc.ch/docs/).

2. **Ouvrir la console**

   Va sur `https://docs.hgdc.ch` et connecte-toi avec ton compte HGDC. Si tu n’as aucune organisation, crée-la dans Account ou demande à un admin de t’inviter, puis reconnecte-toi.

3. **Créer le projet**

   Clique sur **Nouveau projet** et renseigne :

   - **Nom** : entre 2 et 80 caractères. Il apparaît dans la console et dans l’assistant.
   - **Adresse du site** : l’adresse publique de ta doc, par exemple `https://docs.acme.ch`.
   - **Dépôt GitHub** : facultatif, au format `propriétaire/nom`.

   Enregistre. La console affiche l’identifiant du projet et la ligne à copier.

4. **Ajouter l'identifiant à docs.json**

   Copie la ligne que propose la console dans `docs.json`, par exemple :

   ```json
   { "project": "k57a8m2x9q4n1b3c5d7e9f0g2h4j6k8m" }
   ```

   Pousse le changement. Le site publié doit porter l’identifiant de son propre projet : sinon la console refuse de l’indexer.

5. **Synchroniser**

   Dans l’aperçu du projet, clique sur **Synchroniser**. La console lit `/_hgdc/corpus.json` sur ton site, indexe chaque page, puis passe à **À jour**. Ensuite, elle relit le site toutes les quinze minutes.

6. **Poser une question**

   Ouvre ton site, clique sur **Demander à l’IA** ou tape `Ctrl I`, et pose une question dont la réponse est dans ta doc. La réponse cite les sections utilisées.

   Tu peux aussi tester depuis la console, dans **Assistant**, avec **Tester l’assistant**.

## Si ça ne marche pas

- **Le bouton « Demander à l’IA » n’apparaît pas** : `docs.json` ne porte pas de `project`, ou `assistant.enabled` vaut `false`. Vérifie les deux, puis republie.
- **La console affiche « Pas encore indexé »** : aucune synchronisation n’a réussi. Lance **Synchroniser** et lis le message d’erreur s’il y en a un.
- **La synchronisation échoue** : chaque message et sa solution sont dans [Erreurs de synchronisation](/docs/reference/erreurs-de-synchronisation/).

## Et ensuite

- [Adresse du site et domaines](/docs/guides/adresses-du-site/) pour servir la doc sur plusieurs adresses.
- [Activer ou couper l’assistant](/docs/guides/activer-ou-couper-l-assistant/).
- [Connecter un agent au serveur MCP](/docs/guides/serveur-mcp/).