Een bot maken en publiceren met Azure PowerShell

Artikel
10/27/2023

VAN TOEPASSING OP: SDK v4

In dit artikel leest u hoe u Azure PowerShell gebruikt om een bot te maken en deze te registreren bij Azure met behulp van een bestaande registratie van de Microsoft Entra ID-toepassing.

Gebruik een Azure Bot-resource om uw bot te hosten. U maakt en ontwikkelt uw bot lokaal en host deze op Azure of een ander platform. Volg de stappen die worden beschreven in het registreren van een bot bij Azure. Wanneer u uw bot registreert, geeft u het webadres op waar uw bot wordt gehost. U kunt deze nog steeds hosten in Azure.

U kunt deze opdrachten lokaal uitvoeren met behulp van Azure PowerShell of extern via Azure Portal, met behulp van Azure CloudShell. Zie het overzicht van Azure Cloud Shell voor meer informatie over Azure CloudShell.

Belangrijk

Hoewel de PowerShell-module Az.BotService in preview is, moet u deze afzonderlijk installeren met behulp van de Install-Module cmdlet.

Het maken van een bot met Azure AI Bot Service en het lokaal maken van een bot zijn onafhankelijke, parallelle manieren om een bot te maken.

Vereisten

Als u geen Azure-abonnement hebt, maakt u een gratis account voordat u begint.
Een bestaande Microsoft Entra ID-toepassingsregistratie die kan worden gebruikt vanuit elke Microsoft Entra ID-tenant.
- Als u deze quickstart wilt voltooien, hebt u de app-id en het geheim nodig voor de registratie van de toepassing.
Installeer de PowerShell-module. Dit is vereist omdat de Az.BotService-module in preview is.
```
Install-Module -Name Az.BotService -AllowClobber
```
Als u ervoor kiest om Azure PowerShell lokaal te gebruiken:
- Maak verbinding met uw Azure-account met de cmdlet Connect-AzAccount.

Kies uw abonnement

Als u meerdere Azure-abonnementen hebt, kiest u het juiste abonnement waarin de resource moet worden gefactureerd.

Gebruik de cmdlet Get-AzSubscription om de abonnementen weer te geven die u kunt openen.
```
Get-AzSubscription
```
Stel het specifieke abonnement in met behulp van de cmdlet Set-AzContext .

U moet hetzelfde abonnement voor uw bot gebruiken als voor de registratie van de toepassing.
```
Set-AzContext -SubscriptionId "<your-subscription-name-or-id>"
```

Een brongroep maken

Als u nog geen Azure-resourcegroep hebt die u wilt gebruiken voor uw bot, maakt u een nieuwe met behulp van de cmdlet New-AzResourceGroup.

Een resourcegroep is een logische container waarin Azure-resources worden geïmplementeerd en groepsgewijs worden beheerd.

In het volgende voorbeeld wordt een resourcegroep gemaakt met de opgegeven naam en op de opgegeven locatie.

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

Een nieuwe botservice maken

Als u een nieuwe botservice voor uw bot wilt maken, gebruikt u de cmdlet New-AzBotService . In het volgende voorbeeld wordt een nieuwe botservice met de opgegeven waarden gemaakt.

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

Als u de status van een botservice wilt ophalen, gebruikt u de Cmdlet Get-AzBotService . In het volgende voorbeeld wordt een lijst met alle resources in de opgegeven resourcegroep weergegeven.

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

Projectmap initialiseren

Als u de projectbestandsmap wilt initialiseren, gebruikt u de cmdlet Initialize-AzBotServicePrepareDeploy . In het volgende voorbeeld wordt het opgegeven bestand in de opgegeven map geïnitialiseerd.

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

Bot-service publiceren naar Azure

Als u uw botservice naar Azure wilt publiceren, gebruikt u de cmdlet Publish-AzBotServiceApp . In het volgende voorbeeld wordt de opgegeven botservice gepubliceerd naar Azure.

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

Code downloaden

Als u de code wilt downloaden om er lokaal aan te werken, gebruikt u de cmdlet Export-AzBotServiceApp . In het volgende voorbeeld wordt de code voor de opgegeven botservice-app in de opgegeven resourcegroep gedownload.

Export-AzBotServiceApp -ResourceGroupName myResourceGroup -Name MyEchoBot

Resources opschonen

Als de resources die in dit artikel zijn gemaakt, niet meer nodig zijn, kunt u ze verwijderen door het volgende voorbeeld uit te voeren.

De Bot Service verwijderen

Als u de Bot Service uit de resourcegroep wilt verwijderen, gebruikt u de cmdlet Remove-AzBotService . In het volgende voorbeeld wordt de botservice uit de opgegeven resourcegroep verwijderd.

Remove-AzBotService -Name MyEchoBot -ResourceGroupName myResourceGroup

De resourcegroep verwijderen

Let op

In het volgende voorbeeld worden de opgegeven resourcegroep en alle resources erin verwijderd. Als resources buiten het bereik van dit artikel aanwezig zijn in de opgegeven resourcegroep, worden ze ook verwijderd.

Remove-AzResourceGroup -Name myResourceGroup

Volgende stappen

Nadat u de code hebt gedownload, kunt u de bot lokaal op uw computer blijven ontwikkelen. Nadat u uw bot hebt getest en klaar bent om de botcode te uploaden naar Azure Portal, volgt u de instructies in het onderwerp Continue implementatie om code automatisch bij te werken nadat u wijzigingen hebt aangebracht.

Delen via