A QnA Maker hibaelhárítása

A QnA Maker szolgáltatással kapcsolatos leggyakoribb kérdések válogatott listája segít a szolgáltatás gyorsabb és jobb eredményekkel való bevezetésében.

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.

Előrejelzések kezelése

Hogyan javíthatjam a lekérdezési előrejelzések átviteli sebességét?

Válasz: Az átviteli sebesség teljesítményével kapcsolatos problémák azt jelzik, hogy fel kell skáláznia az App Service-t és a Cognitive Searchet is. A teljesítmény javítása érdekében érdemes lehet replikát hozzáadni a Cognitive Searchhez.

További információ a tarifacsomagokról.

A QnAMaker szolgáltatásvégpontjának lekérése

Válasz: A QnAMaker szolgáltatásvégpont hibakeresési célokra hasznos, ha kapcsolatba lép a QnAMaker ügyfélszolgálatával vagy a UserVoice-tal. A végpont egy URL-cím ebben az formában: https://your-resource-name.azurewebsites.net.

  1. Nyissa meg a QnAMaker-szolgáltatást (erőforráscsoportot) az Azure Portalon

    QnAMaker Azure resource group in Azure portal

  2. Válassza ki a QnA Maker-erőforráshoz társított App Service-t. A nevek általában azonosak.

    Select QnAMaker App Service

  3. A végpont URL-címe az Áttekintés szakaszban érhető el

    QnAMaker endpoint

A tudásbázis kezelése

Véletlenül töröltem a QnA Maker egy részét, mit tegyek?

Válasz: Ne törölje a QnA Maker-erőforrással együtt létrehozott Azure-szolgáltatásokat, például a keresést vagy a webalkalmazást. Ezek szükségesek a QnA Maker működéséhez, ha töröl egyet, a QnA Maker nem fog megfelelően működni.

Minden törlés végleges, beleértve a kérdés- és válaszpárokat, fájlokat, URL-címeket, egyéni kérdéseket és válaszokat, tudásbázis vagy Azure-erőforrásokat. A tudásbázis bármely részének törlése előtt mindenképpen exportálja a tudásbázis a Gépház lapról.

Miért nem nyeri ki az URL-cím(ek)/fájl(ok) a kérdés-válasz párokat?

Válasz: Lehetséges, hogy a QnA Maker nem tudja automatikusan kinyerni a kérdések és válaszok (QnA) tartalmát az érvényes GYIK URL-címekről. Ilyen esetekben beillesztheti a QnA-tartalmat egy .txt fájlba, és ellenőrizheti, hogy az eszköz betölti-e. Másik lehetőségként a QnA Maker portálon keresztül szerkesztői tartalommal is hozzáadhatja a tudásbázis.

Legfeljebb mekkora tudásbázist hozhatok létre?

Válasz: A tudásbázis mérete a QnA Maker szolgáltatás létrehozásakor választott Azure-keresés termékváltozatától függ. További részletekért olvassa el itt .

Miért nem található semmi a legördülő menüben, amikor új tudásbázist próbálok létrehozni?

Válasz: Még nem hozott létre QnA Maker-szolgáltatásokat az Azure-ban. Ebből a cikkből megtudhatja, hogyan teheti meg.

How do I share a knowledge base with others?

Válasz: A megosztás a QnA Maker szolgáltatás szintjén működik, vagyis a szolgáltatás összes tudásbázis meg lesz osztva. Itt megtudhatja, hogyan dolgozhat együtt egy tudásbázis.

Meg tud osztani egy tudásbázis olyan közreműködővel, aki nem ugyanabban az AAD-bérlőben található, hogy módosítson egy tudásbázis?

Válasz: A megosztás az Azure szerepköralapú hozzáférés-vezérlésén alapul. Ha bármilyen erőforrást megoszthat egy másik felhasználóval az Azure-ban, a QnA Makert is megoszthatja.

Ha rendelkezik 5 QnAMaker-tudásbázis tartalmazó App Service-csomaggal. Hozzárendelhet olvasási/írási jogosultságokat 5 különböző felhasználóhoz, hogy mindegyik csak 1 QnAMaker-tudásbázis férhessen hozzá?

Válasz: Egy teljes QnAMaker szolgáltatást oszthat meg, nem pedig egyéni tudásbázis.

Hogyan módosíthatom az alapértelmezett üzenetet, ha nem található megfelelő egyezés?

Válasz: Az alapértelmezett üzenet az App Service beállításainak része.

  • Ugrás az App Service-erőforrásra az Azure Portalon

qnamaker appservice

  • Válassza a Gépház lehetőséget

qnamaker appservice settings

  • A DefaultAnswer beállítás értékének módosítása
  • Az App Service újraindítása

qnamaker appservice restart

Miért nem nyerik ki a SharePoint-hivatkozásomat?

Válasz: További információkért tekintse meg az adatforrás helyeit .

A tudásbázis által készített frissítések nem jelennek meg a közzététel során. Miért ne?

Válasz: A közzététel előtt minden szerkesztési műveletet menteni kell, legyen szó táblafrissítésről, tesztelésről vagy beállításról. Minden szerkesztési művelet után válassza a Mentés és betanítás gombot.

Támogatja a tudásbázis a gazdag adatokat vagy a multimédiás tartalmakat?

Válasz:

Multimédiás automatikus kinyerés fájlokhoz és URL-címekhez

  • URL-címek – korlátozott HTML-to-Markdown konverziós képesség.
  • Fájlok – nem támogatott

Válaszszöveg a Markdownban

Miután a QnA-párok a tudásbázis szerepelnek, szerkesztheti a válasz markdown szövegét, hogy a nyilvános URL-címekről elérhető médiahivatkozásokat is tartalmazzon.

Támogatja a QnA Maker a nem angol nyelvű nyelveket?

Válasz: További részletek a támogatott nyelvekről.

Ha több nyelven is vannak tartalmai, ügyeljen rá, hogy minden nyelvhez külön-külön szolgáltatást hozzon létre.

Szolgáltatás kezelése

Mikor kell újraindítani az app service-t?

Válasz: Frissítse az appszolgáltatást, ha az óvatosság ikon a tudásbázis verzióértéke mellett található a Felhasználó Gépház lap Végpontkulcsok táblájában.

Töröltem a meglévő Search szolgáltatás. Hogyan javíthatom ki ezt a problémát?

Válasz: Ha töröl egy Azure AI Search-indexet, a művelet végleges, és az index nem állítható helyre.

Töröltem a "testkb" indexemet a Search szolgáltatás. Hogyan javíthatom ki ezt a problémát?

Válasz: Ha törölte az indexet a testkb Search szolgáltatás, visszaállíthatja az adatokat a legutóbb közzétett KB-ból. Használja a GitHubon elérhető RestoreTestKBIndex helyreállítási eszközt.

A következő hibaüzenet jelenik meg: Ellenőrizze, hogy a QnA Maker App Service CORS-beállításai engedélyezve https://www.qnamaker.ai vannak-e, vagy vannak-e szervezetspecifikus hálózati korlátozások. Hogyan oldhatom meg ezt?

Válasz: Az App Service panel API-szakaszában frissítse a CORS beállítást * vagy "https://www.qnamaker.ai" értékre. Ha ez nem oldja meg a problémát, keressen szervezetspecifikus korlátozásokat.

Mikor frissítsem a végpontkulcsokat?

Válasz: Frissítse a végpontkulcsokat, ha gyanítja, hogy feltörték őket.

Használhatom ugyanazt az Azure AI Search-erőforrást több nyelvet használó tudásbázis?

Válasz: Több nyelv és több tudásbázis használatához a felhasználónak minden nyelvhez létre kell hoznia egy QnA Maker-erőforrást. Ezzel nyelvenként különálló Azure Search szolgáltatások jönnek létre. A különböző nyelvi tudásbázis egyetlen Azure keresési szolgáltatásban való keverése az eredmények korlátozott relevanciáját eredményezi.

Hogyan módosíthatjam a QnA Maker által használt Azure AI Search-erőforrás nevét?

Válasz: Az Azure AI Search-erőforrás neve a QnA Maker-erőforrás neve, amelynek végén néhány véletlenszerű betű van hozzáfűzve. Emiatt nehéz megkülönböztetni a QnA Maker több keresési erőforrását. Hozzon létre egy külön keresési szolgáltatást (a kívánt elnevezéssel), és csatlakoztassa a QnA-szolgáltatáshoz. A lépések hasonlóak az Azure-keresés frissítéséhez szükséges lépésekhez.

Ha a QnA Maker a "Futtatókörnyezeti mag nincs inicializálva" értéket adja vissza, hogyan javíthatom ki?

Válasz: Előfordulhat, hogy az app service lemezterülete megtelt. A lemezterület javításának lépései:

  1. Az Azure Portalon válassza ki a QnA Maker appszolgáltatását, majd állítsa le a szolgáltatást.

  2. Miközben továbbra is az App Service-ben van, válassza a Fejlesztőeszközök, majd a Speciális eszközök, majd az Ugrás lehetőséget. Megnyílik egy új böngészőablak.

  3. Válassza a Hibakeresési konzol, majd a CMD lehetőséget egy parancssori eszköz megnyitásához.

  4. Lépjen a webhely/wwwroot/Data/QnAMaker/ könyvtárra.

  5. Távolítsa el az összes mappát, amelynek a neve a következővel rdkezdődik: .

    Ne törölje a következőket:

    • KbIdToRankerMappings.txt fájl
    • EndpointSettings.json fájl
    • EndpointKeys mappa
  6. Indítsa el az App service-t.

  7. A tudásbázis elérése annak ellenőrzéséhez, hogy működik-e.

Miért nem működik az alkalmazásom Elemzések?

Válasz: Ellenőrizze és frissítse az alábbi lépéseket a probléma megoldásához:

  1. Az App Service-ben –> Gépház csoport – Konfigurációs szakasz –>> Alkalmazás Gépház –> A "UserApp Elemzések Key" paraméter megfelelően van konfigurálva, és a megfelelő Application Insights Áttekintés lapra ("Instrumentation Key") guid értékre van állítva.

  2. Az App Service-ben –> Gépház csoport –> "Alkalmazás Elemzések" szakasz –> Győződjön meg arról, hogy az App Insights engedélyezve van, és csatlakozik a megfelelő Application Insights-erőforráshoz.

Az alkalmazás Elemzések engedélyezve van, de miért nem működik megfelelően?

Válasz: Kövesse az alábbi lépéseket:

  1. Másolja a "APPINSIGHTS_INSTRUMENTATIONKEY" név értékét a "UserApp Elemzések Key" névbe úgy, hogy felül kell bírálni, ha már van ott valamilyen érték.

  2. Ha a "UserApp Elemzések Key" kulcs nem létezik az alkalmazásbeállításokban, adjon hozzá egy új kulcsot ezzel a névvel, és másolja az értéket.

  3. Mentse, és ez automatikusan újraindítja az App Service-t. Ez segít a probléma elhárításában.

Integrálás más szolgáltatásokkal, például robotokkal

Szükségem van a Bot Framework használatára a QnA Maker használatához?

Válasz: Nem, nem kell a Bot Frameworkt használnia a QnA Makerrel. A QnA Maker azonban az Azure AI Bot Service számos sablonjának egyike. A Bot Service gyors intelligens robotfejlesztést tesz lehetővé a Microsoft Bot Frameworken keresztül, és kiszolgáló nélküli környezetben fut.

Hogyan hozhatok létre új robotot a QnA Makerrel?

Válasz: Kövesse a jelen dokumentáció utasításait a robot Azure AI Bot Service-lel való létrehozásához.

Hogyan egy másik tudásbázis használ egy meglévő Azure AI Bot Service-sel?

Válasz: A tudásbázis a következő információkkal kell rendelkeznie:

  • Tudásbázis azonosítója.
  • A tudásbázis közzétett végpontjának egyéni altartományának neve, más névenhost, Gépház oldalon található a közzététel után.
  • A tudásbázis közzétett végpontkulcsa – a közzététel után Gépház lapon található.

Ezekkel az információkkal keresse fel a robot appszolgáltatását az Azure Portalon. A Gépház –> Konfiguráció –> Alkalmazásbeállítások területen módosítsa ezeket az értékeket.

A tudásbázis végpontkulcsa az ABS szolgáltatásban van címkézveQnAAuthkey.

Megoszthat két vagy több ügyfélalkalmazás egy tudásbázis?

Válasz: Igen, a tudásbázis tetszőleges számú ügyféltől lekérdezhető. Ha a tudásbázis válasza lassúnak vagy időtúllépésnek tűnik, fontolja meg a tudásbázis társított app service szolgáltatási szintjének frissítését.

Hogyan beágyazza a QnA Maker szolgáltatást a webhelyemre?

Válasz: Kövesse az alábbi lépéseket a QnA Maker szolgáltatás webes csevegési vezérlőként való beágyazásához a webhelyén:

  1. Hozza létre a GYIK robotot az itt található utasítások követésével.
  2. A webes csevegés engedélyezéséhez kövesse az alábbi lépéseket

Adattárolás

Milyen adatokat tárol, és hol tárolja őket?

Válasz:

A QnA Maker-szolgáltatás létrehozásakor kiválasztott egy Azure-régiót. A tudásbázis és a naplófájlok ebben a régióban vannak tárolva.