Afficher du contenu à des lecteurs spécifiques
Afficher différents contenus à différents lecteurs : les fonctionnalités d’une offre uniquement aux clients qui y ont souscrit, la documentation partenaire uniquement aux partenaires, et les notes internes uniquement à votre agent IA. Les lecteurs sont répartis en groupes selon les informations que votre produit transmet lorsqu’ils se connectent. Chaque section, collection et article détermine qui peut le consulter.
Les groupes d’utilisateurs et le contenu à accès limité sont disponibles avec les offres Pro et Enterprise. Les propriétaires et les administrateurs peuvent modifier ces paramètres.
Qui peut le consulter
Définissez l’audience d’une section ou d’une collection dans l’onglet Accès, et celle d’un article dans ses paramètres. Chaque niveau peut uniquement restreindre l’audience définie au niveau supérieur.
Hériter : les mêmes lecteurs qu’au niveau supérieur. Il s’agit du paramètre par défaut.
Lecteurs connectés (pour un article, Toute personne connectée) : toute personne disposant d’un compte dans le centre d’aide.
Groupes spécifiques (pour un article, Groupes d’utilisateurs spécifiques) : uniquement les lecteurs appartenant aux groupes que vous sélectionnez.
Pour une section ou une collection, choisissez également ce que les autres voient : Afficher avec un cadenas affiche le titre, accompagné de votre message et d’un bouton de connexion ; Masquer ne l’affiche pas du tout. Un article dont l’accès est limité individuellement est toujours masqué aux lecteurs qui ne peuvent pas l’ouvrir. Les moteurs de recherche et les robots d’exploration IA n’ont jamais accès au contenu à accès limité.
Une référence d’API n’a pas d’audience propre. Elle suit celle de sa section : placez-la donc dans une section réservée au groupe concerné. Consultez Publier une référence d’API.
Où un article est répertorié
Indépendamment des personnes qui peuvent le consulter, Répertorié dans détermine où un article apparaît :
Paramètre | Barre latérale | Recherche et votre agent IA |
|---|---|---|
Partout (par défaut) | Oui | Oui |
Non répertorié | Non | Oui |
Masqué | Non, lien direct uniquement | Non |
Agent IA uniquement | Non, et les lecteurs ne peuvent pas l’ouvrir | Utilisé uniquement par votre agent IA |
Créer des groupes à partir des propriétés des lecteurs
Un groupe est une règle définie à partir des propriétés des lecteurs, par exemple plan is enterprise. Les lecteurs rejoignent et quittent automatiquement les groupes à mesure que leurs propriétés changent. Créez des groupes dans Centre d’aide > Contrôle d’accès > Groupes. Un lecteur doit remplir toutes les conditions d’une règle.
Les propriétés sont transmises par votre produit lorsque les lecteurs s’y connectent ou se connectent avec OIDC. Un développeur doit configurer cela : consultez Connecter les lecteurs avec JWT ou OIDC. Vous pouvez également modifier manuellement les propriétés d’un lecteur dans l’onglet Utilisateurs, mais sa prochaine connexion via votre produit les remplacera.
Fonctionnement des règles :
Listes : lorsqu’une propriété est une liste, par exemple
modules: ["csrd", "esg"], les opérateurs est et contient correspondent tous deux si un élément est égal à la valeur. est l’un de correspond si un élément est égal à l’une de vos valeurs.Texte : contient correspond à une partie du texte. est exige la valeur entière. Les deux opérateurs sont sensibles à la casse.
Propriétés imbriquées : utilisez un point pour les désigner, par exemple
frameworks.csrd.Oui ou non, et nombres : la valeur
trueou25correspond à une propriété transmise sous la forme de la valeur true ou du nombre 25.
Un lecteur connecté avec le mot de passe partagé n’a aucune propriété ; les groupes ne s’appliquent donc jamais à lui.
Ce que votre agent IA sait de chaque lecteur
Votre agent IA répond uniquement à partir du contenu que le lecteur connecté peut consulter. Il voit également les noms des groupes du lecteur et, si le widget l’a connecté, son nom, son adresse e-mail et ses propriétés. Il tient compte de ces informations lorsqu’elles sont pertinentes pour la question, sans les répéter. Donnez aux groupes des noms que vous utiliseriez pour les décrire à un client, comme « Module CSRD », car l’agent peut reprendre ces noms dans ses réponses.