Tworzenie lub aktualizowanie zasobu usługi Azure Bot przy użyciu interfejsu wiersza polecenia platformy Azure

  • Artykuł

DOTYCZY: ZESTAW SDK w wersji 4

W tym artykule opisano sposób tworzenia lub aktualizowania zasobu usługi Azure Bot przy użyciu interfejsu wiersza polecenia platformy Azure i szablonu usługi Azure Resource Manager (szablonu usługi ARM).

Jest to część większego procesu aprowizacji i publikowania bota.

Uwaga

Zestawy SDK języka JavaScript, C# i Python platformy Bot Framework będą nadal obsługiwane, jednak zestaw SDK języka Java jest wycofywany z ostatecznym długoterminowym wsparciem kończącym się w listopadzie 2023 r.

Istniejące boty utworzone za pomocą zestawu JAVA SDK będą nadal działać.

W przypadku tworzenia nowego bota rozważ użycie agentów usługi Power Virtual Agents i przeczytaj o wyborze odpowiedniego rozwiązania czatbota.

Aby uzyskać więcej informacji, zobacz Przyszłość tworzenia botów.

Wymagania wstępne

Aby aprowizować i publikować boty przy użyciu interfejsu wiersza polecenia platformy Azure, potrzebne są następujące elementy:

  • Konto platformy Azure z aktywną subskrypcją. Utwórz bezpłatne konto.

  • Instalacja interfejsu wiersza polecenia platformy Azure.

    W przypadku języka programowania użyj następującej wersji interfejsu wiersza polecenia platformy Azure. Niektóre kroki nie będą działać z nowszymi wersjami interfejsu wiersza polecenia.

    Język Wersja interfejsu wiersza polecenia
    C# i JavaScript 2.39.0 lub nowsza
    Python 2.55.0 lub nowszy
    Java 2.29.2

  • Ten proces używa szablonu usługi Azure Resource Manager (szablonu usługi ARM) do utworzenia zasobu usługi Azure Bot dla bota.

    Jeśli nie masz bieżących szablonów, utwórz kopię w projekcie bota folderu deploymentTemplates : C#, JavaScript, Python lub Java.

Napiwek

Jest to część większego procesu aprowizacji i publikowania bota. Zobacz, jak aprowizować i publikować bota , aby uzyskać pełną listę wymagań wstępnych.

Edytowanie pliku parametrów

Edytuj plik parametrów szablonu usługi ARM, aby zawierał wartości, których chcesz użyć.

Ważne

Należy użyć tych samych appType wartości i appId podczas tworzenia zasobów usługi App Service i usługi Azure Bot.

Jeśli projekt nie zawiera jeszcze najnowszych plików szablonów i parametrów usługi ARM, możesz skopiować je z repozytorium zestawu SDK platformy Bot Framework dla swojego języka: C#, JavaScript, Python lub Java.

W tej tabeli opisano parametry wdrożenia w pliku parametrów do użycia z opcją parameters polecenia. Domyślnie nazwa pliku parametrów jest parameters-for-template-AzureBot-with-rg.json.

Parametr Type opis
azureBotId String Wymagany. Globalnie unikatowa i niezmienna obsługa bota, taka jak ContosoCustomerService.
azureBotSku String Opcjonalny. Jednostka SKU zasobu usługi Azure Bot. Dozwolone wartości: "F0" (wersja bezpłatna) i "S1" (standardowa). Wartość domyślna to "S1".
azureBotRegion String Opcjonalny. Lokalizacja bota platformy Azure. Dozwolone wartości: "global", "westeurope", "westus" i "centralindia". Wartość domyślna to "global".
botEndpoint String Opcjonalny. Punkt końcowy obsługi komunikatów dla bota, taki jak https://<appServiceName>.azurewebsites.net/api/messages.
appType String Wymagany. Sposób zarządzania tożsamościami zasobów bota. Dozwolone wartości to: "MultiTenant", "SingleTenant" i "UserAssignedMSI". Wartość domyślna to "MultiTenant".
appId String Wymagany. Identyfikator klienta lub identyfikator aplikacji z utworzonego wcześniej zasobu tożsamości. Jest to identyfikator aplikacji firmy Microsoft usługi App Service.
UMSIName String Opcjonalny. W przypadku typów aplikacji tożsamości zarządzanej przypisanej przez użytkownika nazwa zasobu tożsamości.
UMSIResourceGroupName String Opcjonalny. W przypadku typów aplikacji tożsamości zarządzanej przypisanej przez użytkownika grupa zasobów dla zasobu tożsamości.
tenantId String Opcjonalny. W przypadku tożsamości zarządzanej przypisanej przez użytkownika i typów aplikacji z jedną dzierżawą identyfikator dzierżawy Firmy Microsoft dla zasobu tożsamości.

Napiwek

Aby opublikowany bot mógł odbierać komunikaty, należy ustawić punkt końcowy obsługi komunikatów bota.

Nie wszystkie parametry mają zastosowanie do wszystkich typów aplikacji.

Podaj wartości dla UMSIName, UMSIResourceGroupNamei tenantId.

Tworzenie zasobu usługi Azure Bot

Aby utworzyć zasób usługi Azure Bot dla bota, użyj następującego polecenia.

az deployment group create --resource-group <resource-group> --template-file <template-file-path> --parameters "@<parameters-file-path>"
Opcja Opis
resource-group Nazwa grupy zasobów platformy Azure, w której ma zostać utworzona usługa App Service.
plik-szablonu Ścieżka do szablonu usługi ARM dla usługi App Service. Ścieżka może być względna lub bezwzględna.
parameters Ścieżka do pliku parametrów do użycia z szablonem usługi ARM. Ścieżka może być względna lub bezwzględna.

W przypadku projektów utworzonych przy użyciu najnowszych generatorów pliki szablonu i parametrów usługi ARM znajdują się w folderze DeploymentTemplates\DeployUseExistResourceGroup w projekcie. Domyślne nazwy plików to template-AzureBot-with-rg.json i parameters-for-template-AzureBot-with-rg.json.

Aby zaktualizować zasób usługi Azure Bot

Aby dodać lub zaktualizować punkt końcowy obsługi komunikatów dla bota platformy Azure, użyj następującego polecenia.

az bot update --resource-group <resource group> --name <azureBotId> --endpoint <messaging-endpoint>
Opcja Opis
resource-group Nazwa grupy zasobów platformy Azure, która zawiera usługę App Service.
name Globalnie unikatowa i niezmienna obsługa bota.
endpoint Punkt końcowy obsługi komunikatów dla bota, taki jak https://<appServiceName>.azurewebsites.net/api/messages.

Dodatkowe informacje

Aby uzyskać więcej informacji na temat szablonów usługi ARM, zobacz Co to są szablony usługi ARM? i Jak używać szablonów wdrażania usługi Azure Resource Manager (ARM) za pomocą interfejsu wiersza polecenia platformy Azure.

Następne kroki

Jeśli usługa App Service została utworzona w ramach wdrożenia bota, zobacz Tworzenie zasobów przy użyciu szablonów usługi ARM, aby kontynuować proces.