Azure Bot-erőforrás létrehozása az Azure Portal használatával
A KÖVETKEZŐKRE VONATKOZIK: SDK v4
Az Azure Bot-erőforrás (roboterőforrás) lehetővé teszi a robot regisztrálását az Azure AI Bot Service-ben, és a robot csatornákhoz való csatlakoztatását. Robotokat hozhat létre, csatlakozhat és kezelhet, hogy bárhol is legyenek a felhasználók, az alkalmazástól vagy a webhelytől kezdve a Teamsig, a Messengerig és sok más csatornáig.
Ez a cikk azt ismerteti, hogyan hozhat létre roboterőforrást az Azure Portalon keresztül.
- A robotok létrehozásának módjáról a Bot Framework SDK rövid útmutatójában olvashat.
- A robot Azure-ban való üzembe helyezésével és közzétételével kapcsolatos információkért tekintse meg a robot üzembe helyezését az Azure-ban.
Erőforrások kezelése
Roboterőforrás létrehozásakor az Azure társított erőforrásokat hoz létre. A létrehozott erőforrások némelyike attól függ, hogyan kezeli a robot identitását.
A robot identitása többféleképpen kezelhető az Azure-ban.
- Felhasználó által hozzárendelt felügyelt identitásként, hogy önnek ne kelljen saját maga kezelnie a robot hitelesítő adatait.
- Egybérlős alkalmazásként.
- Több-bérlős alkalmazásként.
A felhasználó által hozzárendelt felügyelt identitások és egybérlős alkalmazástípusok támogatása a Bot Framework SDK for C#-hoz és JavaScripthez a 4.15.0-s verzióban lett hozzáadva. Ezek az alkalmazástípusok nem támogatottak más nyelveken, sem a Bot Framework Composer, a Bot Framework Emulator vagy az ngrok esetében.
| Alkalmazás típusa | Támogatás |
|---|---|
| Felhasználó által hozzárendelt felügyelt identitás | Az Azure AI Bot Service és a C# és JavaScript SDK-k |
| Egybérlős | Az Azure AI Bot Service és a C# és JavaScript SDK-k |
| Több-bérlős | Azure AI Bot Service, minden Bot Framework SDK-nyelv, Composer, Emulator és ngrok |
Előfeltételek
- Ha még nincs Azure-előfizetése, kezdés előtt hozzon létre egy ingyenes fiókot.
- A Bot Framework SDK a C# vagy JavaScript 4.15.0-s vagy újabb verziójához, felhasználó által hozzárendelt felügyelt identitásokhoz és egybérlős robotokhoz.
Az erőforrás létrehozása
Hozza létre az Azure Bot-erőforrást , amely lehetővé teszi a robot regisztrálását az Azure AI Bot Service-ben.
Tipp.
Nem hozhatók létre új webalkalmazás-robot - és robotcsatornák regisztrációs erőforrásai, azonban a konfigurált és üzembe helyezett meglévő erőforrások továbbra is működni fognak. A VSIX- vagy Yeoman-sablonból a 4.14.1.2-es vagy újabb SDK-verzióból létrehozott robotok ARM-sablonokat tartalmaznak, amelyek létrehoznak egy Azure Bot-erőforrást.
Nyissa meg az Azure Portalt.
A jobb oldali panelen válassza az Erőforrás létrehozása lehetőséget.
A keresőmezőbe írja be az Enter billentyűt
bot, majd nyomja le az Enter billentyűt.Válassza ki az Azure Bot-kártyát .
Válassza a Létrehozás lehetőséget.
Adja meg az értékeket a szükséges mezőkben, és tekintse át és frissítse a beállításokat.
Adja meg az információkat a Project részletei között. Válassza ki, hogy a robot globális vagy helyi adatokkal rendelkezik-e. A helyi adattárolási funkció jelenleg a "westeurope" és a "centralindia" régió erőforrásaihoz érhető el. További információ: Regionalizálás az Azure AI Bot Service-ben.
Adja meg az adatokat a Microsoft Alkalmazásazonosító alatt. Válassza ki, hogy a robotidentitás hogyan lesz felügyelve az Azure-ban, és hogy új identitást hoz-e létre, vagy használjon-e meglévőt.
Válassza az Áttekintés + létrehozás lehetőséget.
Ha az ellenőrzés sikeres, válassza a Létrehozás lehetőséget.
Az üzembe helyezés befejezése után válassza az Ugrás az erőforrásra lehetőséget. A robotnak és a kapcsolódó erőforrásoknak a kiválasztott erőforráscsoportban kell megjelennie.
Ha még nem rendelkezik a Bot Framework SDK-val, válassza a Letöltés a GitHubról lehetőséget, hogy megtudja, hogyan használhatja fel a csomagokat az előnyben részesített nyelvhez.
Most már készen áll a robot összeállítására a Bot Framework SDK-val.
Tipp.
Amikor az Azure létrehoz egy új egybérlős vagy több-bérlős Azure Bot-erőforrást egy új alkalmazásazonosítóval, az is létrehoz egy jelszót.
Robot identitásadatai
Kövesse az alábbi lépéseket, ha identitásadatokat szeretne hozzáadni a robot konfigurációs fájljához. A fájl a robot létrehozásához használt programozási nyelvtől függően eltérő.
Fontos
A Bot Framework SDK Java- és Python-verziói csak a több-bérlős robotokat támogatják. A C# és a JavaScript verziók mind a három alkalmazástípust támogatják a robot identitásának kezeléséhez.
| Nyelv | Fájlnév | Jegyzetek |
|---|---|---|
| C# | appsettings.json | Mindhárom alkalmazástípust támogatja a robot identitásának kezeléséhez. |
| JavaScript | .Env | Mindhárom alkalmazástípust támogatja a robot identitásának kezeléséhez. |
| Java | application.properties | Csak a több-bérlős robotokat támogatja. |
| Python | config.py | Csak a több-bérlős robotokat támogatja. Adja meg az identitástulajdonságokat argumentumként a os.environ.get metódushívásokhoz. |
A hozzáadni kívánt identitásadatok a robot alkalmazástípusától függenek. Adja meg a következő értékeket a konfigurációs fájlban.
Csak C# és JavaScript robotokhoz érhető el.
| Tulajdonság | Érték |
|---|---|
MicrosoftAppType |
UserAssignedMSI |
MicrosoftAppId |
A felhasználó által hozzárendelt felügyelt identitás ügyfélazonosítója. |
MicrosoftAppPassword |
Nem alkalmazható. Hagyja üresen a felhasználó által hozzárendelt felügyelt identitásrobotot. |
MicrosoftAppTenantId |
A felhasználó által hozzárendelt felügyelt identitás bérlőazonosítója. |
Az app service frissítése
Ha meglévő App Service-erőforrással (webalkalmazással) rendelkezik a robothoz, és a robot egy felhasználó által hozzárendelt felügyelt identitásalkalmazás , előfordulhat, hogy frissítenie kell a robot appszolgáltatását:
- Nyissa meg a robot webalkalmazásának App Service paneljét.
- A Gépház területen válassza az Identitás lehetőséget.
- Az Identitás panelen válassza a Felhasználóhoz rendelt lapot, majd a Hozzáadás (+) lehetőséget.
- A Felhasználó által hozzárendelt felügyelt identitás hozzáadása panelen:
Válassza ki előfizetését.
A felhasználó által hozzárendelt felügyelt identitások esetében válassza ki a robothoz tartozó felügyelt identitást. Ha a felügyelt identitás automatikusan létre lett hozva Önnek, akkor ugyanaz a neve lesz, mint a robotnak.
Válassza a Hozzáadás lehetőséget a robot identitásának használatához.
Az alkalmazás vagy a bérlőazonosító lekérése
A robot alkalmazásának vagy bérlőazonosítójának lekérése:
- Nyissa meg a robot Azure Bot-erőforrás paneljét.
- Lépjen a robot Konfiguráció paneljére. Ebből a panelről másolhatja a robot Microsoft-alkalmazásazonosítóját vagy alkalmazásbérlesztő-azonosítóját.
Új jelszó létrehozása
Az egybérlős és a több-bérlős robotok rendelkeznek egy alkalmazás titkos kódjával vagy jelszavuk, amely bizonyos műveletekhez szükséges. Az Azure AI Bot Service elrejti a robot titkos kódját. A robot App Service-erőforrásának tulajdonosa azonban létrehozhat egy új jelszót:
- Nyissa meg a robot Azure Bot-erőforrás paneljét.
- Lépjen a robot Konfiguráció paneljére.
- A Microsoft App ID mellett válassza a Kezelés lehetőséget az App Service Tanúsítványok + titkos kulcsok paneljének megtekintéséhez.
- A panel utasításait követve hozzon létre egy új ügyfélkulcsot, és rögzítse az értéket biztonságos helyen.
További információk
- A Microsoft Entra-azonosítóval történő identitáskezeléssel kapcsolatos információkért lásd : Mi a Microsoft Entra ID?.
- A Azure-alkalmazás Service- és App Service-csomagokkal kapcsolatos információkért tekintse meg az App Service áttekintését.
- Az Azure-erőforrásokról és azok általános kezeléséről az Azure Resource Manager áttekintésében olvashat.
Feljegyzés
A Bot Framework Composer és a Bot Framework Emulator jelenleg csak a több-bérlős robotokat támogatja. A C# vagy JavaScript 4.15.0-s vagy újabb verziójához készült Bot Framework SDK szükséges a felhasználó által hozzárendelt felügyelt identitásokhoz és az egybérlős robotokhoz.
Készségtámogatás
Bizonyos típusú készségfelhasználók nem tudnak bizonyos típusú képességrobotokat használni. Az alábbi táblázat ismerteti, hogy mely kombinációk támogatottak.
| Több-bérlős képesség | Egybérlős képesség | Felhasználó által hozzárendelt felügyelt identitástudás | |
|---|---|---|---|
| Több-bérlős fogyasztó | Támogatott | Nem támogatott | Nem támogatott |
| Egybérlős fogyasztó | Nem támogatott | Támogatott, ha mindkét alkalmazás ugyanahhoz a bérlőhöz tartozik | Támogatott, ha mindkét alkalmazás ugyanahhoz a bérlőhöz tartozik |
| Felhasználó által hozzárendelt felügyelt identitásfelhasználó | Nem támogatott | Támogatott, ha mindkét alkalmazás ugyanahhoz a bérlőhöz tartozik | Támogatott, ha mindkét alkalmazás ugyanahhoz a bérlőhöz tartozik |
A képesség- vagy képességfelhasználók konfigurálásáról további információt a Képesség megvalósítása vagy a Képességfelhasználó megvalósítása című témakörben talál.