Share via

Azure Bot-erőforrás létrehozása vagy frissítése az Azure CLI használatával

  • Cikk

A KÖVETKEZŐKRE VONATKOZIK: SDK v4

Ez a cikk azt ismerteti, hogyan hozhat létre vagy frissíthet Azure Bot-erőforrást az Azure CLI-vel és egy Azure Resource Manager-sablonnal (ARM-sablonnal).

Ez a robot kiépítésének és közzétételének nagyobb folyamatának része.

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

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

  • Ez a folyamat egy Azure Resource Manager-sablont (ARM-sablont) használ egy Azure Bot-erőforrás létrehozásához a robot számára.

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

Tipp.

Ez a robot kiépítésének és közzétételének nagyobb folyamatának része. Megtudhatja, hogyan építhet ki és tehet közzé egy robotot az előfeltételek teljes listájához.

Paraméterfájl szerkesztése

Szerkessze az ARM-sablon paraméterfájlját, hogy tartalmazza a használni kívánt értékeket.

Fontos

Az App Service- és az Azure Bot-erőforrások létrehozásakor ugyanazokat appType és appId értékeket kell használnia.

Ha a projekt még nem tartalmazza a legújabb ARM-sablon- és paraméterfájlokat, a Robot Framework SDK adattárából másolhatja őket a következő nyelvhez: C#, JavaScript, Python vagy Java.

Ez a táblázat a paraméterfájl üzembehelyezési paramétereit ismerteti a parancsbeállítással való parameters használathoz. Alapértelmezés szerint a paraméterfájl neve parameters-for-template-AzureBot-with-rg.json.

Paraméter Típus Leírás
azureBotId Sztring Szükséges. A robot globálisan egyedi és nem módosítható fogópontja, például ContosoCustomerService.
azureBotSku Sztring Opcionális. Az Azure Bot-erőforrás termékváltozata. Engedélyezett értékek: "F0" (ingyenes) és "S1" (standard). Az alapértelmezett érték az "S1".
azureBotRegion Sztring Opcionális. Az Azure Bot helye. Megengedett értékek: "global", "westeurope", "westus" és "centralindia". Az alapértelmezett érték a "globális".
botEndpoint Sztring Opcionális. A robot üzenetkezelési végpontja, például https://<appServiceName>.azurewebsites.net/api/messages.
appType Sztring Szükséges. A roboterőforrások identitásainak kezelése. Az engedélyezett értékek a következők: "MultiTenant", "SingleTenant" és "UserAssignedMSI". Az alapértelmezett érték a "MultiTenant".
appId Sztring Szükséges. A korábban létrehozott identitáserőforrás ügyfél-azonosítója vagy alkalmazásazonosítója. Ez az app service Microsoft-alkalmazásazonosítója.
UMSIName Sztring Opcionális. A felhasználó által hozzárendelt felügyelt identitásalkalmazás-típusok esetében az identitáserőforrás neve.
UMSIResourceGroupName Sztring Opcionális. A felhasználó által hozzárendelt felügyelt identitásalkalmazás-típusok esetében az identitáserőforrás erőforráscsoportja.
tenantId Sztring Opcionális. A felhasználó által hozzárendelt felügyelt identitások és az egybérlős alkalmazástípusok esetében az identitáserőforrás Microsoft Entra ID-bérlőazonosítója.

Tipp.

A robot üzenetkezelési végpontját be kell állítani, mielőtt egy közzétett robot fogadhat üzeneteket.

Nem minden paraméter vonatkozik minden alkalmazástípusra.

Adjon meg értékeket a UMSIName, UMSIResourceGroupNameés tenantId.

Az Azure Bot-erőforrás létrehozása

A robotHoz tartozó Azure Bot-erőforrás létrehozásához használja az alábbi parancsot.

az deployment group create --resource-group <resource-group> --template-file <template-file-path> --parameters "@<parameters-file-path>"
Lehetőség Leírás
resource-group Annak az Azure-erőforráscsoportnak a neve, amelyben létre kívánja hozni az App Service-t.
sablonfájl Az App Service ARM-sablonjának elérési útja. Az elérési út lehet relatív vagy abszolút.
parameters Az ARM-sablonnal használandó paraméterfájl elérési útja. Az elérési út lehet relatív vagy abszolút.

A legújabb generátorokkal létrehozott projektek esetében az ARM-sablon és a paraméterfájlok a projekt DeploymentTemplates\DeployUseExistResourceGroup mappájában találhatók. Az alapértelmezett fájlnevek template-AzureBot-with-rg.json és parameters-for-template-AzureBot-with-rg.json.

Az Azure Bot-erőforrás frissítése

Az Azure Bot üzenetkezelési végpontjának hozzáadásához vagy frissítéséhez használja az alábbi parancsot.

az bot update --resource-group <resource group> --name <azureBotId> --endpoint <messaging-endpoint>
Lehetőség Leírás
resource-group Az App Service-t tartalmazó Azure-erőforráscsoport neve.
név A robot globálisan egyedi és nem módosítható fogópontja.
endpoint A robot üzenetkezelési végpontja, például https://<appServiceName>.azurewebsites.net/api/messages.

További információk

További információ az ARM-sablonokról: Mik azok az ARM-sablonok? és Az Azure Resource Manager (ARM) üzembehelyezési sablonjainak használata az Azure CLI-vel.

Következő lépések

Ha az App Service-t robottelepítés részeként hozta létre, a folyamat folytatásához tekintse meg az Erőforrások létrehozása ARM-sablonokkal című témakört.