Azure-resources voor QnA Maker
QnA Maker maakt gebruik van verschillende Azure-bronnen, elk met een ander doel. Als u begrijpt hoe ze afzonderlijk worden gebruikt, kunt u de juiste prijscategorie plannen en selecteren of weten wanneer u uw prijscategorie wilt wijzigen. Als u begrijpt hoe ze in combinatie worden gebruikt, kunt u problemen vinden en oplossen wanneer ze optreden.
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.
Resourceplanning
Wanneer u voor het eerst een QnA Maker-knowledge base ontwikkelt, is het gebruikelijk om in de prototypefase één QnA Maker-resource te hebben voor zowel testen als productie.
Wanneer u overstapt naar de ontwikkelingsfase van het project, moet u rekening houden met het volgende:
- Hoeveel talen bevat uw Knowledge Base-systeem?
- In hoeveel regio's moet uw Knowledge Base beschikbaar zijn?
- Hoeveel documenten in elk domein bevat uw systeem?
Plan om één QnA Maker-resource te hebben met alle knowledge bases met dezelfde taal, dezelfde regio en dezelfde combinatie van onderwerpdomein.
Overwegingen voor prijscategorieën
Doorgaans zijn er drie parameters die u moet overwegen:
De doorvoer die u nodig hebt van de service:
- Selecteer het juiste App-plan voor uw App Service op basis van uw behoeften. U kunt de app omhoog of omlaag schalen.
- Dit moet ook invloed hebben op de selectie van uw Azure Cognitive Search-SKU. Zie hier meer informatie. Daarnaast moet u mogelijk de Cognitive Search-capaciteit aanpassen met replica's.
Grootte en het aantal knowledge bases: kies de juiste Azure Search-SKU voor uw scenario. Doorgaans bepaalt u het aantal knowledge bases dat u nodig hebt op basis van het aantal verschillende onderwerpdomeinen. Zodra het onderwerpdomein (voor één taal) zich in één knowledge base bevindt.
Uw Azure Search-service-resource moet na januari 2019 zijn gemaakt en mag zich niet in de gratis (gedeelde) laag bevinden. Er is geen ondersteuning voor het configureren van door de klant beheerde sleutels in Azure Portal.
Belangrijk
U kunt N-1 knowledge bases publiceren in een bepaalde laag, waarbij N de maximumindexen is die zijn toegestaan in de laag. Controleer ook de maximale grootte en het aantal documenten dat per laag is toegestaan.
Als uw laag bijvoorbeeld 15 toegestane indexen heeft, kunt u 14 knowledge bases (één index per gepubliceerde knowledge base) publiceren. De vijftiende index wordt gebruikt voor alle knowledge bases voor ontwerpen en testen.
- Aantal documenten als bronnen: De gratis SKU van de QnA Maker-beheerservice beperkt het aantal documenten dat u kunt beheren via de portal en de API's tot 3 (van elke grootte van 1 MB). De standaard-SKU heeft geen limieten voor het aantal documenten dat u kunt beheren. Hier vindt u meer informatie.
De volgende tabel bevat enkele richtlijnen op hoog niveau.
| QnA Maker-beheer | App Service | Azure AI Search | Beperkingen | |
|---|---|---|---|---|
| Experimenten | Gratis SKU | Gratis versie | Gratis versie | Publiceren tot 2 GB, 50 MB-grootte |
| Ontwikkel-/testomgeving | Standaard SKU | Gedeeld | Basis | Publiceren tot 14 GB, grootte van 2 GB |
| Productieomgeving | Standaard SKU | Basic | Standard | Publiceren tot 49 GB, grootte van 25 GB |
Aanbevolen Instellingen
| Doel-QPS | App Service | Azure AI Search |
|---|---|---|
| 3 | S1, één replica | S1, één replica |
| 50 | S3, 10 replica's | S1, 12 replica's |
| 80 | S3, 10 replica's | S3, 12 replica's |
| 100 | P3V2, 10 replica's | S3, 12 replica's, 3 partities |
| 200 tot 250 | P3V2, 20 replica's | S3, 12 replica's, 3 partities |
Wanneer moet u een prijscategorie wijzigen
| Upgraden | Reden |
|---|---|
| QnA Maker-beheer-SKU upgraden | U wilt meer QnA-paren of documentbronnen in uw Knowledge Base hebben. |
| App Service-SKU upgraden en de Azure AI Search-laag controleren en Cognitive Search-replica's maken | Uw Knowledge Base moet meer aanvragen van uw client-app verwerken, zoals een chatbot. |
| Azure AI-Search-service upgraden | U bent van plan om veel knowledge bases te hebben. |
Download de meest recente runtime-updates door uw App Service bij te werken in Azure Portal.
Sleutels in QnA Maker
Uw QnA Maker-service behandelt twee soorten sleutels: sleutels ontwerpen en eindpuntsleutels opvragen die worden gebruikt met de runtime die wordt gehost in de App Service.
Gebruik deze sleutels bij het indienen van aanvragen voor de service via API's.
| Naam | Location | Doel |
|---|---|---|
| Ontwerp-/abonnementssleutel | Azure-portal | Deze sleutels worden gebruikt voor toegang tot de QnA Maker-beheerservice-API's. Met deze API's kunt u de vragen en antwoorden in uw Knowledge Base bewerken en uw Knowledge Base publiceren. Deze sleutels worden gemaakt wanneer u een nieuwe QnA Maker-service maakt. Zoek deze sleutels op de Azure AI-servicesresource op de pagina Sleutels en eindpunt . |
| Query-eindpuntsleutel | QnA Maker-portal | Deze sleutels worden gebruikt om een query uit te voeren op het gepubliceerde Knowledge Base-eindpunt om een antwoord op een gebruikersvraag te krijgen. Doorgaans gebruikt u dit query-eindpunt in uw chatbot of in de clienttoepassingscode die verbinding maakt met de QnA Maker-service. Deze sleutels worden gemaakt wanneer u uw QnA Maker-knowledge base publiceert. Zoek deze sleutels op de pagina Service-instellingen . Zoek deze pagina in het menu van de gebruiker in de rechterbovenhoek van de pagina in de vervolgkeuzelijst. |
Ontwerpsleutels zoeken in Azure Portal
U kunt uw ontwerpsleutels bekijken en opnieuw instellen vanuit Azure Portal, waar u de QnA Maker-resource hebt gemaakt.
Ga naar de QnA Maker-resource in Azure Portal en selecteer de resource met het type Azure AI-services :
Ga naar Sleutels en eindpunt:
Queryeindpuntsleutels zoeken in de QnA Maker-portal
Het eindpunt bevindt zich in dezelfde regio als de resource omdat de eindpuntsleutels worden gebruikt om een aanroep naar de Knowledge Base te maken.
Eindpuntsleutels kunnen worden beheerd vanuit de QnA Maker-portal.
Meld u aan bij de QnA Maker-portal, ga naar uw profiel en selecteer vervolgens Service-instellingen:
Uw sleutels weergeven of opnieuw instellen:
Notitie
Vernieuw uw sleutels als u denkt dat ze zijn aangetast. Hiervoor zijn mogelijk overeenkomstige wijzigingen in uw clienttoepassing of botcode vereist.
Beheerserviceregio
De beheerservice van QnA Maker wordt alleen gebruikt voor de QnA Maker-portal en voor de eerste gegevensverwerking. Deze service is alleen beschikbaar in de regio VS - west. Er worden geen klantgegevens opgeslagen in deze SERVICE VS - west.
Overwegingen voor naamgeving van resources
De resourcenaam voor de QnA Maker-resource, zoals qna-westus-f0-b, wordt ook gebruikt om de andere resources een naam te geven.
In het venster Voor het maken van Azure Portal kunt u een QnA Maker-resource maken en de prijscategorieën voor de andere resources selecteren.
Nadat de resources zijn gemaakt, hebben ze dezelfde naam, met uitzondering van de optionele Application Insights-resource, die tekens naar de naam postpends.
Tip
Maak een nieuwe resourcegroep wanneer u een QnA Maker-resource maakt. Hiermee kunt u alle resources zien die zijn gekoppeld aan de QnA Maker-resource bij het zoeken op resourcegroep.
Tip
Gebruik een naamconventie om prijscategorieën aan te geven binnen de naam van de resource of de resourcegroep. Wanneer u fouten ontvangt bij het maken van een nieuwe knowledge base of het toevoegen van nieuwe documenten, is de limiet voor de prijscategorie Cognitive Search een veelvoorkomend probleem.
Resourcedoeleinden
Elke Azure-resource die is gemaakt met QnA Maker heeft een specifiek doel:
- QnA Maker-resource
- Cognitive Search-resource
- App Service
- App Plan Service
- Application Insights-service
QnA Maker-resource
De QnA Maker-resource biedt toegang tot de creatie- en publicatie-API's.
QnA Maker-resourceconfiguratie-instellingen
Wanneer u een nieuwe knowledge base maakt in de QnA Maker-portal, is de taalinstelling de enige instelling die op resourceniveau wordt toegepast. U selecteert de taal wanneer u de eerste knowledge base voor de resource maakt.
Cognitive Search-resource
De Cognitive Search-resource wordt gebruikt voor het volgende:
- De QnA-paren opslaan
- Geef de eerste rangschikking (ranker #1) van de QnA-paren op tijdens runtime
Indexgebruik
De resource houdt één index bij om te fungeren als de testindex en de resterende indexen correleren met één gepubliceerde knowledge base.
Een resource die is geprijsd voor 15 indexen, bevat 14 gepubliceerde knowledge bases en één index wordt gebruikt voor het testen van alle knowledge bases. Deze testindex wordt gepartitioneerd door knowledge base, zodat een query met behulp van het interactieve testvenster de testindex gebruikt, maar alleen resultaten retourneert van de specifieke partitie die is gekoppeld aan de specifieke Knowledge Base.
Taalgebruik
De eerste knowledge base die in de QnA Maker-resource is gemaakt, wordt gebruikt om te bepalen welke taal is ingesteld voor de Cognitive Search-resource en alle bijbehorende indexen. U kunt slechts één taal instellen voor een QnA Maker-service.
Eén Cognitive Search-service gebruiken
Als u een QnA-service en de bijbehorende afhankelijkheden (zoals Zoeken) maakt via de portal, wordt er een Search-service voor u gemaakt en gekoppeld aan de QnA Maker-service. Nadat deze resources zijn gemaakt, kunt u de App Service-instelling bijwerken om een eerder bestaande Search-service te gebruiken en de app te verwijderen die u zojuist hebt gemaakt.
Leer hoe u QnA Maker configureert voor het gebruik van een andere Azure AI-serviceresource dan de resource die is gemaakt als onderdeel van het proces voor het maken van QnA Maker-resources.
App Service- en App Service-plan
De App Service wordt door uw clienttoepassing gebruikt voor toegang tot de gepubliceerde Knowledge Bases via het runtime-eindpunt. App Service bevat de op NLP gebaseerde tweede classificatielaag (ranker #2) van de QnA-paren tijdens runtime. De tweede classificatie past intelligente filters toe die metagegevens en opvolgingsprompts kunnen bevatten.
Als u een query wilt uitvoeren op de gepubliceerde Knowledge Base, gebruiken alle gepubliceerde Knowledge Bases hetzelfde URL-eindpunt, maar geven u de knowledge base-id binnen de route op.
{RuntimeEndpoint}/qnamaker/knowledgebases/{kbId}/generateAnswer
Analyses van toepassingen
Application Insights wordt gebruikt voor het verzamelen van chatlogboeken en telemetriegegevens. Bekijk de algemene Kusto-query's voor informatie over uw service.
Services delen met QnA Maker
QnA Maker maakt verschillende Azure-resources. Als u het beheer en de voordelen van kostendeling wilt verminderen, gebruikt u de volgende tabel om te begrijpen wat u wel en niet kunt delen:
| Service | Delen | Reden |
|---|---|---|
| Azure AI-services | X | Niet mogelijk per ontwerp |
| App Service-plan | ✔ | Vaste schijfruimte die is toegewezen voor een App Service-plan. Als andere apps die hetzelfde App Service-plan delen, aanzienlijke schijfruimte gebruiken, ondervindt het QnAMaker App Service-exemplaar problemen. |
| App Service | X | Niet mogelijk per ontwerp |
| Analyses van toepassingen | ✔ | Kan worden gedeeld |
| Zoekservice | ✔ | 1. testkb is een gereserveerde naam voor de QnAMaker-service; deze kan niet door anderen worden gebruikt.2. Synoniemenkaart door de naam synonym-map is gereserveerd voor de QnAMaker-service.3. Het aantal gepubliceerde knowledge bases wordt beperkt door Search-service laag. Als er gratis indexen beschikbaar zijn, kunnen andere services deze gebruiken. |
Volgende stappen
- Meer informatie over de QnA Maker-knowledge base
- Inzicht in een levenscyclus van een Knowledge Base
- Service- en Knowledge Base-limieten controleren