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), 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.

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 :

   { "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.

Et ensuite

• Adresse du site et domaines pour servir la doc sur plusieurs adresses.
• Activer ou couper l’assistant.
• Connecter un agent au serveur MCP.