Udostępnij za pośrednictwem

Tworzenie i publikowanie bota za pomocą programu Azure PowerShell

DOTYCZY: ZESTAW SDK w wersji 4

W tym artykule pokazano, jak za pomocą programu Azure PowerShell utworzyć bota i zarejestrować go na platformie Azure przy użyciu istniejącej rejestracji aplikacji Microsoft Entra ID.

Hostowanie bota przy użyciu zasobu usługi Azure Bot . Utworzysz i opracujesz bota lokalnie i będziesz go hostować na platformie Azure lub na innej platformie. Postępuj zgodnie z instrukcjami opisanymi w temacie Rejestrowanie bota na platformie Azure. Podczas rejestrowania bota podajesz adres internetowy, na którym jest hostowany bot. Nadal można go hostować na platformie Azure.

Te polecenia można uruchamiać lokalnie przy użyciu programu Azure PowerShell lub zdalnie za pośrednictwem witryny Azure Portal przy użyciu programu Azure CloudShell. Aby uzyskać więcej informacji na temat programu Azure CloudShell, zobacz Omówienie usługi Azure Cloud Shell.

Ważne

Moduł Az.BotService programu PowerShell jest w wersji zapoznawczej, ale należy zainstalować go oddzielnie przy użyciu Install-Module polecenia cmdlet .

Tworzenie bota za pomocą usługi Azure AI Bot Service i tworzenie bota lokalnie to niezależne, równoległe sposoby tworzenia bota.

Wymagania wstępne

  • Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto.

  • Istniejąca rejestracja aplikacji Microsoft Entra ID, która może być używana z dowolnej dzierżawy identyfikatora Entra firmy Microsoft.

    • Aby ukończyć ten przewodnik Szybki start, musisz mieć identyfikator aplikacji i wpis tajny rejestracji aplikacji.

  • Zainstaluj moduł Az programu PowerShell. Jest to wymagane, ponieważ moduł Az.BotService jest w wersji zapoznawczej.

    Install-Module -Name Az.BotService -AllowClobber

  • Jeśli zdecydujesz się używać programu Azure PowerShell lokalnie:

Wybierz swoją subskrypcję

Jeśli masz wiele subskrypcji platformy Azure, wybierz odpowiednią subskrypcję, w której mają być rozliczane zasoby.

  1. Aby wyświetlić listę subskrypcji, do których możesz uzyskać dostęp, użyj polecenia cmdlet Get-AzSubscription .

    Get-AzSubscription

  2. Ustaw określoną subskrypcję przy użyciu polecenia cmdlet Set-AzContext .

    Należy użyć tej samej subskrypcji dla bota co w przypadku rejestracji aplikacji.

    Set-AzContext -SubscriptionId "<your-subscription-name-or-id>"

Tworzenie grupy zasobów

Jeśli nie masz jeszcze grupy zasobów platformy Azure, której chcesz użyć dla bota, utwórz nową za pomocą polecenia cmdlet New-AzResourceGroup .

  • Grupa zasobów to logiczny kontener przeznaczony do wdrażania zasobów platformy Azure i zarządzania nimi w formie grupy.

Poniższy przykład tworzy grupę zasobów o określonej nazwie i w określonej lokalizacji.

New-AzResourceGroup -Name <your-resource-group-name> -Location <your-resource-group-location>

Tworzenie nowej usługi bota

Aby utworzyć nową usługę bota dla bota, użyj polecenia cmdlet New-AzBotService . Poniższy przykład tworzy nową usługę bota z określonymi wartościami.

New-AzBotService -ResourceGroupName <your-resource-group-name> -Name <your-bot-handle> -ApplicationId <your-app-registration-id> -Location <your-bot-service-location> -Sku S1 -Description "<your-bot-description>" -Webapp

Aby pobrać stan usługi bota, użyj polecenia cmdlet Get-AzBotService . Poniższy przykład pobiera listę wszystkich zasobów w określonej grupie zasobów.

Get-AzBotService -ResourceGroupName <your-resource-group-name>

Inicjowanie folderu projektu

Aby zainicjować folder pliku projektu, należy użyć polecenia cmdlet Initialize-AzBotServicePrepareDeploy . Poniższy przykład inicjuje określony plik w określonym folderze.

Initialize-AzBotServicePrepareDeploy -CodeDir C:\tmp\MyEchoBot -ProjFileName MyEchoBot.csproj

Publikowanie usługi bota na platformie Azure

Aby opublikować usługę bota na platformie Azure, użyj polecenia cmdlet Publish-AzBotServiceApp . Poniższy przykład publikuje określoną usługę bota na platformie Azure.

Publish-AzBotServiceApp -ResourceGroupName myResourceGroup -CodeDir D:\tmp\MyEchoBot -Name MyEchoBot

Pobieranie kodu

Aby pobrać kod, aby pracować nad nim lokalnie, użyj polecenia cmdlet Export-AzBotServiceApp . Poniższy przykład pobiera kod dla określonej aplikacji usługi bot service w określonej grupie zasobów.

Export-AzBotServiceApp -ResourceGroupName myResourceGroup -Name MyEchoBot

Czyszczenie zasobów

Jeśli zasoby utworzone w tym artykule nie są potrzebne, możesz je usunąć, uruchamiając następujące przykłady.

Usuwanie usługi Bot Service

Aby usunąć usługę Bot Service z grupy zasobów, użyj polecenia cmdlet Remove-AzBotService . Poniższy przykład usuwa usługę bota z określonej grupy zasobów.

Remove-AzBotService -Name MyEchoBot -ResourceGroupName myResourceGroup

Usuwanie grupy zasobów

Uwaga

Poniższy przykład usuwa określoną grupę zasobów i wszystkie zawarte w niej zasoby. Jeśli zasoby spoza zakresu tego artykułu istnieją w określonej grupie zasobów, zostaną również usunięte.

Remove-AzResourceGroup -Name myResourceGroup

Następne kroki

Po pobraniu kodu możesz kontynuować tworzenie bota lokalnie na maszynie. Gdy przetestujesz bota i wszystko będzie gotowe do przekazania kodu bota do witryny Azure Portal, postępuj zgodnie z instrukcjami wymienionymi w sekcji Konfigurowanie tematu ciągłego wdrażania , aby automatycznie aktualizować kod po wprowadzeniu zmian.