Synchronisez les réponses IA avec votre documentation
Publier une modification de documentation et actualiser un assistant sont deux événements distincts. Une tâche de capture récurrente les relie en revisitant la documentation sélectionnée et en intégrant le texte actuel au jeu de données.
La planification doit suivre le processus de publication de la documentation, et non un objectif SEO arbitraire.
Faites correspondre les tâches aux versions de la documentation
Si la documentation actuelle et l’ancienne se trouvent sous des chemins différents, capturez-les dans des jeux de données distincts ou excluez les versions qui ne doivent pas répondre aux questions publiques.
Par exemple, incluez le chemin de la documentation actuelle et excluez les chemins d’archives ou de versions qui ne s’appliquent plus. Vérifiez les noms d’hôte autorisés lorsque la documentation utilise des sous-domaines.
Choisissez la planification
| Rythme de publication | Approche de départ |
|---|---|
| Petites modifications continues | Capture quotidienne |
| Plusieurs mises à jour par jour | Capture toutes les quelques heures si la fraîcheur l’exige |
| Cycle de publication hebdomadaire | Capture après la publication ou tous les sept jours |
| Documentation de conformité contrôlée | Capture manuelle après validation |
Seekdown propose des intervalles allant de toutes les heures à tous les sept jours, ainsi que l’option Never.
Ajoutez des contrôles de fraîcheur à la publication
Pour chaque modification importante de la documentation :
- nommez la page modifiée ;
- consignez une question concernée par la modification ;
- confirmez que la capture suivante se termine ;
- retrouvez la nouvelle formulation dans le jeu de données ;
- posez la question consignée ; et
- ouvrez la citation.
C’est plus fiable que de vérifier uniquement l’horodatage de la capture. Une tâche terminée peut tout de même avoir manqué une URL à cause des règles de chemins, de la profondeur ou d’une erreur de page.
Gérez les suppressions et les contradictions
Lorsqu’un contournement ou une ancienne option est supprimé, recherchez l’ancienne formulation dans le reste du jeu de données. Les notes de version, les pages traduites et les copies en cache peuvent continuer à étayer la réponse obsolète.
Ne demandez pas à l’assistant de choisir en silence entre des documentations contradictoires. Désignez une seule source actuelle, supprimez la page obsolète ou indiquez explicitement la limite de version.
L’exploration récurrente fait évoluer la copie des sources. Les questions de non-régression montrent si la réponse a évolué avec elle.