Adresse du site et domaines

Le résultat : la console lit ton site à la bonne adresse, et l’assistant répond sur chacune des adresses où ta doc est servie.

Avant de commencer : un projet dans la console, et un site publié sur une adresse publique.

Deux réglages, dans Réglages du projet, décident de l’adresse :

• Adresse du site : d’où la console lit /_hgdc/corpus.json.
• Autres adresses du site : les autres domaines où la doc est servie. L’assistant n’y répond que depuis ces adresses.

Règles de l’adresse du site

• Elle commence par https://. Une adresse en http:// est refusée.
• Elle pointe vers un nom de domaine public. Une adresse privée, locale ou réservée est refusée.
• Elle utilise le port standard, sans port écrit.
• Elle n’a ni paramètres (?) ni ancre (#).
• Elle peut porter un seul chemin, par exemple https://app.acme.ch/docs pour une doc servie sous /docs.
• La console ne suit pas les redirections. Indique l’adresse finale.

Quand la doc est servie sous un chemin, indique le même chemin dans docs.json, avec base :

{ "base": "/docs" }

Autres adresses du site

Ajoute ici les autres domaines de ta doc, par exemple aide.acme.ch. Une seule origine suffit : https://aide.acme.ch. Un chemin saisi est ignoré. Tu peux en déclarer 10 au plus.

Un visiteur qui pose une question depuis une autre adresse reçoit un refus : l’assistant ne répond que sur les domaines du projet.

Doc publiée par Host

Quand Host publie la doc, l’adresse se règle dans Host, au domaine de production du projet. La console l’affiche alors en lecture seule, avec ce renvoi. Les autres adresses, elles, se gèrent toujours dans la console.

Si ça ne marche pas

• L'adresse du site doit commencer par https:// : passe en https://.
• Le site doit répondre sur le port standard (443) : retire le numéro de port.
• Adresse invalide : le domaine, suivi au plus d'un chemin : ne garde qu’un chemin, comme /docs.
• redirige ailleurs : remplace l’adresse par l’adresse finale du site.
• ne se résout pas : le DNS du domaine n’est pas encore en place, ou le nom est mal orthographié.
• L’assistant répond « Cet assistant ne répond que depuis son site de documentation » : l’adresse de la page n’est ni l’adresse du site ni une des autres adresses. Ajoute-la.