Azure Bot-erőforrás létrehozása
A KÖVETKEZŐKRE VONATKOZIK: SDK v4
Az Azure Bot-erőforrás (roboterőforrás) lehetővé teszi, hogy regisztrálja a robotot az Azure Bot Servicesben, és hogy a robotot csatornákhoz csatlakoztassa. Robotokat hozhat létre, csatlakoztathat és kezelhet, hogy a felhasználókkal bárhol kommunikáljon, az alkalmazástól vagy a webhelytől kezdve a Teams, a Messengerig és sok más csatornáig. A robotok létrehozásáról a Bot Framework SDK rövid útmutatójában olvashat.
Ez a cikk azt ismerteti, hogyan hozhat létre roboterőforrást a Azure Portal keresztül. A roboterőforrás Azure CLI-n keresztüli létrehozásával kapcsolatos információkért tekintse meg, hogyan helyezheti üzembe a robotot az Azure-ban.
Roboterőforrás létrehozásakor az Azure létrehozza a társított erőforrásokat. 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 ne kelljen saját maga felügyelnie a robot hitelesítő adatait.
- Egybérlős alkalmazásként.
- Több-bérlős alkalmazásként.
A 4.15.0-s verzióban a C# és a JavaScript esetében a felhasználó által hozzárendelt felügyelt identitás és egybérlős alkalmazástípusok támogatása lett hozzáadva a Bot Framework SDK-hoz. Ezek az alkalmazástípusok más nyelveken, Bot Framework Composer, Bot Framework Emulator vagy ngrok nyelven nem támogatottak.
| Alkalmazástípus | Támogatás |
|---|---|
| Felhasználó által hozzárendelt felügyelt identitás | Az Azure Bot Service, valamint a C# és JavaScript SDK-k |
| Egybérlős | Az Azure Bot Service, valamint a C# és JavaScript SDK-k |
| Több-bérlős | Azure Bot Service, a Bot Framework SDK összes nyelve, Composer, a Emulator és az ngrok |
Előfeltételek
- Ha nem rendelkezik Azure-előfizetéssel, mindössze néhány perc alatt létrehozhat egy ingyenes fiókot a virtuális gép létrehozásának megkezdése előtt.
- A Bot Framework SDK 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, amellyel regisztrálhatja a robotot az Azure Bot Service.
Tipp
Az Azure-webalkalmazás-robotok és robotcsatornák regisztrációs erőforrástípusai elavultak. Az elavulás előtt konfigurált és üzembe helyezett erőforrások továbbra is működni fognak. A VSIX- vagy Yeoman-sablonból az SDK 4.14.1.2-es vagy újabb verziójából létrehozott robotok OLYAN ARM-sablonokat tartalmaznak, amelyek létrehoznak egy Azure Bot-erőforrást.
Nyissa meg az Azure Portal.
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 kötelező mezőkben. Válassza ki, hogy milyen típusú alkalmazást szeretne létrehozni, és hogy meglévő vagy új identitásadatokat szeretne-e használni.
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 Erőforrás megnyitása lehetőséget. A robotnak és a kapcsolódó erőforrásoknak meg kell jelennie a kiválasztott erőforráscsoportban.
Ha még nem rendelkezik a Bot Framework SDK-val, válassza a Letöltés GitHub 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, egy jelszót is létrehoz.
Robot identitásadatai
Az alábbi lépéseket követve adja hozzá az identitásadatokat 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 | Mind a három alkalmazástípust támogatja a robot identitásának kezeléséhez. |
| JavaScript | .env | Mind a há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él-azonosítója. |
MicrosoftAppPassword |
Nem alkalmazható. Ezt hagyja üresen egy felhasználó által hozzárendelt felügyelt identitást használó robot esetében. |
MicrosoftAppTenantId |
A felhasználó által hozzárendelt felügyelt identitás bérlőazonosítója. |
Ha már rendelkezik webalkalmazás-erőforrással a robothoz, és a robot egy felhasználó által hozzárendelt felügyelt identitásalkalmazás , előfordulhat, hogy frissítenie kell a robot webalkalmazá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.
Felhasználó által hozzárendelt felügyelt identitások esetében válassza ki a robot felügyelt identitását. Ha a felügyelt identitás automatikusan létre lett hozva Önnek, ugyanaz lesz a neve, mint a robotnak.
Válassza a Hozzáadás lehetőséget, ha ezt az identitást szeretné használni a robothoz.
A robot alkalmazás- 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. Ezen a panelen átmásolhatja a robot Microsoft-alkalmazásazonosítóját vagy alkalmazás-bérlőazonosítóját.
Az egybérlős és a több-bérlős robotok rendelkeznek egy alkalmazáskulcstal vagy jelszóval, amely bizonyos műveletekhez szükséges. Az Azure Bot Service elrejti a robot titkos kódját. A robot webalkalmazás-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-alkalmazásazonosító melletti Kezelés elemet választva lépjen a webalkalmazás Tanúsítványok + titkos kódok paneljére.
- A panelen található utasításokat követve hozzon létre egy új titkos ügyfélkulcsot, és rögzítse az értéket egy biztonságos helyen.
További információ
- Az Azure Active Directory identitáskezelésével kapcsolatos információkért lásd: Mi az Azure Active Directory?
- A Azure App Service és App Service tervekkel 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.
Megjegyzés
A Bot Framework Composer és a Bot Framework Emulator jelenleg csak a több-bérlős robotokat támogatják. A Bot Framework SDK for C# vagy JavaScript 4.15.0-s vagy újabb verziója szükséges a felhasználó által hozzárendelt felügyelt identitásokhoz és egybérlős robotokhoz.
Készségtámogatás
Bizonyos típusú készségfelhasználók nem tudnak használni bizonyos típusú készségrobotokat. 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ás készsége | |
|---|---|---|---|
| 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ás felhasználója | 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észség megvalósítása vagy a Képességfelhasználó megvalósítása című témakörben talál.