Azure-resurser för QnA MakerAzure resources for QnA Maker

QnA Maker använder flera Azure-källor, var och en med ett annat syfte.QnA Maker uses several Azure sources, each with a different purpose. Om du förstår hur de används individuellt kan du planera för och välja rätt pris nivå eller veta när du ska ändra pris nivån.Understanding how they are used individually allows you to plan for and select the correct pricing tier or know when to change your pricing tier. Om du förstår hur de används i kombinationen kan du hitta och åtgärda problem när de inträffar.Understanding how they are used in combination allows you to find and fix problems when they occur.

Resurs planeringResource planning

När du först utvecklar en QnA Maker kunskaps bas i prototyp fasen är det vanligt att ha en enda QnA Maker resurs för både testning och produktion.When you first develop a QnA Maker knowledge base, in the prototype phase, it is common to have a single QnA Maker resource for both testing and production.

När du går vidare till utvecklings fasen i projektet bör du tänka på följande:When you move into the development phase of the project, you should consider:

  • Hur många språk ditt kunskaps bas system ska innehållahow many languages your knowledge base system will hold
  • Hur många regioner du behöver din kunskaps bas för att vara tillgänglig i/frånhow many regions you need your knowledge base to be available in/from
  • Hur många dokument i varje domän som systemet ska innehållahow many documents in each domain your system will hold

Planera att ha en enda QnA Maker resurs har alla kunskaps banker som har samma språk, samma region och samma ämnes domän kombination.Plan to have a single QnA Maker resource hold all knowledge bases that have the same language, the same region and the same subject domain combination.

Pris nivå övervägandenPricing tier considerations

Det finns vanligt vis tre parametrar som du behöver tänka på:Typically there are three parameters you need to consider:

  • Det data flöde du behöver från tjänsten:The throughput you need from the service:

    • Välj lämplig app-plan för din app service utifrån dina behov.Select the appropriate App Plan for your App service based on your needs. Du kan skala upp eller ned appen.You can scale up or down the App.
    • Detta bör även påverka din Azure kognitiv sökning SKU-val, se mer information här.This should also influence your Azure Cognitive Search SKU selection, see more details here. Dessutom kan du behöva justera Kognitiv sökning kapacitet med repliker.Additionally, you may need to adjust Cognitive Search capacity with replicas.
  • Storlek och antal kunskaps baser: Välj lämplig Azure Search-SKU för ditt scenario.Size and the number of knowledge bases: Choose the appropriate Azure search SKU for your scenario. Normalt bestämmer du hur många kunskaps baser du behöver baserat på antalet olika ämnes domäner.Typically, you decide number of knowledge bases you need based on number of different subject domains. När en ämnes domän (för ett enskilt språk) ska finnas i en kunskaps bas.Once subject domain (for a single language) should be in one knowledge base.

    Du kan publicera N-1 kunskaps baser på en viss nivå, där N är de maximala index som tillåts på nivån.You can publish N-1 knowledge bases in a particular tier, where N is the maximum indexes allowed in the tier. Kontrol lera också den maximala storleken och antalet dokument som tillåts per nivå.Also check the maximum size and the number of documents allowed per tier.

    Om din nivå till exempel har 15 tillåtna index, kan du publicera 14 kunskaps banker (1 index per publicerad kunskaps bas).For example, if your tier has 15 allowed indexes, you can publish 14 knowledge bases (1 index per published knowledge base). Det femtonde indexet används för alla kunskaps banker för redigering och testning.The fifteenth index is used for all the knowledge bases for authoring and testing.

  • Antal dokument som källor: den kostnads fria SKU: n för QNA Maker hanterings tjänsten begränsar antalet dokument som du kan hantera via portalen och API: erna till 3 (med en storlek på 1 MB).Number of documents as sources: The free SKU of the QnA Maker management service limits the number of documents you can manage via the portal and the APIs to 3 (of 1 MB size each). Standard-SKU: n har ingen gräns för antalet dokument som du kan hantera.The standard SKU has no limits to the number of documents you can manage. Se mer information här.See more details here.

I följande tabell får du några rikt linjer på hög nivå.The following table gives you some high-level guidelines.

QnA Maker hanteringQnA Maker Management App ServiceApp Service Azure Cognitive SearchAzure Cognitive Search BegränsningarLimitations
ExperimenteringExperimentation Kostnads fri SKUFree SKU Kostnads fri nivåFree Tier Kostnads fri nivåFree Tier Publicera upp till 2 KB, 50 MB storlekPublish Up to 2 KBs, 50 MB size
Utvecklings-och test miljöDev/Test Environment Standard-SKUStandard SKU DeladShared BasicBasic Publicera upp till 14 KB, 2 GB storlekPublish Up to 14 KBs, 2 GB size
Produktions miljöProduction Environment Standard-SKUStandard SKU BasicBasic StandardStandard Publicera upp till 49 KB, 25 GB storlekPublish Up to 49 KBs, 25 GB size
Mål frågor per sekundTarget QPS App ServiceApp Service Azure Cognitive SearchAzure Cognitive Search
33 S1, 1 instansS1, 1 Instance S1, 1 instansS1, 1 Instance
5050 S3, 10 instanserS3, 10 Instances S1, 12 instanserS1, 12 Instances
8080 S3, 10 instanserS3, 10 Instances S3, 12 instanserS3, 12 Instances
100100 P3V2, 10 instanserP3V2, 10 Instances S3, 12 instanser, 3 partitionerS3, 12 Instances, 3 Partitions
200 till 250200 to 250 P3V2, 20 instanserP3V2, 20 Instances S3, 12 instanser, 3 partitionerS3, 12 Instances, 3 Partitions

När du ska ändra en pris nivåWhen to change a pricing tier

UppgraderaUpgrade OrsakReason
Uppgradera SKU för QnA Maker hanteringUpgrade QnA Maker management SKU Du vill ha fler QnA-par eller dokument källor i din kunskaps bas.You want to have more QnA pairs or document sources in your knowledge base.
Uppgradera App Service SKU och kontrol lera Kognitiv sökning nivå och skapa kognitiv sökning replikerUpgrade App Service SKU and check Cognitive Search tier and create Cognitive Search replicas Kunskaps basen behöver för att betjäna fler förfrågningar från din klient app, till exempel en chatt-robot.Your knowledge base needs to serve more requests from your client app, such as a chat bot.
Uppgradera Azure Kognitiv sökning-tjänstUpgrade Azure Cognitive Search service Du planerar att ha många kunskaps baser.You plan to have many knowledge bases.

Hämta de senaste körnings uppdateringarna genom att uppdatera App Service i Azure Portal.Get the latest runtime updates by updating your App Service in the Azure portal.

Överväganden för resurs namn givningResource naming considerations

Resurs namnet för QnA Maker resursen, till exempel qna-westus-f0-b , används också för att ge de andra resurserna.The resource name for the QnA Maker resource, such as qna-westus-f0-b, is also used to name the other resources.

Med Azure Portal skapa-fönstret kan du skapa en QnA Maker resurs och välja pris nivåer för de andra resurserna.The Azure portal create window allows you to create a QnA Maker resource and select the pricing tiers for the other resources.

Skärm bild av Azure Portal för att skapa QnA Maker-resursScreenshot of Azure portal for QnA Maker resource creation

När resurserna har skapats har de samma namn, förutom den valfria Application Insights resursen, som postpends tecken till namnet.After the resources are created, they have the same name, except for the optional Application Insights resource, which postpends characters to the name.

Skärm bild av Azure Portal resurs listaScreenshot of Azure portal resource listing

Tips

Skapa en ny resurs grupp när du skapar en QnA Maker-resurs.Create a new resource group when you create a QnA Maker resource. Det gör att du kan se alla resurser som är associerade med QnA Maker resursen när du söker efter resurs grupp.That allows you to see all resources associated with the QnA Maker resource when searching by resource group.

Tips

Använd en namngivnings konvention för att ange pris nivåer i namnet på resursen eller resurs gruppen.Use a naming convention to indicate pricing tiers within the name of the resource or the resource group. När du får fel meddelanden när du skapar en ny kunskaps bas eller lägger till nya dokument, är gränsen för Kognitiv sökning pris nivån ett vanligt problem.When you receive errors from creating a new knowledge base, or adding new documents, the Cognitive Search pricing tier limit is a common issue.

Resurs syfteResource purposes

Varje Azure-resurs som skapats med QnA Maker har ett specifikt syfte:Each Azure resource created with QnA Maker has a specific purpose:

  • QnA Maker resursQnA Maker resource
  • Kognitiv sökning resursCognitive Search resource
  • App ServiceApp Service
  • App Plans tjänstApp Plan Service
  • Application Insights tjänstApplication Insights Service

Kognitiv sökning resursCognitive Search resource

Kognitiv sökning resurs används för att:The Cognitive Search resource is used to:

  • Lagra QnA-parStore the QnA pairs
  • Ange den inledande rangordningen (Ranger #1) för QnA-par vid körningProvide the initial ranking (ranker #1) of the QnA pairs at runtime

Index användningIndex usage

Resursen behåller ett index som fungerar som test index och de återstående indexen korreleras med en publicerad kunskaps bas.The resource keeps one index to act as the test index and the remaining indexes correlate to one published knowledge base each.

En resurs som är priss ätts 15 index, innehåller 14 publicerade kunskaps banker och ett index används för att testa alla kunskaps baser.A resource priced to hold 15 indexes, will hold 14 published knowledge bases, and one index is used for testing all the knowledge bases. Det här test indexet är partitionerat av kunskaps basen så att en fråga som använder det interaktiva test fönstret använder test index men bara returnerar resultat från den partition som är associerad med den aktuella kunskaps basen.This test index is partitioned by knowledge base so that a query using the interactive test pane will use the test index but only return results from the specific partition associated with the specific knowledge base.

Språk användningLanguage usage

Den första kunskaps basen som skapas i QnA Maker-resursen används för att fastställa det enskilda språk som har angetts för kognitiv sökning resursen och alla dess index.The first knowledge base created in the QnA Maker resource is used to determine the single language set for the Cognitive Search resource and all its indexes. Du kan bara ha en språk uppsättning för en QNA Maker-tjänst.You can only have one language set for a QnA Maker service.

QnA Maker resursQnA Maker resource

QnA Maker-resursen ger till gång till API: erna för redigering och publicering samt det NLP-baserade (Natural Language Processing)-baserade andra rangordnings skiktet (Ranging #2) för QnA-par vid körning.The QnA Maker resource provides access to the authoring and publishing APIs as well as the natural language processing (NLP) based second ranking layer (ranker #2) of the QnA pairs at runtime.

Den andra rangordningen använder intelligenta filter som kan innehålla metadata och Uppföljnings-prompter.The second ranking applies intelligent filters that can include metadata and follow-up prompts.

QnA Maker inställningar för resurs konfigurationQnA Maker resource configuration settings

När du skapar en ny kunskaps bas i QNA Maker Portalär språk inställningen den enda inställning som tillämpas på resurs nivå.When you create a new knowledge base in the QnA Maker portal, the Language setting is the only setting that is applied at the resource level. Du väljer språk när du skapar den första kunskaps basen för resursen.You select the language when you create the first knowledge base for the resource.

App service-och App Service-planApp service and App service plan

App Service används av klient programmet för att få åtkomst till publicerade kunskaps banker via runtime-slutpunkten.The App service is used by your client application to access the published knowledge bases via the runtime endpoint.

För att fråga den publicerade kunskaps basen använder alla publicerade kunskaps baser samma URL-slutpunkt, men anger kunskaps bas-ID: t i vägen.To query the published knowledge base, all published knowledge bases use the same URL endpoint, but specify the knowledge base ID within the route.

{RuntimeEndpoint}/qnamaker/knowledgebases/{kbId}/generateAnswer

Application InsightsApplication Insights

Application Insights används för att samla in chatt och telemetri.Application Insights is used to collect chat logs and telemetry. Granska vanliga Kusto-frågor för information om tjänsten.Review the common Kusto queries for information about your service.

Dela tjänster med QnA MakerShare services with QnA Maker

QnA Maker skapar flera Azure-resurser.QnA Maker creates several Azure resources. Använd följande tabell för att ta reda på vad du kan och inte kan dela för att minska hanteringen och dra nytta av kostnads delning:To reduce management and benefit from cost sharing, use the following table to understand what you can and can't share:

TjänstService DelaShare OrsakReason
Cognitive ServicesCognitive Services XX Inte möjlig enligt designNot possible by design
App Service-planApp Service plan Fast disk utrymme som allokerats för en App Service plan.Fixed disk space allocated for an App Service plan. Om andra appar som delar samma App Service plan använder betydande disk utrymme, kommer QnAMaker App Service-instansen att drabbas av problem.If other apps that sharing the same App Service plan use significant disk space, the QnAMaker App Service instance will encounter problems.
App ServiceApp Service XX Inte möjlig enligt designNot possible by design
Application InsightsApplication Insights Kan delasCan be shared
SöktjänstSearch service 1. testkb är ett reserverat namn för QnAMaker-tjänsten. det kan inte användas av andra.1. testkb is a reserved name for the QnAMaker service; it can't be used by others.
2. synonym mappningen med namnet synonym-map är reserverad för QnAMaker-tjänsten.2. Synonym map by the name synonym-map is reserved for the QnAMaker service.
3. antalet publicerade kunskaps baser är begränsat av Sök tjänst nivån.3. The number of published knowledge bases is limited by Search service tier. Om det finns lediga index är andra tjänster som kan använda dem.If there are free indexes available, other services can use them.

Använda en enda Kognitiv sökning-tjänstUsing a single Cognitive Search service

Om du skapar en QnA-tjänst och dess beroenden (till exempel Sök) via portalen skapas en Sök tjänst för dig och länkas till QnA Maker tjänsten.If you create a QnA service and its dependencies (such as Search) through the portal, a Search service is created for you and linked to the QnA Maker service. När resurserna har skapats kan du uppdatera App Service-inställningen för att använda en tidigare befintlig Sök tjänst och ta bort den som du nyss skapade.After these resources are created, you can update the App Service setting to use a previously existing Search service and remove the one you just created.

Lär dig hur du konfigurerar QNA Maker att använda en annan kognitiv tjänst resurs än den som skapats som en del av processen för att skapa en QNA Maker resurs.Learn how to configure QnA Maker to use a different Cognitive Service resource than the one created as part of the QnA Maker resource creation process.

Region för hanterings tjänstManagement service region

Hanterings tjänsten för QnA Maker används endast för QnA Maker-portalen och för inledande data bearbetning.The management service of QnA Maker is used only for the QnA Maker portal and for initial data processing. Den här tjänsten är endast tillgänglig i regionen USA, västra .This service is available only in the West US region. Ingen kund information lagras i den här västra USA-tjänsten.No customer data is stored in this West US service.

Nycklar i QnA MakerKeys in QnA Maker

Din QnA Maker-tjänst har två typer av nycklar: redigerings nycklar och fråge slut punkts nycklar som används med körnings miljön som finns i App Service.Your QnA Maker service deals with two kinds of keys: authoring keys and query endpoint keys used with the runtime hosted in the App service.

Om du letar efter din prenumerations nyckel har du ändrat terminologin.If you are looking for your subscription key, the terminology has changed.

Använd de här nycklarna när du gör förfrågningar till tjänsten via API: er.Use these keys when making requests to the service through APIs.

Nyckelhantering

NamnName PlatsLocation SyftePurpose
Redigerings nyckelAuthoring key Azure-portalenAzure portal Dessa nycklar används för att få åtkomst till API: erna för QNA Maker Management-tjänsten.These keys are used to access the QnA Maker management service APIs. Med dessa API: er kan du redigera frågorna och svaren i din kunskaps bas och publicera din kunskaps bas.These APIs let you edit the questions and answers in your knowledge base, and publish your knowledge base. Nycklarna skapas när du skapar en ny QnA Maker-tjänst.These keys are created when you create a new QnA Maker service.

Sök efter dessa nycklar på Cognitive Services resurs på sidan nycklar .Find these keys on the Cognitive Services resource on the Keys page.
Frågans slut punkts nyckelQuery endpoint key QnA Maker-portalenQnA Maker portal Dessa nycklar används för att skicka frågor till den publicerade kunskaps bas slut punkten för att få svar på en användar fråga.These keys are used to query the published knowledge base endpoint to get a response for a user question. Du använder vanligt vis den här fråge slut punkten i din Chat-robot eller i klient program koden som ansluter till QnA Maker-tjänsten.You typically use this query endpoint in your chat bot or in the client application code that connects to the QnA Maker service. De här nycklarna skapas när du publicerar din QnA Maker-kunskaps bas.These keys are created when you publish your QnA Maker knowledge base.

Sök efter dessa nycklar på sidan tjänst inställningar .Find these keys in the Service settings page. Hitta den här sidan från användarens meny längst upp till höger på sidan på den nedrullningsbara menyn.Find this page from the user's menu in the upper right of the page on the drop-down menu.

PrenumerationsnycklarSubscription keys

Term redigerings-och fråge slut punkts nyckeln är rätt villkor.The terms authoring and query endpoint key are corrective terms. Föregående term var prenumerations nyckel.The previous term was subscription key. Om du ser en annan dokumentation som hänvisar till prenumerations nycklar motsvarar dessa referenser till redigerings-och fråge slut punkts nycklar (används i körnings miljön).If you see other documentation referring to subscription keys, these are equivalent to authoring and query endpoint keys (used in the runtime).

Du måste veta vad nyckeln har åtkomst till, kunskaps bas hantering eller kunskaps bas frågor för att veta vilken nyckel du behöver hitta.You must know what the key is accessing, knowledge base management or knowledge base querying, to know which key you need to find.

  • Skydda kognitiva tjänst resurser från offentlig åtkomst genom att konfigurera det virtuella nätverket.Protect Cognitive Service Resource from public access by configuring the virtual network.
  • Skydda App Service (QnA Runtime) från offentlig åtkomst:Protect App Service (QnA Runtime) from public access:
    • Tillåt enbart trafik från kognitiva tjänst-IP: er.Allow traffic only from Cognitive Service IPs. Dessa ingår redan i service tag gen "CognitiveServicesManagement".These are already included in Service Tag "CognitiveServicesManagement". Detta krävs för att skapa API: er (Skapa/uppdatera KB) för att anropa app service och uppdatera Azure Search-tjänsten enligt detta.This is required for Authoring APIs (Create/Update KB) to invoke the app service and update Azure Search service accordingly.
    • Se till att du även tillåter andra start punkter som bot service, QnA Maker portal (kan vara ditt företags nätverket) osv. för förutsägelse "GenerateAnswer" API-åtkomst.Make sure you also allow other entry points like Bot service, QnA Maker portal (may be your corpnet) etc. for prediction "GenerateAnswer" API access.
    • Läs Mer information om service märken.Check out more information about service tags.

Nästa stegNext steps