Usare il portale di Azure per creare una risorsa di Azure Bot
SI APPLICA A: SDK v4
La risorsa Azure Bot (risorsa bot) consente di registrare il bot con l'servizio Bot di intelligenza artificiale di Azure e di connettere il bot ai canali. È possibile creare, connettere e gestire bot per interagire con gli utenti ovunque si trovino, dall'app o dal sito Web a Teams, Messenger e molti altri canali.
Questo articolo descrive come creare una risorsa bot tramite il portale di Azure.
- Per informazioni su come creare un bot, vedere l'argomento di avvio rapido Creare un bot con Bot Framework SDK .
- Per informazioni su come effettuare il provisioning e pubblicare un bot in Azure, vedere Come distribuire il bot in Azure.
Gestione delle risorse
Quando si crea una risorsa bot, Azure crea le risorse associate. Alcune delle risorse create dipendono da come si decide di gestire l'identità del bot.
L'identità del bot può essere gestita in Azure in diversi modi.
- Come identità gestita assegnata dall'utente, in modo che non sia necessario gestire manualmente le credenziali del bot.
- Come app a tenant singolo.
- Come app multi-tenant.
Il supporto per l'identità gestita assegnata dall'utente e i tipi di app a tenant singolo è stato aggiunto a Bot Framework SDK per C# e JavaScript nella versione 4.15.0. Questi tipi di app non sono supportati negli altri linguaggi o in Bot Framework Composer, Bot Framework Emulator o ngrok.
| Tipo di app | Supporto |
|---|---|
| Identità gestita assegnata dall'utente | Azure AI servizio Bot e gli SDK C# e JavaScript |
| Tenant singolo | Azure AI servizio Bot e gli SDK C# e JavaScript |
| Multi-tenant | Azure AI servizio Bot, tutti i linguaggi di Bot Framework SDK, Composer, emulatore e ngrok |
Prerequisiti
- Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.
- Bot Framework SDK per C# o JavaScript versione 4.15.0 o successiva per i bot gestiti assegnati dall'utente e a tenant singolo.
Creare la risorsa
Creare la risorsa Azure Bot, che consentirà di registrare il bot con l'servizio Bot di intelligenza artificiale di Azure.
Suggerimento
Non è possibile creare nuove risorse di registrazione per bot e canali bot. Tuttavia, le risorse esistenti configurate e distribuite continueranno a funzionare. I bot creati da un modello VSIX o Yeoman dall'SDK versione 4.14.1.2 o successiva contengono modelli arm che genereranno una risorsa di Azure Bot.
Vai al portale di Azure.
Nel riquadro destro selezionare Crea una risorsa.
Nella casella di ricerca immettere
bot, quindi premere INVIO.Selezionare la scheda Azure Bot .
Seleziona Crea.
Immettere i valori nei campi obbligatori ed esaminare e aggiornare le impostazioni.
Fornire informazioni in Dettagli progetto. Selezionare se il bot avrà la residenza dei dati globale o locale. Attualmente, la funzionalità di residenza dei dati locali è disponibile per le risorse nell'area "westeurope" e "centralindia". Per altre informazioni, vedere Regionalizzazione in Azure AI servizio Bot.
Specificare le informazioni in ID app Microsoft. Selezionare la modalità di gestione dell'identità del bot in Azure e se creare una nuova identità o usarne una esistente.
Selezionare Rivedi e crea.
Se la convalida viene superata, selezionare Crea.
Al termine della distribuzione, selezionare Vai alla risorsa. Il bot e le risorse correlate verranno visualizzati nel gruppo di risorse selezionato.
Se Bot Framework SDK non è già disponibile, selezionare Scarica da GitHub per informazioni su come usare i pacchetti per il linguaggio preferito.
È ora possibile creare il bot con Bot Framework SDK.
Suggerimento
Quando Azure crea una nuova risorsa Azure Bot a tenant singolo o multi-tenant con un nuovo ID app, genera anche una password.
Informazioni sull'identità del bot
Seguire questa procedura per aggiungere informazioni sull'identità al file di configurazione del bot. Il file varia a seconda del linguaggio di programmazione usato per creare il bot.
Importante
Le versioni Java e Python di Bot Framework SDK supportano solo bot multi-tenant. Le versioni C# e JavaScript supportano tutti e tre i tipi di applicazione per la gestione dell'identità del bot.
| Lingua | File name | Note |
|---|---|---|
| C# | appsettings.json | Supporta tutti e tre i tipi di applicazione per la gestione dell'identità del bot. |
| JavaScript | .env | Supporta tutti e tre i tipi di applicazione per la gestione dell'identità del bot. |
| Java | application.properties | Supporta solo bot multi-tenant. |
| Python | config.py | Supporta solo bot multi-tenant. Specificare le proprietà identity come argomenti per le chiamate al os.environ.get metodo. |
Le informazioni sull'identità da aggiungere dipendono dal tipo di applicazione del bot. Specificare i valori seguenti nel file di configurazione.
Disponibile solo per i bot C# e JavaScript.
| Proprietà | valore |
|---|---|
MicrosoftAppType |
UserAssignedMSI |
MicrosoftAppId |
ID client dell'identità gestita assegnata dall'utente. |
MicrosoftAppPassword |
Non applicabile. Lasciare vuoto questo campo per un bot di identità gestita assegnato dall'utente. |
MicrosoftAppTenantId |
ID tenant dell'identità gestita assegnata dall'utente. |
Per aggiornare il servizio app
Se si dispone di una risorsa di servizio app esistente (app Web) per il bot e il bot è un'applicazione di identità gestita assegnata dall'utente, potrebbe essere necessario aggiornare il servizio app del bot:
- Passare al pannello servizio app per l'app Web del bot.
- In Impostazioni selezionare Identità.
- Nel pannello Identità selezionare la scheda Assegnata dall'utente e Aggiungi (+).
- Nel pannello Aggiungi identità gestita assegnata dall'utente:
Selezionare la propria sottoscrizione.
Per Identità gestite assegnate dall'utente selezionare l'identità gestita per il bot. Se l'identità gestita è stata generata automaticamente, avrà lo stesso nome del bot.
Selezionare Aggiungi per usare questa identità per il bot.
Per ottenere l'ID dell'app o del tenant
Per ottenere l'ID tenant o l'app del bot:
- Passare al pannello delle risorse di Azure Bot per il bot.
- Passare al pannello Configurazione del bot. Da questo pannello è possibile copiare l'ID app Microsoft del bot o l'ID tenant dell'app.
Per generare una nuova password
I bot a tenant singolo e multi-tenant hanno un segreto dell'app o una password necessari per alcune operazioni. Azure AI servizio Bot nasconde il segreto del bot. Tuttavia, il proprietario della risorsa servizio app del bot può generare una nuova password:
- Passare al pannello delle risorse di Azure Bot per il bot.
- Passare al pannello Configurazione del bot.
- Selezionare Gestisci, accanto a ID app Microsoft, per passare al pannello Certificati e segreti per il servizio app.
- Seguire le istruzioni nel pannello per creare un nuovo segreto client e registrare il valore in un luogo sicuro.
Informazioni aggiuntive
- Per informazioni sulla gestione delle identità con Microsoft Entra ID, vedere Che cos'è Microsoft Entra ID?.
- Per informazioni sui piani di app Azure Service e servizio app, vedere la panoramica servizio app.
- Per informazioni sulle risorse di Azure e su come vengono gestite in generale, vedere panoramica di Azure Resource Manager.
Nota
Bot Framework Composer e Bot Framework Emulator supportano attualmente solo bot multi-tenant. Bot Framework SDK per C# o JavaScript versione 4.15.0 o successiva è necessario per le identità gestite assegnate dall'utente e per i bot a tenant singolo.
Supporto delle competenze
Alcuni tipi di consumer di competenze non sono in grado di usare alcuni tipi di bot di competenza. Nella tabella seguente vengono descritte le combinazioni supportate.
| Competenza multi-tenant | Competenza a tenant singolo | Competenza identità gestita assegnata dall'utente | |
|---|---|---|---|
| Consumer multi-tenant | Supportata | Non supportato | Non supportato |
| Consumer a tenant singolo | Non supportato | Supportato se entrambe le app appartengono allo stesso tenant | Supportato se entrambe le app appartengono allo stesso tenant |
| Consumer dell'identità gestita assegnata dall'utente | Non supportato | Supportato se entrambe le app appartengono allo stesso tenant | Supportato se entrambe le app appartengono allo stesso tenant |
Per informazioni su come configurare una competenza o un consumer di competenze, vedere Implementare una competenza o Implementare un consumer di competenze.