Samenwerken met andere auteurs en editors
Werk samen met andere auteurs en editors met behulp van op rollen gebaseerd toegangsbeheer van Azure (Azure RBAC) dat is geplaatst op uw QnA Maker-resource.
Notitie
De QnA Maker-service wordt op 31 maart 2025 buiten gebruik gesteld. Een nieuwere versie van de vraag- en antwoordmogelijkheid is nu beschikbaar als onderdeel van Azure AI Language. Zie vraagantwoording voor vragen in de Language Service voor het beantwoorden van vragen. Vanaf 1 oktober 2022 kunt u geen nieuwe QnA Maker-resources maken. Raadpleeg de migratiehandleiding voor informatie over het migreren van bestaande QnA Maker-knowledge bases om vragen te beantwoorden.
Er wordt toegang geboden op de QnA Maker-resource
Alle machtigingen worden beheerd door de machtigingen die zijn geplaatst op de QnA Maker-resource. Deze machtigingen zijn afgestemd op lees-, schrijf-, publicatie- en volledige toegang. U kunt samenwerking tussen meerdere gebruikers toestaan door RBAC-toegang bij te werken voor QnA Maker-resource.
Deze Azure RBAC-functie omvat:
- Microsoft Entra-id is 100% achterwaarts compatibel met verificatie op basis van sleutels voor eigenaren en inzenders. Klanten kunnen verificatie op basis van sleutels of verificatie op basis van Azure RBAC gebruiken in hun aanvragen.
- Voeg snel auteurs en editors toe aan alle knowledge bases in de resource omdat het beheer zich op resourceniveau bevindt, niet op knowledge base-niveau.
Notitie
Zorg ervoor dat u een aangepast subdomein voor de resource toevoegt. Aangepast subdomein moet standaard aanwezig zijn, maar als dat niet het geval is, voegt u het toe
Toegang wordt geleverd door een gedefinieerde rol
De volgende rollen zijn beschikbaar voor samenwerking:
| Role | Functies | API-toegang | API-machtigingen |
|---|---|---|---|
| Eigenaar | Alle | Verificatiesleutel | Alle |
| Cognitive Services-inzender | Alles behalve de mogelijkheid om nieuwe leden toe te voegen aan rollen | Verificatiesleutel | Alles behalve de mogelijkheid om nieuwe leden toe te voegen aan rollen |
| QnA Maker-lezer voor Cognitive Services (lezen) |
Exporteren/downloaden Testen |
Bearer-token | 1. KB API downloaden 2. KBs voor gebruikers-API vermelden 3. Details van knowledge base ophalen 4. Wijzigingen downloaden Antwoord genereren |
| Cognitive Services QnA Maker-editor (lezen/schrijven) |
Exporteren/downloaden Testen KB bijwerken KB exporteren KB importeren KB vervangen KB maken |
Bearer-token | 1. KB-API maken 2. KB API bijwerken 3. KB API vervangen 4. Wijzigingen vervangen 5. "Train API" [in nieuw servicemodel v5] |
| Cognitive Services-gebruiker (lezen/schrijven/publiceren) |
Alle | Verificatiesleutel | Alle toegang tot azure AI-servicesresources, met uitzondering van de mogelijkheid om: 1. Voeg nieuwe leden toe aan rollen. 2. Nieuwe resources maken. |
Verificatiestroom
In het volgende diagram ziet u de stroom, vanuit het perspectief van de auteur, voor het aanmelden bij de QnA Maker-portal en het gebruik van de creatie-API's.
| Stappen | Beschrijving |
|---|---|
| 1 | Portal verwerft token voor QnA Maker-resource. |
| 2 | Portal roept de juiste QnA Maker-creatie-API (APIM) aan die het token doorgeeft in plaats van sleutels. |
| 3 | De QnA Maker-API valideert het token. |
| 4 | QnA Maker-API roept QnAMaker Service aan. |
Als u de creatie-API's wilt aanroepen, vindt u meer informatie over het instellen van verificatie.
Verifiëren door de QnA Maker-portal
Als u met behulp van de QnA Maker-portal ontwerpt en samenwerkt, beheert de QnA Maker-portal, nadat u de juiste rol aan de resource voor een samenwerker hebt toegevoegd, alle toegangsmachtigingen.
Verifiëren door QnA Maker-API's en SDK's
Als u de API's ontwerpt en samenwerkt via REST of de SDK's, moet u een service-principal maken om de verificatie te beheren.
Volgende stap
- Een knowledge base ontwerpen voor talen en voor clienttoepassingen