Azure-resurser för QnA Maker
QnA Maker använder flera Azure-källor, var och en med ett annat syfte. Om du förstår hur de används individuellt kan du planera för och välja rätt prisnivå eller veta när du ska ändra prisnivån. Genom att förstå hur de används i kombination kan du hitta och åtgärda problem när de inträffar.
Kommentar
QnA Maker-tjänsten dras tillbaka den 31 mars 2025. En nyare version av fråge- och svarsfunktionen är nu tillgänglig som en del av Azure AI Language. Information om funktioner för frågesvar i språktjänsten finns i svar på frågor. Från och med den 1 oktober 2022 kommer du inte att kunna skapa nya QnA Maker-resurser. Information om hur du migrerar befintliga QnA Maker-kunskapsbas till frågesvar finns i migreringsguiden.
Resursplanering
När du först utvecklar en QnA Maker-kunskapsbas i prototypfasen är det vanligt att ha en enda QnA Maker-resurs för både testning och produktion.
När du går in i projektets utvecklingsfas bör du tänka på följande:
- Hur många språk kommer ditt kunskapsbas system att innehålla?
- Hur många regioner behöver du kunskapsbas vara tillgängliga i?
- Hur många dokument i varje domän kommer systemet att innehålla?
Planera att ha en enda QnA Maker-resurs som innehåller alla kunskapsbas som har samma språk, samma region och samma ämnesdomänkombination.
Överväganden för prisnivå
Det finns vanligtvis tre parametrar som du behöver tänka på:
Det dataflöde du behöver från tjänsten:
- Välj lämplig appplan för din App Service baserat på dina behov. Du kan skala upp eller ned appen.
- Detta bör också påverka ditt SKU-val för Azure Cognitive Search . Mer information finns här. Dessutom kan du behöva justera kapaciteten för kognitiv sökning med repliker.
Storlek och antalet kunskapsbas: Välj lämplig Azure Search SKU för ditt scenario. Vanligtvis bestämmer du antalet kunskapsbas du behöver baserat på antalet olika ämnesdomäner. När ämnesdomänen (för ett enda språk) ska finnas i en kunskapsbas.
Din Azure-tjänsten Search resurs måste ha skapats efter januari 2019 och kan inte finnas på den kostnadsfria nivån (delad). Det finns inget stöd för att konfigurera kundhanterade nycklar i Azure-portalen.
Viktigt!
Du kan publicera N-1-kunskapsbas på en viss nivå, där N är de högsta index som tillåts på nivån. Kontrollera även den maximala storleken och antalet dokument som tillåts per nivå.
Om din nivå till exempel har 15 tillåtna index kan du publicera 14 kunskapsbas (ett index per publicerad kunskapsbas). Det femtonde indexet används för alla kunskapsbas för redigering och testning.
- Antal dokument som källor: Den kostnadsfria SKU:n för QnA Maker-hanteringstjänsten begränsar antalet dokument som du kan hantera via portalen och API:erna till 3 (med en MB storlek vardera). Standard-SKU:n har inga begränsningar för hur många dokument du kan hantera. Mer information finns här.
I följande tabell finns några riktlinjer på hög nivå.
| Hantering av QnA Maker | App Service | Azure AI Search | Begränsningar | |
|---|---|---|---|---|
| Experimenterande | Kostnadsfri SKU | Kostnadsfri nivå | Kostnadsfri nivå | Publicera upp till 2 KBs, 50 MB storlek |
| Utvecklings-/testmiljö | Standard-SKU | Delad | Grundläggande | Publicera upp till 14 KB, 2 GB storlek |
| Produktionsmiljö | Standard-SKU | Basic | Standard | Publicera upp till 49 KBs, 25 GB storlek |
Rekommenderad Inställningar
| QPS-mål | App Service | Azure AI Search |
|---|---|---|
| 3 | S1, en replik | S1, en replik |
| 50 | S3, 10 repliker | S1, 12 repliker |
| 80 | S3, 10 repliker | S3, 12 repliker |
| 100 | P3V2, 10 repliker | S3, 12 repliker, 3 partitioner |
| 200 till 250 | P3V2, 20 repliker | S3, 12 repliker, 3 partitioner |
När du ska ändra prisnivå
| Uppgradering | Anledning |
|---|---|
| Uppgradera QnA Maker-hanterings-SKU | Du vill ha fler QnA-par eller dokumentkällor i kunskapsbas. |
| Uppgradera App Service SKU och kontrollera Azure AI Search-nivån och skapa Cognitive Search-repliker | Din kunskapsbas behöver hantera fler begäranden från din klientapp, till exempel en chattrobot. |
| Uppgradera Azure AI-tjänsten Search | Du planerar att ha många kunskapsbas. |
Hämta de senaste körningsuppdateringarna genom att uppdatera Din App Service i Azure-portalen.
Nycklar i QnA Maker
QnA Maker-tjänsten hanterar två typer av nycklar: redigering av nycklar och frågeslutpunktsnycklar som används med körningen som finns i App Service.
Använd dessa nycklar när du gör begäranden till tjänsten via API:er.
| Namn | Location | Syfte |
|---|---|---|
| Redigerings-/prenumerationsnyckel | Azure-portalen | Dessa nycklar används för att komma åt API:erna för QnA Maker-hanteringstjänsten. Med dessa API:er kan du redigera frågorna och svaren i kunskapsbas och publicera dina kunskapsbas. Dessa nycklar skapas när du skapar en ny QnA Maker-tjänst. Hitta dessa nycklar på Azure AI-tjänstresursenpå sidan Nycklar och slutpunkt . |
| Frågeslutpunktsnyckel | QnA Maker-portalen | Dessa nycklar används för att fråga den publicerade kunskapsbas slutpunkten för att få ett svar på en användarfråga. Du använder vanligtvis den här frågeslutpunkten i chattroboten eller i klientprogramkoden som ansluter till QnA Maker-tjänsten. Dessa nycklar skapas när du publicerar din QnA Maker-kunskapsbas. Hitta dessa nycklar på sidan Tjänstinställningar . Hitta den här sidan från användarens meny längst upp till höger på sidan i den nedrullningsbara menyn. |
Hitta redigeringsnycklar i Azure-portalen
Du kan visa och återställa redigeringsnycklarna från Azure-portalen, där du skapade QnA Maker-resursen.
Gå till QnA Maker-resursen i Azure-portalen och välj den resurs som har azure AI-tjänsttypen :
Gå till Nycklar och slutpunkt:
Hitta frågeslutpunktsnycklar i QnA Maker-portalen
Slutpunkten finns i samma region som resursen eftersom slutpunktsnycklarna används för att göra ett anrop till kunskapsbas.
Slutpunktsnycklar kan hanteras från QnA Maker-portalen.
Logga in på QnA Maker-portalen, gå till din profil och välj sedan Tjänstinställningar:
Visa eller återställ dina nycklar:
Kommentar
Uppdatera dina nycklar om du tror att de har komprometterats. Detta kan kräva motsvarande ändringar i klientprogrammet eller robotkoden.
Hanteringstjänstregion
Hanteringstjänsten för QnA Maker används endast för QnA Maker-portalen och för inledande databehandling. Den här tjänsten är endast tillgänglig i regionen USA , västra. Inga kunddata lagras i den här tjänsten i USA, västra.
Överväganden för resursnamngivning
Resursnamnet för QnA Maker-resursen, till exempel qna-westus-f0-b, används också för att namnge de andra resurserna.
Med fönstret Skapa i Azure-portalen kan du skapa en QnA Maker-resurs och välja prisnivåer för de andra resurserna.
När resurserna har skapats har de samma namn, förutom den valfria Application Insights-resursen, som lägger till tecken efter namnet.
Dricks
Skapa en ny resursgrupp när du skapar en QnA Maker-resurs. Det gör att du kan se alla resurser som är associerade med QnA Maker-resursen när du söker efter resursgrupp.
Dricks
Använd en namngivningskonvention för att ange prisnivåer inom resursens eller resursgruppens namn. När du får fel när du skapar en ny kunskapsbas eller lägger till nya dokument är prisnivån Cognitive Search ett vanligt problem.
Resursändamål
Varje Azure-resurs som skapas med QnA Maker har ett specifikt syfte:
- QnA Maker-resurs
- Cognitive Search-resurs
- App Service
- App Plan Service
- Application Insights-tjänsten
QnA Maker-resurs
QnA Maker-resursen ger åtkomst till API:erna för redigering och publicering.
Konfigurationsinställningar för QnA Maker-resurser
När du skapar en ny kunskapsbas i QnA Maker-portalen är inställningen Språk den enda inställningen som tillämpas på resursnivå. Du väljer språket när du skapar den första kunskapsbas för resursen.
Cognitive Search-resurs
Cognitive Search-resursen används för att:
- Lagra QnA-paren
- Ange den inledande rangordningen (rankning nr 1) för QnA-paren vid körning
Indexanvändning
Resursen behåller ett index som fungerar som testindex och de återstående indexen korrelerar med en publicerad kunskapsbas vardera.
En resurs som är prissatt för att innehålla 15 index innehåller 14 publicerade kunskapsbas och ett index används för att testa alla kunskapsbas. Det här testindexet partitioneras av kunskapsbas så att en fråga som använder det interaktiva testfönstret använder testindexet men endast returnerar resultat från den specifika partition som är associerad med den specifika kunskapsbas.
Språkanvändning
Den första kunskapsbas som skapats i QnA Maker-resursen används för att fastställa den enda språkuppsättningen för Cognitive Search-resursen och alla dess index. Du kan bara ha ett språk inställt för en QnA Maker-tjänst.
Använda en enda Cognitive tjänsten Search
Om du skapar en QnA-tjänst och dess beroenden (till exempel Sök) via portalen skapas en tjänsten Search åt dig och länkas till QnA Maker-tjänsten. När dessa resurser har skapats kan du uppdatera App Service-inställningen för att använda en tidigare befintlig tjänsten Search och ta bort den som du nyss skapade.
Lär dig hur du konfigurerar QnA Maker för att använda en annan Azure AI-tjänstresurs än den som skapades som en del av processen för att skapa QnA Maker-resurser.
App Service- och App Service-plan
App service används av klientprogrammet för att komma åt publicerade kunskapsbas via körningsslutpunkten. App Service innehåller det nlp-baserade andra rangordningsskiktet (ranker nr 2) för QnA-paren vid körning. Den andra rangordningen tillämpar intelligenta filter som kan innehålla metadata och uppföljningsprompter.
Om du vill fråga den publicerade kunskapsbas använder alla publicerade kunskapsbas samma URL-slutpunkt, men anger kunskapsbas-ID:t inom vägen.
{RuntimeEndpoint}/qnamaker/knowledgebases/{kbId}/generateAnswer
Programinsikter
Application Insights används för att samla in chattloggar och telemetri. Granska de vanliga Kusto-frågorna för information om din tjänst.
Dela tjänster med QnA Maker
QnA Maker skapar flera Azure-resurser. Om du vill minska hanteringen och dra nytta av kostnadsdelning använder du följande tabell för att förstå vad du kan och inte kan dela:
| Tjänst | Andel | Anledning |
|---|---|---|
| AI-tjänster i Azure | X | Inte möjligt avsiktligt |
| App Service-plan | ✔ | Fast diskutrymme som allokerats för en App Service-plan. Om andra appar som delar samma App Service-plan använder betydande diskutrymme kommer QnAMaker App Service-instansen att stöta på problem. |
| App Service | X | Inte möjligt avsiktligt |
| Programinsikter | ✔ | Kan delas |
| Söktjänst | ✔ | 1. testkb är ett reserverat namn för QnAMaker-tjänsten. Det kan inte användas av andra.2. Synonymkartan med namnet synonym-map är reserverad för QnAMaker-tjänsten.3. Antalet publicerade kunskapsbas begränsas av tjänsten Search nivå. Om det finns tillgängliga kostnadsfria index kan andra tjänster använda dem. |
Nästa steg
- Lär dig mer om QnA Maker-kunskapsbas
- Förstå en kunskapsbas livscykel
- Granska tjänst- och kunskapsbas gränser