Usare l'interfaccia della riga di comando di Azure per creare o aggiornare una risorsa di Azure Bot
SI APPLICA A: SDK v4
Questo articolo descrive come creare o aggiornare una risorsa di Azure Bot con l'interfaccia della riga di comando di Azure e un modello di Azure Resource Manager .This article describe how to create or update an Azure Bot resource with the Azure CLI and an Azure Resource Manager template (ARM template).
Questo è parte del processo più ampio per il provisioning e la pubblicazione di un bot.
- Per informazioni sul processo completo, vedere Effettuare il provisioning e pubblicare un bot.
- Per informazioni su come creare una risorsa servizio app, vedere Usare l'interfaccia della riga di comando di Azure per creare una risorsa servizio app.
- Per istruzioni su come usare il portale di Azure, vedere l'argomento di avvio rapido Creare una risorsa di Azure Bot.
Nota
Gli SDK JavaScript, C# e Python di Bot Framework continueranno a essere supportati, ma Java SDK verrà ritirato con il supporto finale a lungo termine che termina a novembre 2023.
I bot esistenti creati con Java SDK continueranno a funzionare.
Per la creazione di nuovi bot, è consigliabile usare Microsoft Copilot Studio e leggere le informazioni sulla scelta della soluzione copilota appropriata.
Per altre informazioni, vedere Il futuro della compilazione di bot.
Prerequisiti
Per usare l'interfaccia della riga di comando di Azure per effettuare il provisioning e la pubblicazione di bot, è necessario:
Un account Azure con una sottoscrizione attiva. Creare un account gratuito.
Installazione dell'interfaccia della riga di comando di Azure.
Per il linguaggio di programmazione, usare la versione seguente dell'interfaccia della riga di comando di Azure. Alcuni passaggi non funzioneranno con le versioni successive dell'interfaccia della riga di comando.
Lingua Versione dell'interfaccia della riga di comando C# e JavaScript 2.39.0 o versione successiva Python 2.55.0 o versione successiva Java 2.29.2
Questo processo usa un modello di Azure Resource Manager per creare una risorsa azure Bot per il bot.
Se i modelli correnti non sono disponibili, creare una copia nel progetto bot della cartella deploymentTemplates : C#, JavaScript, Python o Java.
Suggerimento
Questo è parte del processo più ampio per il provisioning e la pubblicazione di un bot. Per un elenco completo dei prerequisiti, vedere Come effettuare il provisioning e pubblicare un bot .
Modificare il file dei parametri
Modificare il file di parametri per il modello di Resource Manager in modo che contenga i valori da usare.
Importante
È necessario usare gli stessi appType valori e appId quando si creano le risorse servizio app e Azure Bot.
Se il progetto non contiene ancora i file di parametri e del modello arm più recenti, è possibile copiarli dal repository di Bot Framework SDK per il linguaggio: C#, JavaScript, Python o Java.
Questa tabella descrive i parametri di distribuzione nel file dei parametri, da usare con l'opzione di parameters comando .
Per impostazione predefinita, il nome del file dei parametri è parameters-for-template-AzureBot-with-rg.json.
| Parametro | Tipo | Descrzione |
|---|---|---|
azureBotId |
Stringa | Obbligatorio. Handle univoco e non modificabile a livello globale per il bot, ad esempio ContosoCustomerService. |
azureBotSku |
String | Facoltativo. SKU della risorsa Azure Bot. Valori consentiti: "F0" (gratuito) e "S1" (standard). Il valore predefinito è "S1". |
azureBotRegion |
String | Facoltativo. Posizione del bot di Azure. Valori consentiti: "global", "westeurope", "westus" e "centralindia". Il valore predefinito è "global". |
botEndpoint |
String | Facoltativo. Endpoint di messaggistica per il bot, ad esempio https://<appServiceName>.azurewebsites.net/api/messages. |
appType |
Stringa | Obbligatorio. Modalità di gestione delle identità delle risorse del bot. I valori consentiti sono: "MultiTenant", "SingleTenant" e "UserAssignedMSI". Il valore predefinito è "MultiTenant". |
appId |
Stringa | Obbligatorio. ID client o ID app della risorsa di identità creata in precedenza. Si tratta dell'ID app Microsoft del servizio app. |
UMSIName |
String | Facoltativo. Per i tipi di app di identità gestite assegnate dall'utente, il nome della risorsa di identità. |
UMSIResourceGroupName |
String | Facoltativo. Per i tipi di app di identità gestite assegnate dall'utente, il gruppo di risorse per la risorsa di identità. |
tenantId |
String | Facoltativo. Per le identità gestite assegnate dall'utente e i tipi di app a tenant singolo, l'ID tenant di Microsoft Entra ID per la risorsa di identità. |
Suggerimento
L'endpoint di messaggistica del bot deve essere impostato prima che un bot pubblicato possa ricevere messaggi.
Non tutti i parametri si applicano a tutti i tipi di app.
Specificare i valori per UMSIName, UMSIResourceGroupNamee tenantId.
Creare la risorsa di Azure Bot
Per creare la risorsa Azure Bot per il bot, usare il comando seguente.
az deployment group create --resource-group <resource-group> --template-file <template-file-path> --parameters "@<parameters-file-path>"
| Opzione | Descrizione |
|---|---|
| resource-group | Nome del gruppo di risorse di Azure in cui creare il servizio app. |
| template-file | Percorso del modello di Resource Manager per il servizio app. Il percorso può essere relativo o assoluto. |
| parameters | Percorso del file dei parametri da usare con il modello di Resource Manager. Il percorso può essere relativo o assoluto. |
Per i progetti creati con i generatori più recenti, il modello di Resource Manager e i file di parametri si trovano nella cartella DeploymentTemplates\DeployUseExistResourceGroup all'interno del progetto. I nomi di file predefiniti sono template-AzureBot-with-rg.json e parameters-for-template-AzureBot-with-rg.json.
Per aggiornare la risorsa di Azure Bot
Per aggiungere o aggiornare l'endpoint di messaggistica per Azure Bot, usare il comando seguente.
az bot update --resource-group <resource group> --name <azureBotId> --endpoint <messaging-endpoint>
| Opzione | Descrizione |
|---|---|
| resource-group | Nome del gruppo di risorse di Azure che contiene il servizio app. |
| name | Handle univoco e non modificabile a livello globale per il bot. |
| endpoint | Endpoint di messaggistica per il bot, ad esempio https://<appServiceName>.azurewebsites.net/api/messages. |
Informazioni aggiuntive
Per altre informazioni sui modelli di Resource Manager, vedere Che cosa sono i modelli di Resource Manager e Come usare i modelli di distribuzione di Azure Resource Manager con l'interfaccia della riga di comando di Azure.
Passaggi successivi
Se il servizio app è stato creato come parte di una distribuzione di bot, vedere Creare risorse con i modelli di Resource Manager per continuare il processo.