Robot kiépítése és közzététele

A KÖVETKEZŐKRE VONATKOZIK: SDK v4

Ez a cikk azt ismerteti, hogyan hozhat létre erőforrásokat a robot számára az Azure CLI használatával, hogyan készítheti elő a robotot az üzembe helyezéshez, és hogyan helyezheti üzembe a robotot az Azure-ban.

Ez a cikk feltételezi, hogy egy robot készen áll az üzembe helyezésre. Az egyszerű echorobotok létrehozásáról további információt a Bot Framework SDK-val rendelkező robot létrehozása című témakörben talál. A Bot Framework-minták adattárában található minták egyikét is használhatja.

Tipp.

Ez a cikk létrehoz egy Azure Bot-erőforrást a robot számára. A webalkalmazás-roboterőforrást vagy robotcsatorna-regisztrációs erőforrást használó meglévő robotok továbbra is működni fognak, de nem hozhat létre új robotokat, amelyek ezeket az erőforrástípusokat használják.

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

  • Java-robotok esetén telepítse a Mavent.

  • Ez a folyamat két Azure Resource Manager-sablont (ARM-sablont) használ a robot erőforrásainak létrehozásához.

    Ha nem rendelkezik az aktuális sablonokkal, hozzon létre egy másolatot a deploymentTemplates mappa robotprojektjében: C#, JavaScript, Python vagy Java.

A robotok üzembe helyezéséhez és közzétételéhez az Azure CLI-vel a következőkre van szükség:

  • Aktív előfizetéssel rendelkező Azure-fiók. Hozzon létre egy ingyenes fiókot.

  • Az Azure CLI telepítése.

    A programozási nyelvhez használja az Azure CLI alábbi verzióját. Egyes lépések nem működnek a parancssori felület későbbi verzióival.

    Nyelv Parancssori felület verziója
    C# és JavaScript 2.39.0 vagy újabb
    Python 2.55.0 vagy újabb
    Java 2.29.2

Feljegyzés

Ha a robot további erőforrásokat, például tárolási szolgáltatást vagy nyelvi szolgáltatásokat használ, ezeket külön kell üzembe helyezni.

Az üzembe helyezés megtervezése

Mielőtt hozzákezdene, hozza meg ezeket a döntéseket.

Döntés Jegyzetek
Roboterőforrások identitásainak kezelése az Azure-ban Használhat felhasználó által hozzárendelt felügyelt identitást, egybérlős alkalmazásregisztrációt vagy mutli-bérlős alkalmazásregisztrációt. További információ: Identitáserőforrás létrehozása.
Melyik erőforráscsoportban vagy erőforráscsoportban hozza létre a roboterőforrásokat? Amíg nem ismeri ezt a folyamatot, javasoljuk, hogy használjunk egy erőforráscsoportot. További információ: Azure-erőforrások kezelése.
Legyen a robot regionális vagy globális A regionális robotokról további információt az Azure AI Bot Service regionalizálása című témakörben talál.

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#, JavaScript és Python SDK-k
Több-bérlős Azure AI Bot Service, minden Bot Framework SDK-nyelv, Composer, Emulator és ngrok

Fontos

A Python-robotok nem helyezhetők üzembe windowsos szolgáltatásokat vagy robotokat tartalmazó erőforráscsoportban. Azonban több Python-robot is üzembe helyezhető ugyanahhoz az erőforráscsoporthoz. Hozzon létre más szolgáltatásokat, például az Azure AI-szolgáltatásokat egy másik erőforráscsoportban.

Azure-erőforrások

A robot üzembe helyezése előtt hozza létre (vagy hozza létre) a szükséges Azure-erőforrásokat. Néhány lépésben használhat egy meglévő erőforrást, vagy létrehozhat egy újat.

Hasznos lehet, ha előre eldönti, hogy milyen új erőforrásokat fog létrehozni, és hogy a meglévő erőforrásokat milyen néven fogja használni. A robot az ilyen típusú erőforrásokat fogja használni.

  • A robot kiépítéséhez, közzétételéhez és kezeléséhez használni kívánt Azure-előfizetés
  • Egy vagy több erőforráscsoport
  • Felhasználó által hozzárendelt felügyelt identitás vagy Microsoft Entra-azonosító alkalmazásregisztráció
  • App Service-csomag erőforrása
  • App Service-erőforrás
  • Azure Bot-erőforrás

Erőforrások között használt információk

Amikor erőforrásokat hoz létre az Azure-ban, az Azure azonosítókat, jelszavakat és egyéb információkat fog létrehozni vagy kérni, amelyekre a későbbi lépésekben szüksége lesz. Az alábbi táblázat felsorolja a rögzítendő erőforrásneveken túli információkat, a létrehozott lépést és a használt lépéseket.

Figyelemfelhívás

Ezen azonosítók és jelszavak közül sok bizalmas információ. A gyakori biztonsági irányelvekről további információt a Bot Framework biztonsági irányelvei című témakörben talál.

Tájékoztatás Ahol létrejött vagy megtalálható Hol használják?
Bérlőazonosító Bejelentkezés és előfizetés kiválasztása Az Azure CLI használata App Service-erőforrás létrehozásához, Azure CLI használata Azure Bot-erőforrás létrehozásához vagy frissítéséhez, projektkonfigurációs beállítások frissítése
Alkalmazás típusa Identitáserőforrás létrehozása Az Azure CLI használata App Service-erőforrás létrehozásához, Azure CLI használata Azure Bot-erőforrás létrehozásához vagy frissítéséhez, projektkonfigurációs beállítások frissítése
Ügyfél azonosítója Identitáserőforrás létrehozása Az Azure CLI használata App Service-erőforrás létrehozásához, Azure CLI használata Azure Bot-erőforrás létrehozásához vagy frissítéséhez, projektkonfigurációs beállítások frissítése
Alapalkalmazás-szolgáltatás URL-címe App Service-erőforrás létrehozása az Azure CLI használatával Azure Bot-erőforrás létrehozása vagy frissítése az Azure CLI használatával
App Service neve App Service-erőforrás létrehozása az Azure CLI használatával A robot közzététele az Azure-ban

Bejelentkezés és előfizetés kiválasztása

  1. Nyisson meg egy parancsablakot.

  2. Bejelentkezés az Azure-ba.

    az login
    
    • Ekkor megnyílik egy böngészőablak. Fejezze be a bejelentkezést.
    • Siker esetén a parancs megjeleníti azoknak az előfizetéseknek a listáját, amelyhez a fiókja rendelkezik hozzáféréssel.
  3. Az előfizetés használatának beállításához futtassa a következőt:

    az account set --subscription "<subscription>"
    

    Előfizetés> esetén <használja a használni kívánt előfizetés azonosítóját vagy nevét.

  4. Ha felhasználó által hozzárendelt felügyelt identitást vagy egy egybérlős robotot hoz létre, jegyezze fel az tenantId előfizetést. A bérlőazonosítót a következő lépésekben fogja használni.

Tipp.

Ha nem nyilvános felhőben kell dolgoznia, tekintse meg az Azure felhőfelügyeletét az Azure CLI-vel.

Erőforráscsoportok létrehozása

Ha még nincs megfelelő erőforráscsoportja, a az group create paranccsal hozza létre a szükséges új erőforráscsoportokat.

az group create --name "<group>" --location "<region>"
Lehetőség Leírás
név A létrehozandó erőforráscsoport neve.
hely Az a régió, amelyben létre kívánja hozni az erőforráscsoportot.

További információ: Azure-erőforráscsoportok kezelése az Azure CLI-vel.

Identitáserőforrás létrehozása

  1. Felhasználó által hozzárendelt felügyelt identitás létrehozásához használja a az identity create parancsot. Sikeresség esetén a parancs JSON-kimenetet hoz létre.

    az identity create --resource-group "<group>" --name "<identity>"
    
    Lehetőség Leírás
    resource-group Annak az erőforráscsoportnak a neve, amelyben létre kívánja hozni az identitást.
    név A létrehozandó identitáserőforrás neve.

    További információ: az identity reference.

  2. Jegyezze fel a későbbi lépésekben szükséges értékeket.

    1. Az identitáserőforrás erőforráscsoportjának neve
    2. Az identitáserőforrás neve
    3. A clientId parancs kimenete

Erőforrások létrehozása ARM-sablonokkal

Hozza létre az App Service-t és az Azure Bot-erőforrásokat a robothoz. Mindkét lépés egy ARM-sablont és az az deployment group create Azure CLI-parancsot használja az erőforrás vagy erőforrások létrehozásához.

  1. Hozzon létre egy App Service-erőforrást a robothoz. Az App Service egy új vagy meglévő App Service-csomagon belül is lehet.

    Részletes lépésekért lásd : App Service létrehozása az Azure CLI használatával.

  2. Hozzon létre egy Azure Bot-erőforrást a robothoz.

    Részletes lépésekért tekintse meg az Azure-robotok létrehozását vagy frissítését az Azure CLI használatával.

Fontos

Ezeket a lépéseket bármelyik sorrendben elvégezheti. Ha azonban először hozza létre az Azure Botot, frissítenie kell az üzenetkezelési végpontját az App Service-erőforrás létrehozása után.

Projektkonfigurációs beállítások frissítése

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-verziója csak a több-bérlős robotokat támogatja. A Bot Framework SDK Python-verziója támogatja a több-bérlős és az egybérlős robotokat. 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 Támogatja a több-bérlős és az egybérlős robotokat. Adja meg a tulajdonsá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.

Projektfájlok előkészítése

A robot üzembe helyezése előtt készítse elő a projektfájlokat.

  1. Váltson a projekt gyökérmappájára. C# esetén a gyökér a .csproj fájlt tartalmazó mappa.

  2. Tiszta újraépítést hajt végre kiadási módban.

  3. Ha korábban még nem tette meg, futtassa az bot prepare-deploy a szükséges fájlok hozzáadását a helyi forráskódkönyvtár gyökeréhez. Ez a parancs létrehoz egy .deployment fájlt a robotprojekt mappájában.

    az bot prepare-deploy --lang Csharp --code-dir "." --proj-file-path "<my-cs-proj>"
    
    Lehetőség Leírás
    Lang A robot nyelve vagy futtatókörnyezete. Használja az Csharp parancsot.
    code-dir A létrehozott üzembehelyezési fájlok elhelyezéséhez szükséges könyvtár. Használja a projekt gyökérmappáját. Az alapértelmezett az aktuális könyvtár.
    proj-file-path A robot .csproj fájljának elérési útja a code-dir beállításhoz képest.
  4. A projekt gyökérmappájában hozzon létre egy zip-fájlt, amely tartalmazza az összes fájlt és almappát.

A robot közzététele az Azure-ban

Ezen a ponton készen áll a robot kódjának üzembe helyezésére az App Service-erőforrásban.

Feljegyzés

Ez a lépés eltarthat néhány percig. Az üzembe helyezés befejeződése és a robot tesztelése is eltarthat néhány percig.

Futtassa a következő parancsot a parancssorból az üzembe helyezés végrehajtásához az App Service (webalkalmazás) Kudu zip leküldéses üzembe helyezésével.

az webapp deployment source config-zip --resource-group "<resource-group-name>" --name "<name-of-app-service>" --src "<project-zip-path>"
Lehetőség Leírás
resource-group A robotot tartalmazó Azure-erőforráscsoport neve.
név A korábban használt app service neve.
src A létrehozott tömörített projektfájl abszolút vagy relatív elérési útja.

Tipp.

Ez a parancs alapértelmezés szerint az éles ponton telepedik. Az opcionális --slot paraméterrel adjon meg egy másik pontot. További információ: az az webapp deployment source config-zip command reference.

Tesztelés webes csevegésben

  1. A böngészőben lépjen az Azure Portalra.
  2. Nyissa meg a roboterőforrást.
  3. Nyissa meg a Teszt webchat panelt.
  4. Használja az üzembe helyezett robotot.

A robotregisztrációval kapcsolatos további információkért lásd : Robot regisztrálása a Bot Service szolgáltatással.

Az erőforrások eltávolítása

Ha nem fogja közzétenni ezt az alkalmazást, törölje a társított erőforrásokat a következő lépésekkel:

  1. Az Azure Portalon nyissa meg a robot erőforráscsoportját.
    1. Válassza az Erőforráscsoport törlése lehetőséget a csoport és az összes benne lévő erőforrás törléséhez.
    2. Adja meg az erőforráscsoport nevét a megerősítést kérő panelen, majd válassza a Törlés lehetőséget.
  2. Ha egy-bérlős vagy több-bérlős alkalmazást hozott létre:
    1. Lépjen a Microsoft Entra ID panelre.
    2. Keresse meg a robothoz használt alkalmazásregisztrációt, és törölje azt.

További erőforrások

A robot üzemeltetéséhez használt Azure-alkalmazásokkal és erőforrásokkal kapcsolatos további információkért tekintse meg ezeket a cikkeket.

Tárgy Cikk
Azure CLI Mi az Az Azure CLI?
Azure-előfizetések kezelése Azure-előfizetések kezelése az Azure CLI-vel
Azure-régiók Régiók és rendelkezésre állási zónák
Erőforráscsoportok és erőforrás-kezelés Azure-erőforrások kezelése
Felügyelt identitások Melyek az Azure-erőforrások felügyelt identitásai?
Egy-bérlős és több-bérlős alkalmazások Bérlői fiók a Microsoft Entra ID-ban
Webes alkalmazások App Service
Számítási erőforrások webalkalmazásokhoz App Service-csomagok
Azure Resource Manager-sablonok (ARM-sablonok) Mik azok az ARM-sablonok? és Az Azure Resource Manager (ARM) üzembehelyezési sablonjainak használata az Azure CLI-vel
Azure-számlázás Számlázás és költségkezelés

Kudu-fájlok

A webalkalmazás üzembe helyezési parancsa a Kudu használatával telepíti a C#, JavaScript és Python robotokat. Ha a nem konfigurált zip deploy API-t használja a robot kódjának üzembe helyezéséhez, a viselkedés a következő:

A Kudu alapértelmezés szerint feltételezi, hogy az .zip fájlokból származó központi telepítések készen állnak a futtatásra, és nem igényelnek további buildelési lépéseket az üzembe helyezés során, például npm telepítés vagy dotnet restore/dotnet publish.

Fontos, hogy az üzembe helyezett zip-fájlban szerepeljen az összes szükséges függőséget tartalmazó beépített kód; ellenkező esetben a robot nem a kívánt módon fog működni. További információkért tekintse meg az Azure dokumentációját a fájlok App Service-ben való üzembe helyezéséről.

Következő lépések