Passer au contenu principal
Utilisez le composant Visibility pour afficher un contenu différent à différentes audiences sur une même page. Vous pouvez cibler les humains qui consultent votre site, les agents IA qui traitent la sortie Markdown, ou les lecteurs en fonction de leur état de connexion et de leurs groupes d’utilisateurs. Cela vous permet de personnaliser les informations pour chaque audience sans maintenir des pages séparées. Sur votre site publié, le contenu marqué for="humans" s’affiche normalement et le contenu marqué for="agents" est masqué. Dans les vues de page Markdown (URLs .md), c’est l’inverse : le contenu pour les agents est rendu dans la sortie Markdown et le contenu réservé aux humains ne l’est pas. Les mêmes règles s’appliquent au fichier llms-full.txt.

​
Exemple

Vous consultez ce contenu sur le web.Ce contenu s’affiche normalement sur les pages standard de votre site.Utilisez-le pour une étape comme : Cliquez sur le bouton Get started dans le coin supérieur droit pour créer votre compte.Dans cet exemple, les instructions orientées interface apparaissent sur la page standard. Consultez la version Markdown de cette page pour voir les instructions orientées API pour les agents.

​
Afficher du contenu selon l’état de connexion ou le groupe

Si votre site utilise l’authentification, vous pouvez afficher du contenu selon qu’un lecteur est connecté ou selon les groupes auxquels il appartient.
  • Le contenu signed-in s’affiche uniquement pour les lecteurs ayant une session active.
  • Le contenu signed-out s’affiche uniquement pour les lecteurs non connectés.
  • Le contenu groups s’affiche uniquement pour les lecteurs connectés qui appartiennent à au moins un des groupes répertoriés.
Les vues de page Markdown et llms-full.txt sont identiques pour tous les lecteurs. Les agents obtiennent donc toujours la vue non connectée. Mintlify supprime le contenu signed-in et groups de la sortie Markdown et inclut le contenu signed-out. Pour vérifier ces règles en local, exécutez mint dev --signed-in ou mint dev --groups. Sans l’un ou l’autre de ces flags, la prévisualisation locale affiche la vue non connectée.
Les règles de connexion et de groupe masquent le contenu uniquement dans le navigateur. Mintlify envoie tout de même le contenu masqué au navigateur de chaque lecteur. Pour restreindre l’accès à un contenu sensible, placez-le sur une page distincte et utilisez la propriété de frontmatter groups.

​
Propriétés

​
string | object
requis
L’audience du contenu encapsulé. Doit être l’un des suivants :
  • humans : Contenu visible sur le web et exclu de la sortie Markdown.
  • agents : Contenu masqué sur le web et inclus dans la sortie Markdown.
  • signed-in : Contenu visible sur le web pour les lecteurs connectés et exclu de la sortie Markdown.
  • signed-out : Contenu visible sur le web pour les lecteurs non connectés et inclus dans la sortie Markdown.
  • { groups: [...] } : Contenu visible sur le web pour les lecteurs connectés appartenant à au moins un des groupes répertoriés et exclu de la sortie Markdown.
Utilisez une valeur statique. Mintlify exclut de la sortie Markdown le contenu dont la valeur for est calculée, comme une variable ou une expression conditionnelle.

Sujets connexes

AperçuPrévisualisation localeExport Markdown