Azure-erőforrások a QnA Makerhez

A QnA Maker több Azure-forrást használ, mindegyiknek más a célja. A használatuk módjának megértése lehetővé teszi a megfelelő tarifacsomag megtervezését és kiválasztását, illetve a tarifacsomag módosításának módját. A használatuk módjának megértése lehetővé teszi a problémák megkeresését és megoldását, ha előfordulnak.

Megjegyzés:

A QnA Maker szolgáltatás 2025. március 31-én megszűnik. A kérdés- és válaszképesség újabb verziója már elérhető az Azure AI Language részeként. A Nyelvi szolgáltatáson belüli kérdések megválaszolási képességeiről a kérdések megválaszolása című témakörben olvashat. 2022. október 1-től nem hozhat létre új QnA Maker-erőforrásokat. A meglévő QnA Maker-tudásbázis kérdés megválaszolásához tekintse meg a migrálási útmutatót.

Erőforrás-tervezés

Amikor először fejleszt egy QnA Maker-tudásbázis, a prototípus fázisában gyakori, hogy egyetlen QnA Maker-erőforrással rendelkezik mind a teszteléshez, mind az éles környezethez.

Amikor a projekt fejlesztési fázisába lép, a következő szempontokat kell figyelembe vennie:

  • Hány nyelvet fog tárolni a tudásbázis rendszer?
  • Hány régióban kell elérhetőnek lennie a tudásbázis?
  • Hány dokumentumot fog tárolni a rendszer az egyes tartományokban?

Tervezze meg, hogy egyetlen QnA Maker-erőforrással rendelkezik az összes olyan tudásbázis, amely ugyanazt a nyelvet, régiót és azonos tárgytartomány-kombinációt használja.

Tarifacsomaggal kapcsolatos megfontolandó szempontok

Általában három paramétert kell figyelembe vennie:

  • A szolgáltatásból szükséges átviteli sebesség:

    • Az igényeinek megfelelően válassza ki az App Service-hez megfelelő alkalmazáscsomagot . Fel- vagy leskálázhatja az alkalmazást.
    • Ennek az Azure Cognitive Search termékváltozat kiválasztására is hatással kell lennie, további részleteket itt talál. Emellett előfordulhat, hogy módosítania kell a Cognitive Search kapacitását replikákkal.
  • A tudásbázis mérete és száma: Válassza ki a forgatókönyvéhez megfelelő Azure Search-termékváltozatot. Általában a különböző tárgytartományok száma alapján dönti el, hogy hány tudásbázis van szüksége. Ha a tárgytartománynak (egyetlen nyelven) egy tudásbázis kell lennie.

Az Azure Search szolgáltatás-erőforrásnak 2019 januárja után kell létrejönnie, és nem lehet ingyenes (megosztott) szinten. Az Azure Portalon nem lehet ügyfél által felügyelt kulcsokat konfigurálni.

Fontos

Az N-1 tudásbázis közzéteheti egy adott rétegben, ahol az N a rétegben engedélyezett maximális indexek száma. Ellenőrizze továbbá a maximális méretet és a rétegenként engedélyezett dokumentumok számát.

Ha például a szint 15 engedélyezett indexet biztosít, 14 tudásbázis tehet közzé (közzétett tudásbázis egy indexet). A tizenötödik index a szerzői és tesztelési tudásbázis használatos.

  • Dokumentumok száma forrásként: A QnA Maker felügyeleti szolgáltatás ingyenes termékváltozata a portálon és az API-kon keresztül kezelhető dokumentumok számát 3-ra (egyenként 1 MB méretűre) korlátozza. A standard termékváltozat nem korlátozza a kezelhető dokumentumok számát. További részleteket itt talál.

Az alábbi táblázat néhány magas szintű útmutatást tartalmaz.

QnA Maker Management App Service Azure AI Search Limitations
Experimentation Ingyenes termékváltozat Ingyenes szint Ingyenes szint Legfeljebb 2 KB közzététel, 50 MB-os méret
Fejlesztői/tesztelési környezet Standard termékváltozat Shared Alap Akár 14 GB-os közzététel, 2 GB-os méret
Éles környezet Standard termékváltozat Alapszintű Standard Akár 49 GB-os közzététel, 25 GB-os méret
Cél QPS App Service Azure AI Search
3 S1, egy replika S1, egy replika
50 S3, 10 replika S1, 12 replika
80 S3, 10 replika S3, 12 replika
100 P3V2, 10 replika S3, 12 replika, 3 partíció
200–250 P3V2, 20 replika S3, 12 replika, 3 partíció

Mikor kell módosítani a tarifacsomagot?

Magasabb szintre váltás Ok
A QnA Maker felügyeleti termékváltozatának frissítése Több QnA-párra vagy dokumentumforrásra van szüksége a tudásbázis.
Az App Service termékváltozatának frissítése és az Azure AI Search-szint ellenőrzése és Cognitive Search-replikák létrehozása A tudásbázis több kérést kell kiszolgálnia az ügyfélalkalmazástól, például egy csevegőrobottól.
Az Azure AI-Search szolgáltatás frissítése Sok tudásbázis tervez.

Az App Service Azure Portalon való frissítésével szerezze be a legújabb futtatókörnyezeti frissítéseket.

Kulcsok a QnA Makerben

A QnA Maker szolgáltatás kétféle kulcstípussal foglalkozik: az App service-ben üzemeltetett futtatókörnyezetben használt kulcsokés lekérdezési végpontkulcsok készítésével.

Ezeket a kulcsokat akkor használja, ha API-kon keresztül küld kéréseket a szolgáltatásnak.

Key management

Name Hely Cél
Szerzői/előfizetési kulcs Azure Portal Ezek a kulcsok a QnA Maker felügyeleti szolgáltatás API-iinak eléréséhez használhatók. Ezek az API-k lehetővé teszik a kérdések és válaszok szerkesztését a tudásbázis, és közzéteheti a tudásbázis. Ezek a kulcsok egy új QnA Maker-szolgáltatás létrehozásakor jönnek létre.

Ezeket a kulcsokat az Azure AI-szolgáltatások erőforrásában találja a Kulcsok és végpont lapon.
Végpontkulcs lekérdezése QnA Maker portál Ezek a kulcsok a közzétett tudásbázis végpont lekérdezésére szolgálnak, hogy választ kapjanak egy felhasználói kérdésre. Ezt a lekérdezési végpontot általában a csevegőrobotban vagy a QnA Maker szolgáltatáshoz csatlakozó ügyfélalkalmazás-kódban használja. Ezek a kulcsok a QnA Maker tudásbázis közzétételekor jönnek létre.

Ezeket a kulcsokat a Szolgáltatásbeállítások lapon találja. Keresse meg ezt a lapot a lap jobb felső sarkában található felhasználói menüből a legördülő menüben.

Szerzői kulcsok keresése az Azure Portalon

A szerzői kulcsokat az Azure Portalon tekintheti meg és állíthatja vissza, ahol létrehozta a QnA Maker-erőforrást.

  1. Nyissa meg a QnA Maker-erőforrást az Azure Portalon, és válassza ki azt az erőforrást, amely az Azure AI-szolgáltatások típusát használja:

    QnA Maker resource list

  2. Nyissa meg a Kulcsok és végpont lehetőséget:

    QnA Maker managed (Preview) Subscription key

Lekérdezési végpontkulcsok keresése a QnA Maker portálon

A végpont ugyanabban a régióban található, mint az erőforrás, mert a végpontkulcsokkal hívást kezdeményezhet a tudásbázis.

A végpontkulcsok a QnA Maker portáljáról kezelhetők.

  1. Jelentkezzen be a QnA Maker portálra, nyissa meg a profilját, majd válassza a Szolgáltatásbeállítások lehetőséget:

    Endpoint key

  2. A kulcsok megtekintése vagy alaphelyzetbe állítása:

    Endpoint key manager

    Megjegyzés:

    Frissítse a kulcsokat, ha úgy gondolja, hogy feltörték őket. Ehhez szükség lehet az ügyfélalkalmazás vagy a robotkód megfelelő módosítására.

Felügyeleti szolgáltatás régiója

A QnA Maker felügyeleti szolgáltatása csak a QnA Maker portálhoz és a kezdeti adatfeldolgozáshoz használható. Ez a szolgáltatás csak az USA nyugati régiójában érhető el. A rendszer nem tárol ügyféladatokat ebben az USA nyugati régiójában.

Erőforrás-elnevezési szempontok

A QnA Maker-erőforrás erőforrásneve, például qna-westus-f0-ba többi erőforrás elnevezésére is szolgál.

Az Azure Portal létrehozási ablakával létrehozhat egy QnA Maker-erőforrást, és kiválaszthatja a többi erőforrás tarifacsomagjait.

Screenshot of Azure portal for QnA Maker resource creation

Az erőforrások létrehozása után ugyanazzal a névvel rendelkeznek, kivéve az opcionális alkalmazás Elemzések erőforrást, amely a karaktereket a névre fűzi.

Screenshot of Azure portal resource listing

Tipp.

QnA Maker-erőforrás létrehozásakor hozzon létre egy új erőforráscsoportot. Ez lehetővé teszi a QnA Maker-erőforráshoz társított összes erőforrás megtekintését erőforráscsoport szerinti kereséskor.

Tipp.

Elnevezési konvencióval jelezheti az erőforrás vagy az erőforráscsoport nevére vonatkozó tarifacsomagokat. Amikor hibaüzenetet kap egy új tudásbázis létrehozása vagy új dokumentumok hozzáadásakor, a Cognitive Search tarifacsomagjának korlátja gyakori probléma.

Erőforrás-célok

A QnA Makerrel létrehozott összes Azure-erőforrásnak meghatározott célja van:

  • QnA Maker-erőforrás
  • Cognitive Search-erőforrás
  • App Service
  • App Plan Service
  • Application Elemzések Service

QnA Maker-erőforrás

A QnA Maker-erőforrás hozzáférést biztosít a szerzői és közzétételi API-khoz.

A QnA Maker erőforráskonfigurációs beállításai

Amikor új tudásbázis hoz létre a QnA Maker portálon, a nyelvi beállítás az egyetlen, az erőforrás szintjén alkalmazott beállítás. Az erőforrás első tudásbázis létrehozásakor válassza ki a nyelvet.

Cognitive Search-erőforrás

A Cognitive Search-erőforrás a következőre használható:

  • A QnA-párok tárolása
  • Adja meg a QnA-párok kezdeti rangsorolását (1. rangsoroló) futásidőben

Indexhasználat

Az erőforrás egy indexet tart a tesztindexként való működéshez, a fennmaradó indexek pedig egy közzétett tudásbázis kapcsolódnak egymáshoz.

Egy 15 indexet tartalmazó erőforrás 14 közzétett tudásbázis fog tárolni, és egy indexet használ az összes tudásbázis teszteléséhez. Ezt a tesztindexet tudásbázis particionálta, így az interaktív tesztpanelt használó lekérdezések a tesztindexet használják, de csak az adott tudásbázis társított adott partícióból adnak vissza eredményeket.

Nyelvhasználat

A QnA Maker-erőforrásban létrehozott első tudásbázis a Cognitive Search-erőforrás és az összes index egyetlen nyelvének meghatározására szolgál. A QnA Maker szolgáltatáshoz csak egy nyelvkészletet használhat.

Egyetlen Cognitive Search szolgáltatás használata

Ha a portálon keresztül hoz létre egy QnA-szolgáltatást és annak függőségeit (például keresés), a szolgáltatás létrehoz egy Search szolgáltatás, amely a QnA Maker szolgáltatáshoz kapcsolódik. Az erőforrások létrehozása után frissítheti az App Service-beállítást egy korábban már meglévő Search szolgáltatás használatára, és eltávolíthatja az imént létrehozottat.

Megtudhatja , hogyan konfigurálhatja a QnA Makert úgy, hogy a QnA Maker-erőforrás-létrehozási folyamat részeként létrehozotttól eltérő Azure AI-szolgáltatáserőforrást használjon.

App Service- és App Service-csomag

Az App service-t az ügyfélalkalmazás használja a közzétett tudásbázis futásidejű végponton keresztüli eléréséhez. Az App Service tartalmazza a QnA-párok természetes nyelvfeldolgozási (NLP) második rangsorolási rétegét (2. rangsoroló) futásidőben. A második rangsor olyan intelligens szűrőket alkalmaz, amelyek metaadatokat és nyomon követési utasításokat tartalmazhatnak.

A közzétett tudásbázis lekérdezéséhez az összes közzétett tudásbázis ugyanazt az URL-végpontot használja, de adja meg az útvonalon belüli tudásbázis azonosítót.

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

Application Insights

Az alkalmazás Elemzések a csevegési naplók és a telemetriai adatok gyűjtésére szolgál. A szolgáltatással kapcsolatos információkért tekintse át a gyakori Kusto-lekérdezéseket .

Szolgáltatások megosztása a QnA Makerrel

A QnA Maker számos Azure-erőforrást hoz létre. A felügyelet csökkentéséhez és a költségmegosztás előnyeinek kihasználásához használja az alábbi táblázatot, amelyből megtudhatja, hogy mit oszthat meg, és mit nem:

Szerviz Share Ok
Az Azure AI-szolgáltatásai X Tervezéssel nem lehetséges
App Service-csomag Az App Service-csomaghoz lefoglalt lemezterület rögzített. Ha az azonos App Service-csomagot használó más alkalmazások jelentős lemezterületet használnak, a QnAMaker App Service-példány problémákba ütközik.
App Service X Tervezéssel nem lehetséges
Application Insights Megosztható
Keresési szolgáltatás 1. testkb a QnAMaker szolgáltatás fenntartott neve; mások nem használhatják.
2. A név synonym-map szerinti szinonimatérkép a QnAMaker szolgáltatás számára van fenntartva.
3. A közzétett tudásbázis számát Search szolgáltatás réteg korlátozza. Ha ingyenes indexek érhetők el, más szolgáltatások is használhatják őket.

További lépések