Creare e pubblicare un bot con Azure PowerShell

2024-10-09

SI APPLICA A: SDK v4

Questo articolo illustra come usare Azure PowerShell per creare un bot e registrarlo in Azure usando una registrazione dell'applicazione Microsoft Entra ID esistente.

Usare una risorsa di Azure Bot per ospitare il bot. Si creerà e si svilupperà il bot in locale e lo si ospiterà in Azure o in una piattaforma diversa. Seguire i passaggi descritti in Come registrare un bot con Azure. Quando si registra il bot, si specifica l'indirizzo Web in cui è ospitato il bot. È comunque possibile ospitarlo in Azure.

È possibile eseguire questi comandi in locale, usando Azure PowerShell o in remoto tramite il portale di Azure, usando Azure CloudShell. Per altre informazioni su Azure CloudShell, vedere Panoramica di Azure Cloud Shell.

Importante

Anche se il modulo PowerShell Az.BotService è in anteprima, è necessario installarlo separatamente usando il Install-Module cmdlet .

La creazione di un bot con azure per intelligenza artificiale servizio Bot e la creazione di un bot in locale sono modi indipendenti e paralleli per creare un bot.

Prerequisiti

Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.
Registrazione dell'applicazione Microsoft Entra ID esistente che può essere usata da qualsiasi tenant di Microsoft Entra ID.
- Per completare questa guida introduttiva, sono necessari l'ID app e il segreto per la registrazione dell'applicazione.
Installare il modulo Az di PowerShell. Questa operazione è necessaria perché il modulo Az.BotService è in anteprima.
```
Install-Module -Name Az.BotService -AllowClobber
```
Se si sceglie di usare Azure PowerShell in locale:
- Connettersi all'account Azure con il cmdlet Connect-AzAccount.

Scegliere la sottoscrizione in uso

Se si possiedono più sottoscrizioni di Azure, scegliere quella appropriata in cui verranno fatturate le risorse.

Per elencare le sottoscrizioni a cui è possibile accedere, usare il cmdlet Get-AzSubscription .
```
Get-AzSubscription
```
Impostare la sottoscrizione specifica usando il cmdlet Set-AzContext .

È consigliabile usare la stessa sottoscrizione per il bot come per la registrazione dell'applicazione.
```
Set-AzContext -SubscriptionId "<your-subscription-name-or-id>"
```

Creare un gruppo di risorse

Se non si ha già un gruppo di risorse di Azure che si vuole usare per il bot, crearne uno nuovo usando il cmdlet New-AzResourceGroup .

Un gruppo di risorse è un contenitore logico in cui le risorse di Azure vengono distribuite e gestite come gruppo.

L'esempio seguente crea un gruppo di risorse con il nome specificato e nella posizione specificata.

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

Creare un nuovo servizio bot

Per creare un nuovo servizio bot per il bot, usare il cmdlet New-AzBotService . L'esempio seguente crea un nuovo servizio bot con i valori specificati.

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

Per recuperare lo stato di un servizio bot, usare il cmdlet Get-AzBotService . Nell'esempio seguente viene visualizzato un elenco di tutte le risorse nel gruppo di risorse specificato.

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

Inizializzare la cartella del progetto

Per inizializzare la cartella del file di progetto, usare il cmdlet Initialize-AzBotServicePrepareDeploy . Nell'esempio seguente viene inizializzato il file specificato nella cartella specificata.

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

Pubblicare il servizio bot in Azure

Per pubblicare il servizio bot in Azure, usare il cmdlet Publish-AzBotServiceApp . L'esempio seguente pubblica il servizio bot specificato in Azure.

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

Scaricare il codice

Per scaricare il codice per usarlo in locale, usare il cmdlet Export-AzBotServiceApp . L'esempio seguente scarica il codice per l'app del servizio bot specificata nel gruppo di risorse specificato.

Export-AzBotServiceApp -ResourceGroupName myResourceGroup -Name MyEchoBot

Pulire le risorse

Se le risorse create in questo articolo non sono più necessarie, è possibile eliminarle usando gli esempi seguenti.

Eliminare il servizio Bot

Per eliminare il servizio Bot dal gruppo di risorse, usare il cmdlet Remove-AzBotService. L'esempio seguente elimina il servizio bot dal gruppo di risorse specificato.

Remove-AzBotService -Name MyEchoBot -ResourceGroupName myResourceGroup

Eliminare il gruppo di risorse

Attenzione

L'esempio seguente elimina il gruppo di risorse specificato e tutte le risorse al suo interno. Se le risorse esterne all'ambito di questo articolo sono presenti nel gruppo di risorse specificato, verranno eliminate anche.

Remove-AzResourceGroup -Name myResourceGroup

Passaggi successivi

Dopo aver scaricato il codice, è possibile continuare a sviluppare il bot localmente nel computer. Dopo aver testato il bot e aver completato il caricamento del codice del bot nel portale di Azure, seguire le istruzioni elencate in Configurare la distribuzione continua per aggiornare automaticamente il codice dopo aver apportato le modifiche.

Condividi tramite