Udostępnij przez

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

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

Aby tworzyć agentów z wybranymi usługami sztucznej inteligencji, orkiestracją i wiedzą, rozważ użycie zestawu SDK agentów platformy Microsoft 365. Zestaw SDK agentów obsługuje języki C#, JavaScript lub Python. Więcej informacji na temat zestawu SDK agentów można uzyskać na stronie aka.ms/agents. Jeśli szukasz platformy agenta opartej na modelu SaaS, rozważ microsoft Copilot Studio. Jeśli masz istniejącego bota utworzonego przy użyciu zestawu Bot Framework SDK, możesz zaktualizować bota do zestawu SDK agentów. Wskazówki dotyczące migracji z Bot Framework SDK do Agents SDK znajdziesz pod Bot Framework SDK to Agents SDK migration guidance, które omawiają podstawowe zmiany i aktualizacje. Zgłoszenia do pomocy technicznej dla zestawu Bot Framework SDK nie będą już obsługiwane od 31 grudnia 2025 r.

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 Typ opis
azureBotId Sznurek Wymagany. Globalnie unikatowa i niezmienna obsługa bota, taka jak ContosoCustomerService.
azureBotSku Sznurek Opcjonalny. Jednostka SKU zasobu usługi Azure Bot. Dozwolone wartości: "F0" (wersja bezpłatna) i "S1" (standardowa). Wartość domyślna to "S1".
azureBotRegion Sznurek Opcjonalny. Lokalizacja bota platformy Azure. Dozwolone wartości: "global", "westeurope", "westus" i "centralindia". Wartość domyślna to "global".
botEndpoint Sznurek Opcjonalny. Punkt końcowy obsługi komunikatów dla bota, taki jak https://<appServiceName>.azurewebsites.net/api/messages.
appType Sznurek 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 Sznurek 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 Sznurek Opcjonalny. W przypadku typów aplikacji tożsamości zarządzanej przypisanej przez użytkownika nazwa zasobu tożsamości.
UMSIResourceGroupName Sznurek Opcjonalny. W przypadku typów aplikacji tożsamości zarządzanej przypisanej przez użytkownika grupa zasobów dla zasobu tożsamości.
tenantId Sznurek 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
grupa zasobów 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.
Parametry Ś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
grupa zasobów Nazwa grupy zasobów platformy Azure, która zawiera usługę App Service.
nazwa Globalnie unikatowa i niezmienna obsługa bota.
punkt końcowy 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.

  • Last updated on