Condividi tramite

Usare l'interfaccia della riga di comando di Azure per creare o aggiornare una risorsa di Azure Bot

  • Articolo

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.

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 file dei parametri JSON

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 Descrizione
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.