Collaborer avec d’autres auteurs et éditeurs
Collaborez avec d’autres auteurs et éditeurs à l’aide du contrôle d’accès en fonction du rôle Azure (Azure RBAC) placé sur votre ressource QnA Maker.
Notes
Le service QnA Maker sera mis hors service le 31 mars 2025. Une version plus récente de la fonctionnalité de questions et réponses est désormais disponible dans le cadre d’Azure AI Language. Pour obtenir des réponses aux questions au sein du service de langage, consultez Réponses aux questions. À partir du 1er octobre 2022 vous ne pourrez plus créer de nouvelles ressources QnA Maker. Pour plus d’informations sur la migration de bases de connaissances QnA Maker existantes vers Réponses aux questions, consultez le Guide de migration.
L’accès est fourni sur la ressource QnA Maker
Toutes les autorisations sont contrôlées par les autorisations placées sur la ressource QnA Maker. Ces autorisations permettent la lecture, l’écriture, la publication et l’accès complet. Vous pouvez autoriser la collaboration entre plusieurs utilisateurs en mettant à jour l’accès RBAC pour la ressource QnA Maker.
Cette fonctionnalité Azure RBAC comprend :
- Microsoft Entra ID offre une compatibilité descendante de 100 % avec l’authentification basée sur les clés pour les propriétaires et les contributeurs. Les clients peuvent utiliser l’authentification par clé ou via Azure RBAC pour leurs requêtes.
- Ajoutez rapidement des auteurs et des éditeurs à toutes les bases de connaissances de la ressource, car le contrôle se trouve au niveau de la ressource, et non au niveau de la base de connaissances.
Notes
Veillez à ajouter un sous-domaine personnalisé pour la ressource. Le sous-domaine personnalisé doit être présent par défaut, mais si ce n’est pas le cas, ajoutez-le
L’accès est fourni par un rôle défini
Les rôles suivants sont fournis pour la collaboration :
| Role | Fonctionnalités | Accès à l’interface de programmation d’applications | Autorisations des API |
|---|---|---|---|
| Propriétaire | Tous | Clé d’authentification | Tous |
| Contributeur Cognitive Services | Tout sauf la possibilité d’ajouter de nouveaux membres aux rôles | Clé d’authentification | Tout sauf la possibilité d’ajouter de nouveaux membres aux rôles |
| Lecteur QnA Maker Cognitive Services (lecture) |
Export/Téléchargement Test |
Jeton du porteur | 1. Téléchargement de l’API KB 2. Classement des API KB pour l’API utilisateur 3. Obtenir des détails sur la base de connaissances 4. Téléchargement des modifications Génération de la réponse |
| Éditeur QnA Maker Cognitive Services (lecture/écriture) |
Export/Téléchargement Test Mise à jour KB Exportation KB Importation KB Remplacement KB Créer la base de connaissances |
Jeton du porteur | 1. Création de l’API KB 2. Mise à jour de l’API KB 3. Remplacement de l’API KB 4. Remplacement des modifications 5. « API Train » [dans le nouveau modèle de service v5] |
| Utilisateur Cognitive Services (lecture/écriture/publication) |
Tous | Clé d’authentification | Tous les accès à la ressource Azure AI Services, à l’exception des possibilités suivantes : 1. Ajouter de nouveaux membres aux rôles. 2. Créer des ressources. |
Flux d’authentification
Le diagramme suivant illustre le flux, du point de vue de l’auteur, pour la connexion au portail QnA Maker et l’utilisation des API de création.
| Étapes | Description |
|---|---|
| 1 | Le portail acquiert un jeton pour la ressource QnA Maker. |
| 2 | Le portail appelle l’API de création QnA Maker (APIM) appropriée, et transmet le jeton à la place des clés. |
| 3 | L’API QnA Maker valide le jeton. |
| 4 | L’API QnA Maker appelle le service QnAMaker. |
Si vous envisagez d’appeler les API de création, découvrez-en plus à propos de la configuration de l’authentification.
S’authentifier à l’aide du portail QnA Maker
Si vous créez et collaborez à l’aide du portail QnA Maker, après avoir ajouté le rôle approprié à la ressource pour un collaborateur, le portail QnA Maker gère toutes les autorisations d’accès.
S’authentifier à l’aide des API et Kits de développement logiciel (SDK) QnA Maker
Si vous créez et collaborez à l’aide des API, via REST ou des Kits de développement logiciel (SDK), vous devez créer un principal de service afin de gérer l’authentification.
Étape suivante
- Concevoir une base de connaissances pour les langages et les applications clientes