Condividi tramite


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.

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#, JavaScript e Python. Questi tipi di app non sono supportati negli altri linguaggi o in Bot Framework Composer, Bot Framework Emulator o Dev Tunnels.

Tipo di app Supporto tecnico
Identità gestita assegnata dall'utente Azure AI servizio Bot e gli SDK C#, JavaScript e Python
Tenant singolo Azure AI servizio Bot e gli SDK C#, JavaScript e Python
Multi-tenant Azure AI servizio Bot, tutti i linguaggi di Bot Framework SDK, Composer, emulatore e dev tunnel

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.

  1. Vai al portale di Azure.

  2. Nel riquadro destro selezionare Crea una risorsa.

  3. Nella casella di ricerca immettere bot, quindi premere INVIO.

  4. Selezionare la scheda Azure Bot .

    Selezionare la risorsa azure bot

  5. Seleziona Crea.

  6. Immettere i valori nei campi obbligatori ed esaminare e aggiornare le impostazioni.

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

      Impostazioni dei dettagli del progetto per una risorsa di Azure Bot

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

      Impostazioni dell'ID app Microsoft per una risorsa di Azure Bot

  7. Selezionare Rivedi e crea.

  8. Se la convalida viene superata, selezionare Crea.

  9. Al termine della distribuzione selezionare Vai al gruppo di risorse. Il bot e le risorse correlate verranno visualizzati nel gruppo di risorse selezionato.

  10. Se Bot Framework SDK non è già disponibile, selezionare Scarica da GitHub per informazioni su come usare i pacchetti per il linguaggio preferito.

    Creare bot in SDK

È 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

La versione Java di Bot Framework SDK supporta solo bot multi-tenant. Le versioni C#, JavaScript e Python 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 tutti e tre i tipi di applicazione per la gestione dell'identità del bot.

Le informazioni sull'identità da aggiungere dipendono dal tipo di applicazione del bot. Specificare i valori seguenti nel file di configurazione.

Disponibile per bot C#, JavaScript e Python.

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:

  1. Passare al pannello servizio app per l'app Web del bot.
  2. In Impostazioni selezionare Identità.
  3. Nel pannello Identità selezionare la scheda Assegnata dall'utente e Aggiungi (+).
  4. Nel pannello Aggiungi identità gestita assegnata dall'utente:
    1. Selezionare la propria sottoscrizione.

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

    3. Selezionare Aggiungi per usare questa identità per il bot.

      Pannello servizio app Identità con l'identità gestita per il bot selezionato.

Per ottenere l'ID dell'app o del tenant

Per ottenere l'ID tenant o l'app del bot:

  1. Passare al pannello delle risorse di Azure Bot per il bot.
  2. 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:

  1. Passare al pannello delle risorse di Azure Bot per il bot.
  2. Passare al pannello Configurazione del bot.
  3. Selezionare Gestisci, accanto a ID app Microsoft, per passare al pannello Certificati e segreti per il servizio app.
  4. Seguire le istruzioni nel pannello per creare un nuovo segreto client e registrare il valore in un luogo sicuro.

Informazioni aggiuntive

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

Passaggi successivi