Passer au contenu principal
L’assistant répond uniquement à partir de votre documentation publiée et de vos spécifications d’API, ainsi que des domaines de recherche que vous ajoutez. Lorsque vous publiez des modifications, l’assistant indexe immédiatement le contenu nouveau, mis à jour ou supprimé. Il n’indexe pas les branches de brouillon ni les déploiements de prévisualisation. Pour améliorer les réponses, trouvez les questions auxquelles l’assistant n’a pas pu répondre, puis corrigez le contenu à partir duquel il répond. Utilisez des instructions personnalisées et des skills pour définir sa façon de répondre.

​
Trouver les questions auxquelles l’assistant n’a pas pu répondre

La liste Unanswered conversations des analyses de l’assistant affiche toutes les conversations auxquelles l’assistant n’a pas pu répondre à partir de votre documentation. Ouvrez une transcription pour voir ce que l’utilisateur a demandé, puis ajoutez ou mettez à jour le contenu qui y répond.

​
Ajouter du contexte que les utilisateurs ne voient pas

Par défaut, l’assistant n’indexe pas les pages masquées. Pour inclure les pages masquées dans l’index de l’assistant, définissez seo.indexing: "all" dans votre docs.json. Utilisez des pages masquées pour le contexte que les utilisateurs n’ont pas besoin de parcourir, mais que l’assistant peut consulter. Consultez Pages masquées pour savoir comment chaque paramètre de page affecte l’assistant. Pour présenter du contexte uniquement à l’assistant et aux autres outils d’IA sur une page publiée, encadrez-le avec le composant Visibility et for="agents".

​
Exclure du contenu des réponses

Pour exclure une page visible des réponses de l’assistant, définissez searchable: false dans le frontmatter de la page. La page reste dans votre navigation, mais la recherche du site et l’assistant l’ignorent. Consultez Pages masquées pour d’autres options.

​
Restreindre les réponses par groupe d’utilisateurs

Si votre site nécessite une authentification, l’assistant respecte les groupes d’utilisateurs. Il répond à chaque utilisateur connecté uniquement à partir des pages auxquelles cet utilisateur a accès.

​
Domaines de recherche

Les domaines de recherche nécessitent une offre Enterprise.
Dans la section Gestion des réponses, configurez les domaines que l’assistant peut utiliser pour effectuer des recherches web afin de trouver un contexte supplémentaire lorsqu’il répond aux questions.
  • Les domaines doivent être accessibles publiquement.
  • L’assistant ne peut pas effectuer de recherches sur les domaines nécessitant JavaScript pour se charger.
Pour un contrôle plus précis sur ce que l’assistant peut rechercher, utilisez la syntaxe de filtrage.
  • Filtrage au niveau du domaine
    • example.com : Rechercher uniquement sur le domaine example.com
    • docs.example.com : Rechercher uniquement sur le sous-domaine docs.example.com
    • *.example.com : Rechercher sur tous les sous-domaines de example.com
  • Filtrage au niveau du chemin
    • docs.example.com/api : Rechercher toutes les pages sous le sous-chemin /api
  • Plusieurs motifs
    • Ajoutez plusieurs entrées pour cibler différentes sections de sites

​
Rédiger du contenu exploitable par l’assistant

L’assistant répond mieux lorsque votre contenu est facile à trouver et à comprendre. Une organisation claire et un contexte complet aident à la fois les personnes et les outils d’IA.
  • Rédigez des titres descriptifs et des descriptions de frontmatter précises pour chaque page.
  • Définissez les termes et acronymes lors de leur première utilisation.
  • Incluez des exemples et des cas d’usage, et liez les sujets connexes.
  • Découpez les longs blocs de texte en paragraphes plus courts.