Sdílet prostřednictvím

Vytvoření nebo aktualizace prostředku robota Azure pomocí Azure CLI

  • Článek

PLATÍ PRO: SDK v4

Tento článek popisuje, jak vytvořit nebo aktualizovat prostředek robota Azure pomocí Azure CLI a šablony Azure Resource Manageru (šablona ARM).

Jedná se o součást rozsáhlejšího procesu zřizování a publikování robota.

Poznámka:

Sady SDK služby Bot Framework JavaScript, C# a Python budou nadále podporovány, ale sada Java SDK se vyřazuje s konečnou dlouhodobou podporou končící v listopadu 2023.

Stávající roboti sestavení pomocí sady Java SDK budou i nadále fungovat.

Při vytváření nových robotů zvažte použití aplikace Microsoft Copilot Studio a přečtěte si o výběru správného řešení copilotu.

Další informace najdete v tématu Budoucnost vytváření robotů.

Požadavky

Pokud chcete ke zřizování a publikování robotů používat Azure CLI, potřebujete:

  • Účet Azure, který má aktivní předplatné. Vytvořte si bezplatný účet.

  • Instalace Azure CLI.

    Pro váš programovací jazyk použijte následující verzi Azure CLI. Některé kroky nebudou fungovat s novějšími verzemi rozhraní příkazového řádku.

    Jazyk Verze rozhraní příkazového řádku
    C# a JavaScript 2.39.0 nebo novější
    Python 2.55.0 nebo novější
    Java 2.29.2

  • Tento proces používá šablonu Azure Resource Manageru (šablonu ARM) k vytvoření prostředku robota Azure pro vašeho robota.

    Pokud nemáte aktuální šablony, vytvořte ve svém projektu robota kopii složky deploymentTemplates : C#, JavaScript, Python nebo Java.

Tip

Jedná se o součást rozsáhlejšího procesu zřizování a publikování robota. Podívejte se, jak zřídit a publikovat robota , kde najdete úplný seznam požadavků.

Úprava souboru parametrů

Upravte soubor parametrů šablony ARM tak, aby obsahoval hodnoty, které chcete použít.

Důležité

Při vytváření prostředků App Service a Azure Bot musíte použít stejné appType appId hodnoty a hodnoty.

Pokud váš projekt ještě neobsahuje nejnovější soubory šablony a parametrů ARM, můžete je zkopírovat z úložiště sady BOT Framework SDK pro váš jazyk: C#, JavaScript, Python nebo Java.

Tato tabulka popisuje parametry nasazení v souboru parametrů pro použití s parameters možností příkazu. Ve výchozím nastavení je název souboru parametrů parameters-for-template-AzureBot-with-rg.json.

Parametr Typ Description
azureBotId String Povinný: Globálně jedinečný a neměnný popisovač robota, například ContosoCustomerService.
azureBotSku String Nepovinné. Skladová položka prostředku Azure Bot. Povolené hodnoty: "F0" (free) a "S1" (standard). Výchozí hodnota je S1.
azureBotRegion String Nepovinné. Umístění robota Azure Povolené hodnoty: "global", "westeurope", "westus" a "centralindia". Výchozí hodnota je "global".
botEndpoint String Nepovinné. Koncový bod zasílání zpráv pro robota, například https://<appServiceName>.azurewebsites.net/api/messages.
appType String Povinný: Jak se spravují identity vašich prostředků robota. Povolené hodnoty jsou: "MultiTenant", "SingleTenant" a "UserAssignedMSI". Výchozí hodnota je MultiTenant.
appId String Povinný: ID klienta nebo ID aplikace z prostředku identity, který jste vytvořili dříve. Toto je ID aplikace Microsoftu služby App Service.
UMSIName String Nepovinné. U typů aplikací spravovaných identit přiřazených uživatelem je název prostředku identity.
UMSIResourceGroupName String Nepovinné. U typů aplikací spravovaných identit přiřazených uživatelem je skupina prostředků prostředku identity.
tenantId String Nepovinné. Pro spravované identity přiřazené uživatelem a typy aplikací s jedním tenantem je ID tenanta Microsoft Entra ID prostředku identity.

Tip

Aby publikovaný robot mohl přijímat zprávy, musí být nastavený koncový bod zasílání zpráv robota.

Ne všechny parametry platí pro všechny typy aplikací.

Zadejte hodnoty pro UMSIName, UMSIResourceGroupNamea tenantId.

Vytvoření prostředku Azure Bot

K vytvoření prostředku Robota Azure pro robota použijte následující příkaz.

az deployment group create --resource-group <resource-group> --template-file <template-file-path> --parameters "@<parameters-file-path>"
Možnost Popis
resource-group Název skupiny prostředků Azure, ve které se má služba App Service vytvořit.
template-file Cesta k šabloně ARM pro službu App Service. Cesta může být relativní nebo absolutní.
parametry Cesta k souboru parametrů, který se má použít se šablonou ARM. Cesta může být relativní nebo absolutní.

U projektů vytvořených s nejnovějšími generátory se šablona ARM a soubory parametrů nacházejí ve složce DeploymentTemplates\DeployUseExistResourceGroup v rámci projektu. Výchozí názvy souborů jsou template-AzureBot-with-rg.json a parameters-for-template-AzureBot-with-rg.json.

Aktualizace prostředku Robota Azure

Pokud chcete přidat nebo aktualizovat koncový bod zasílání zpráv pro robota Azure, použijte následující příkaz.

az bot update --resource-group <resource group> --name <azureBotId> --endpoint <messaging-endpoint>
Možnost Popis
resource-group Název skupiny prostředků Azure, která obsahuje službu App Service.
name Globálně jedinečný a neměnný popisovač robota.
endpoint Koncový bod zasílání zpráv pro robota, například https://<appServiceName>.azurewebsites.net/api/messages.

Další informace

Další informace o šablonách ARM najdete v tématu Co jsou šablony ARM? a jak používat šablony nasazení Azure Resource Manageru (ARM) s Azure CLI.

Další kroky

Pokud jste službu App Service vytvořili jako součást nasazení robota, přečtěte si téma Vytvoření prostředků pomocí šablon ARM a pokračujte v procesu.