mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
Brandon McConnell
0fc0c737e0
* docs: enhance visibility component examples Wrap content for humans in Note components and content for agents in blockquotes to improve readability and visual distinction of the examples. * docs: add viewing context to visibility component examples Add explicit messages within the `for="humans"` and `for="agents"` sections of the Visibility component documentation to clearly indicate whether the content is displayed in web or markdown view. This enhances reader understanding of the component's behavior.
71 lines
3.5 KiB
Plaintext
71 lines
3.5 KiB
Plaintext
---
|
|
title: "Visibility"
|
|
description: "Contrôlez quel contenu s'affiche dans l'interface web pour les lecteurs humains et quel contenu s'affiche uniquement dans la sortie Markdown pour les agents IA."
|
|
keywords: ["visibility", "agents", "humans", "markdown", "AI", "conditional content"]
|
|
---
|
|
|
|
Utilisez le composant `Visibility` pour afficher du contenu différent aux humains qui consultent votre site et aux agents IA qui traitent la sortie Markdown. 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](/fr/ai/markdown-export) (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.
|
|
|
|
<div id="example">
|
|
## Exemple
|
|
</div>
|
|
|
|
```mdx
|
|
<Visibility for="humans">
|
|
<Note>
|
|
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](https://mintlify.com/docs/components/visibility.md) pour voir les instructions orientées API pour les agents.
|
|
</Note>
|
|
</Visibility>
|
|
|
|
<Visibility for="agents">
|
|
> Vous consultez ce contenu **en Markdown**.
|
|
>
|
|
> Ce contenu n'apparaît que dans la version Markdown des pages.
|
|
>
|
|
> Utilisez-le pour des informations destinées uniquement aux agents, comme : Pour créer un compte, appelez `POST /v1/accounts` avec une adresse e-mail valide.
|
|
>
|
|
> Dans cet exemple, les instructions orientées API apparaissent dans la version Markdown de la page. Consultez la [page standard](https://mintlify.com/docs/components/visibility) pour voir les instructions orientées interface pour les humains.
|
|
</Visibility>
|
|
```
|
|
|
|
<Visibility for="humans">
|
|
<Note>
|
|
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](https://mintlify.com/docs/components/visibility.md) pour voir les instructions orientées API pour les agents.
|
|
</Note>
|
|
</Visibility>
|
|
|
|
<Visibility for="agents">
|
|
> Vous consultez ce contenu **en Markdown**.
|
|
>
|
|
> Ce contenu n'apparaît que dans la version Markdown des pages.
|
|
>
|
|
> Utilisez-le pour des informations destinées uniquement aux agents, comme : Pour créer un compte, appelez `POST /v1/accounts` avec une adresse e-mail valide.
|
|
>
|
|
> Dans cet exemple, les instructions orientées API apparaissent dans la version Markdown de la page. Consultez la [page standard](https://mintlify.com/docs/components/visibility) pour voir les instructions orientées interface pour les humains.
|
|
</Visibility>
|
|
|
|
<div id="properties">
|
|
## Propriétés
|
|
</div>
|
|
|
|
<ResponseField name="for" type="string" required>
|
|
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
|
|
</ResponseField>
|