Kérdések megválaszolása a QnA Maker szolgáltatással

A KÖVETKEZŐKRE VONATKOZIK: SDK v4

Feljegyzés

Az Azure AI QnA Maker 2025. március 31-én megszűnik. 2022. október 1-től nem hozhat létre új QnA Maker-erőforrásokat vagy tudásbázis. A kérdés- és válaszképesség újabb verziója már elérhető az Azure AI Language részeként.

Az Egyéni kérdések megválaszolása, az Azure AI Nyelv egyik funkciója a QnA Maker szolgáltatás frissített verziója. A Bot Framework SDK kérdés-válasz támogatásával kapcsolatos további információkért lásd a természetes nyelv megértését.

A QnA Maker egy beszélgetésre szánt, kérdés és válasz típusú réteget hoz létre az adatok alapján. Ez lehetővé teszi a robot számára, hogy kérdéseket küldjön a QnA Makernek, és anélkül kapja meg a választ, hogy el kellene végezni a kérdés mögötti szándék elemzését és értelmezését.

A saját QnA Maker szolgáltatás létrehozásának egyik alapvető követelménye a kérdésekkel és válaszokkal való feltöltés. Sok esetben a kérdések és válaszok már léteznek egy GYIK-ban vagy más dokumentumban; máskor érdemes lehet a kérdésekre adott válaszokat természetesebb, társalgási stílusban testre szabni.

Ez a cikk bemutatja, hogyan használhat meglévő QnA Maker-tudásbázis a robotból.

Új robotok esetén fontolja meg az Azure Cognitive Service for Language kérdés megválaszolási funkciójának használatát. További információt a Kérdések megválaszolása kérdés megválaszolása című témakörben talál.

Feljegyzés

A Bot Framework JavaScript, C# és Python SDK-k továbbra is támogatottak lesznek, a Java SDK-t azonban 2023 novemberében végső hosszú távú támogatással kivonják.

A Java SDK-val létrehozott meglévő robotok továbbra is működni fognak.

Új robotépítéshez fontolja meg a Power Virtual Agents használatát, és olvassa el a megfelelő csevegőrobot-megoldás kiválasztását.

További információ: A robotépítés jövője.

Előfeltételek

• Egy QnA Maker-fiók és egy meglévő QnA Maker-tudásbázis.
• A robot alapjainakés a QnA Makernek a ismerete.
• A QnA Maker (egyszerű) mintájának másolata C# (archivált), JavaScript (archivált), Java (archivált) vagy Python (archivált) nyelven.

A minta ismertetése

A QnA Maker robotban való használatához szüksége van egy meglévő tudásbázis a QnA Maker portálján. A robot ezután a tudásbázis használatával válaszolhat a felhasználó kérdéseire.

Új robotfejlesztéshez fontolja meg a Power Virtual Agents használatát. Ha új tudásbázis kell létrehoznia egy Bot Framework SDK-robothoz, tekintse meg az alábbi Azure AI-szolgáltatásokra vonatkozó cikkeket:

• Mi a kérdés megválaszolása?
• GYIK-robot létrehozása
• Azure Cognitive Language Services –kérdések megválaszolása ügyfélkódtár a .NET-hez

C#

OnMessageActivityAsync a rendszer minden fogadott felhasználói bemenethez meghívja. Hívás esetén a mintakód appsetting.json fájljából fér hozzá a konfigurációs beállításokhoz, hogy megtalálja az előre konfigurált QnA Maker-tudásbázis való csatlakozáshoz szükséges értéket.

JavaScript

OnMessage a rendszer minden fogadott felhasználói bemenethez meghívja. Hívás esetén a mintakód .env fájljából fér hozzá a konfigurációs beállításokhoz. A qnamaker metódus getAnswers összekapcsolja a robotot a külső QnA Maker-tudásbázis.

Java

onMessageActivity a rendszer minden fogadott felhasználói bemenethez meghívja. Hívás esetén a mintakód application.properties fájljából fér hozzá a konfigurációs beállításokhoz, hogy megtalálja az előre konfigurált QnA Maker-tudásbázis való csatlakozáshoz szükséges értéket.

Python

on_message_activity a rendszer minden fogadott felhasználói bemenethez meghívja. Hívás esetén a mintakód config.py fájljából fér hozzá a konfigurációs beállításokhoz. Ez a módszer qna_maker.getAnswers csatlakoztatja a robotot a külső QnA Maker-tudásbázis.

A rendszer elküldi a felhasználó bemenetét a tudásbázis, és a legjobban visszaadott válasz megjelenik a felhasználónak.

Értékek lekérése a robot tudásbázis való csatlakoztatásához

Tipp.

A QnA Maker dokumentációja útmutatást tartalmaz a tudásbázis létrehozásához, betanításához és közzétételéhez.

1. A QnA Maker webhelyén válassza ki a tudásbázis.
2. A tudásbázis megnyitása után válassza a Standard kiadás TTINGS lapot. Jegyezze fel a szolgáltatásnévhez megjelenített értéket. Ez az érték a QnA Maker portál felületének használatakor hasznos lehet a tudásbázis megkereséséhez. A robotalkalmazás nem csatlakoztatható ehhez a tudásbázis.
3. Görgessen le az üzembe helyezés részleteinek megkereséséhez, és rögzítse a Postman-minta HTTP-kérés alábbi értékeit:
   • POST /tudásbázisok/<tudásbázis-azonosító>/generateAnswer
   • Gazdagép: <a saját gazdagép url-címe>
   • Engedélyezés: EndpointKey <your-endpoint-key>

A gazdagép URL-címe a következővel https:///qnamakerkezdődik és végződik: például https://<hostname>.azure.net/qnamaker. A robotnak szüksége van a tudásbázis azonosítóra, a gazdagép URL-címére és a végpontkulcsra a QnA Maker tudásbázis való csatlakozáshoz.

A beállításfájl frissítése

Először adja hozzá a tudásbázis eléréséhez szükséges információkat – beleértve a gazdagép nevét, a végpontkulcsot és a tudásbázis azonosítót (kbId) – a beállításfájlba. Ezeket az értékeket mentette a tudásbázis Standard kiadás TTINGS lapjáról a QnA Makerben.

Ha ezt nem éles környezetben telepíti, a robot alkalmazásazonosítóját és jelszómezőit üresen hagyhatja.

Feljegyzés

Ha QnA Maker-tudásbázis szeretne hozzáadni egy meglévő robotalkalmazáshoz, mindenképpen adjon hozzá informatív címeket a QnA-bejegyzésekhez. Az ebben a szakaszban található "név" érték biztosítja az alkalmazáson belüli információk eléréséhez szükséges kulcsot.

C#

appsettings.json

C# (archiválva)

JavaScript

.Env

JavaScript (archiválva)

Java

application.properties

Java (archiválva)

Python

config.py

Python (archiválva)

A QnA Maker-példány beállítása

Először létrehozunk egy objektumot a QnA Maker tudásbázis eléréséhez.

C#

Győződjön meg arról, hogy a Microsoft.Bot.Builder.AI.QnA NuGet csomag telepítve van a projekthez.

A QnABot.cs metódusban OnMessageActivityAsync hozzon létre egy QnAMaker-példányt. Az QnABot osztályban a fenti appsettings.json mentett kapcsolati adatok neve is be lesz húzva. Ha különböző neveket választott a tudásbázis kapcsolati adataihoz a beállításfájlban, mindenképpen frissítse a neveket itt, hogy tükrözze a választott nevet.

Robotok/QnABot.cs

C# (archiválva)

JavaScript

Győződjön meg arról, hogy az npm-csomag botbuilder-ai telepítve van a projekthez.

A mintában a robotlogika kódja a QnABot.js fájlban található.

A QnABot.js fájlban az .env fájl által megadott kapcsolati információkat használjuk a QnA Maker szolgáltatáshoz való kapcsolat létrehozásához: ez.qnaMaker.

robotok/QnABot.js

JavaScript (archiválva)

Java

A QnABot.java metódusban onMessageActivity hozzon létre egy QnAMaker-példányt. Az QnABot osztályban a fenti application.properties fájlban mentett kapcsolati adatok neve is be lesz kérve. Ha különböző neveket választott a tudásbázis kapcsolati adataihoz a beállításfájlban, mindenképpen frissítse a neveket itt, hogy tükrözze a választott nevet.

QnABot.java

Java (archiválva)

Python

A qna_bot.py fájlban használja a config.py fájl által megadott kapcsolati adatokat a QnA Maker szolgáltatáshoz való kapcsolat létrehozásához: self.qna_maker.

robotok/qna_bot.py

Python (archiválva)

A QnA Maker meghívása a robotból

C#

Ha a robotnak választ kell kapnia a QnAMakertől, hívja meg a GetAnswersAsync robotkód metódusát, hogy az aktuális környezet alapján megkapja a megfelelő választ. Ha saját tudásbázis fér hozzá, módosítsa az alábbi nem talált válaszokat, hogy hasznos utasításokat adjon a felhasználóknak.

Robotok/QnABot.cs

C# (archiválva)

JavaScript

A QnABot.js fájlban továbbítjuk a felhasználó bemenetét a QnA Maker szolgáltatás metódusánakgetAnswers, hogy válaszokat kapjunk a tudásbázis. Ha a QnA Maker választ ad vissza, az megjelenik a felhasználónak. Ellenkező esetben a felhasználó a következő üzenetet kapja: "Nem található QnA Maker-válasz".

robotok/QnABot.js

JavaScript (archiválva)

Java

Ha a robotnak választ kell kapnia a QnAMakertől, hívja meg a getAnswers robotkód metódusát, hogy az aktuális környezet alapján megkapja a megfelelő választ. Ha hozzáfér a tudásbázis, módosítsa a nem talált válaszokat tartalmazó üzenetet, hogy hasznos utasításokat adjon a felhasználóknak.

QnABot.java

Java (archiválva)

Python

A qna_bot.py fájlban továbbítjuk a felhasználó bemenetét a QnA Maker szolgáltatás metódusánakget_answers, hogy válaszokat kapjunk a tudásbázis. Ha a QnA Maker választ ad vissza, az megjelenik a felhasználónak. Ellenkező esetben a felhasználó azt az üzenetet kapja, hogy nem található QnA Maker-válasz.

robotok/qna_bot.py

Python (archiválva)

A robot tesztelése

Futtassa a mintát helyileg a számítógépen. Ha még nem tette meg, telepítse a Bot Framework Emulatort. További útmutatásért tekintse meg a minta README (C# (archivált), JavaScript (archivált), Java (archivált) vagy Python (archivált) kódját.

Indítsa el az Emulatort, csatlakozzon a robothoz, és küldjön üzeneteket a robotnak. A kérdésekre adott válaszok a tudásbázis információitól függően eltérőek lesznek.

További információk

A QnA Maker többfordulós mintája (C# többfordulós minta (archivált), JavaScript többfordulós minta (archivált), Java többfordulós minta (archivált), Python többfordulós minta (archivált)) bemutatja, hogyan használható a QnA Maker párbeszédpanelje a QnA Maker nyomon követési parancssori és aktív tanulási funkcióinak támogatásához.

• A QnA Maker támogatja a nyomon követési utasításokat, más néven többfordulós kéréseket. Ha a QnA Maker tudásbázis további információt igényel a felhasználótól, a QnA Maker környezeti információkat küld, amelyekkel rákérdezhet a felhasználóra. Ez az információ a QnA Maker szolgáltatáshoz intézett nyomon követési hívások indítására is szolgál. A 4.6-os verzióban a Bot Framework SDK támogatást adott ehhez a funkcióhoz.

  Ha ilyen tudásbázis szeretne létrehozni, tekintse meg a QnA Maker dokumentációját, amely bemutatja, hogyan hozhat létre több beszélgetési fordulót a követő kérdések használatával.

• A QnA Maker támogatja az aktív tanulási javaslatokat is, amelyek lehetővé teszik, hogy a tudásbázis idővel javuljanak. A QnA Maker párbeszédpanel támogatja az aktív tanulási funkció kifejezett visszajelzését.

  Ha engedélyezni szeretné ezt a funkciót egy tudásbázis, tekintse meg a QnA Maker active learning-javaslatokra vonatkozó dokumentációját.

Következő lépések

A QnA Maker más Azure AI-szolgáltatásokkal is kombinálható, hogy a robot még hatékonyabb legyen. A Bot Framework Orchestrator lehetővé teszi a QnA és a Language Understanding (LUIS) kombinálásának módját a robotban.

Az Orchestrator használata szándékfeloldáshoz