Usare l'interfaccia della riga di comando di Azure per creare una risorsa servizio app

  • Articolo

SI APPLICA A: SDK v4

Questo articolo descrive come creare una risorsa servizio app con l'interfaccia della riga di comando di Azure e un modello di Azure Resource Manager come parte del processo di provisioning e pubblicazione di un bot. Il servizio app viene talvolta definito app Web.

Importante

I bot Python non possono essere distribuiti in un gruppo di risorse che contiene servizi o bot Di Windows. È possibile distribuire più bot Python nello stesso gruppo di risorse; Tuttavia, è necessario creare altri servizi (ad esempio i servizi di intelligenza artificiale di Azure) in un altro gruppo di risorse.

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, prendere in considerazione l'uso di Power Virtual Agents e leggere la scelta della soluzione chatbot 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 servizio app 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 lo stesso appType valore per 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-BotApp-with-rg.json.

Parametro Tipo Descrzione
appServiceName Stringa Obbligatorio. Nome univoco globale del servizio app.
existingAppServicePlanName String Facoltativo. Nome di un piano di servizio app esistente con cui creare il servizio app per il bot.
existingAppServicePlanLocation String Facoltativo. Posizione del piano di servizio app esistente .
newAppServicePlanName String Facoltativo. Nome del nuovo piano di servizio app.
newAppServicePlanLocation String Facoltativo. Posizione del nuovo piano di servizio app.
newAppServicePlanSku Oggetto Facoltativo. SKU per il nuovo piano di servizio app. Il valore predefinito è il piano di servizio S1 (Standard).
appType Stringa Obbligatorio. Modalità di gestione delle identità delle risorse del bot. Valori consentiti: "MultiTenant", "SingleTenant" e "UserAssignedMSI". Il valore predefinito è "MultiTenant".
appId Stringa Obbligatorio. ID client o ID app della risorsa di identità creata in precedenza. Viene usato come ID app Microsoft del servizio app.
appSecret String Facoltativo. Per i tipi di app a tenant singolo e multi-tenant, la password per la risorsa di identità.
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à.

Non tutti i parametri si applicano a tutti i tipi di app.

  • Specificare i valori per UMSIName, UMSIResourceGroupNamee tenantId.
  • Lasciare appSecret vuoto.

Alcuni parametri sono specifici dell'uso di un piano di servizio app esistente o nuovo.

  • Specificare i valori per existingAppServicePlanName e existingAppServicePlanLocation.
  • Lasciare newAppServicePlanNamevuoto , newAppServicePlanLocatione newAppServicePlanSku .

Creare il servizio app

Creare il servizio app per il bot.

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-BotApp-with-rg.json e parameters-for-template-BotApp-with-rg.json.

Suggerimento

  • L'URL di base per il servizio app si basa sul nome del servizio app: https:<app-service-name>.azurewebsites.net.
  • L'endpoint di messaggistica per il bot sarà l'URL di base più /api/messages, ad esempio https:<app-service-name>.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.