Configurare un bot in Microsoft Azure gestito da 21Vianet

Articolo
09/26/2024

Questa guida aiuta i clienti di Microsoft Azure a distribuire Bot Framework e bot di azure per intelligenza artificiale servizio Bot nella piattaforma Microsoft Azure gestita da 21Vianet.

Prerequisiti

Un account in Microsoft Azure.
Progetto bot C# o JavaScript da configurare.
Bot Framework SDK versione 4.14 o successiva.

Usare l'adattatore cloud

Assicurarsi che il bot usi l'adattatore cloud o un adattatore che deriva dall'adattatore cloud. L'adattatore cloud consente di specificare impostazioni specifiche per Microsoft Azure Cloud.

C#
JavaScript

La ConfigurationBotFrameworkAuthentication classe legge le impostazioni di autenticazione dal file di configurazione del bot. Al momento della creazione, l'adattatore cloud usa queste impostazioni di autenticazione.

Assicurarsi che il ConfigureServices metodo nel file Startup.cs contenga questa riga.

services.AddSingleton<BotFrameworkAuthentication, ConfigurationBotFrameworkAuthentication>();

Il ConfigurationBotFrameworkAuthentication costruttore legge le impostazioni di autenticazione dal file di configurazione del bot.

Nel file index.js il codice per creare l'adattatore dovrebbe essere simile al seguente:

const botFrameworkAuthentication = new ConfigurationBotFrameworkAuthentication(process.env);

const adapter = new CloudAdapter(botFrameworkAuthentication);

Configurare userAssignedMSI/SingleTenant Bot

Per garantire che il bot funzioni correttamente nel cloud di Microsoft Azure, sono necessarie impostazioni di autenticazione aggiuntive. Sostituire "App-Tenant-ID" con l'ID tenant del bot.

C#
JavaScript

Aggiungere le impostazioni seguenti al file appsettings.json .

"OAuthUrl": "https://token.botframework.azure.cn/", 
"ToChannelFromBotLoginUrl": "https://login.partner.microsoftonline.cn/<App-Tenant-ID>",
"ToChannelFromBotOAuthScope": "https://api.botframework.azure.cn",
"ToBotFromChannelTokenIssuer": "https://api.botframework.azure.cn",
"ToBotFromChannelOpenIdMetadataUrl": "https://login.botframework.azure.cn/v1/.well-known/openidconfiguration",
"ToBotFromEmulatorOpenIdMetadataUrl": "https://login.partner.microsoftonline.cn/a55a4d5b-9241-49b1-b4ff-befa8db00269/v2.0/.well-known/openid-configuration",
"ValidateAuthority": true

Aggiungere le impostazioni seguenti al file con estensione env .

OAuthUrl=https://token.botframework.azure.cn/, 
ToChannelFromBotLoginUrl=https://login.partner.microsoftonline.cn/<App-Tenant-Id>,
ToChannelFromBotOAuthScope=https://api.botframework.azure.cn,
ToBotFromChannelTokenIssuer=https://api.botframework.azure.cn,
ToBotFromChannelOpenIdMetadataUrl=https://login.botframework.azure.cn/v1/.well-known/openidconfiguration,
ToBotFromEmulatorOpenIdMetadataUrl=https://login.partner.microsoftonline.cn/a55a4d5b-9241-49b1-b4ff-befa8db00269/v2.0/.well-known/openid-configuration,
ValidateAuthority=true

Configurare un bot multi-tenant

Per il bot multi-tenant, usare le impostazioni seguenti.

C#
JavaScript

Aggiungere le impostazioni seguenti al file appsettings.json .

"OAuthUrl": "https://token.botframework.azure.cn/", 
"ToChannelFromBotLoginUrl": "https://login.partner.microsoftonline.cn/microsoftservices.partner.onmschina.cn",
"ToChannelFromBotOAuthScope": "https://api.botframework.azure.cn",
"ToBotFromChannelTokenIssuer": "https://api.botframework.azure.cn",
"ToBotFromChannelOpenIdMetadataUrl": "https://login.botframework.azure.cn/v1/.well-known/openidconfiguration",
"ToBotFromEmulatorOpenIdMetadataUrl": "https://login.partner.microsoftonline.cn/a55a4d5b-9241-49b1-b4ff-befa8db00269/v2.0/.well-known/openid-configuration",
"ValidateAuthority": true

Aggiungere le impostazioni seguenti al file con estensione env .

OAuthUrl=https://token.botframework.azure.cn/, 
ToChannelFromBotLoginUrl=https://login.partner.microsoftonline.cn/microsoftservices.partner.onmschina.cn,
ToChannelFromBotOAuthScope=https://api.botframework.azure.cn,
ToBotFromChannelTokenIssuer=https://api.botframework.azure.cn,
ToBotFromChannelOpenIdMetadataUrl=https://login.botframework.azure.cn/v1/.well-known/openidconfiguration,
ToBotFromEmulatorOpenIdMetadataUrl=https://login.partner.microsoftonline.cn/a55a4d5b-9241-49b1-b4ff-befa8db00269/v2.0/.well-known/openid-configuration,
ValidateAuthority=true

Aggiungere l'autenticazione utente al bot

Il bot può usare vari provider di identità per accedere alle risorse per conto di un utente, ad esempio Microsoft Entra ID e molti altri provider OAuth.

Microsoft Azure Cloud usa un URL di reindirizzamento diverso da quello usato per altri ambienti. Per configurare il bot per l'autenticazione, usare https://token.botframework.azure.cn/.auth/web/redirect come URL di reindirizzamento OAuth e seguire la procedura descritta in come aggiungere l'autenticazione al bot.

Configurare un bot per l'esecuzione in uno o più canali

Per configurare un bot per la connessione a un canale, seguire questa procedura:

Accedere al portale di Azure.
Selezionare il bot da configurare.
Nel riquadro sinistro selezionare Canali in Impostazioni.
Nel riquadro destro selezionare l'icona del canale da aggiungere al bot. Potrebbe essere necessario scorrere verso il basso per visualizzare l'elenco di tutti i canali disponibili. I passaggi di connessione variano per ogni canale. Per altre informazioni sui canali supportati, vedere gli articoli correlati.

Channel	Descrizione
Direct Line	Integrare un bot in un'app per dispositivi mobili, in una pagina Web o in altre applicazioni.
Microsoft Teams	Configurare un bot per comunicare con gli utenti tramite Microsoft Teams.
Web Chat	Configurata automaticamente quando si crea un bot con il servizio Bot Framework.

Passaggi successivi

Con questi passaggi, il bot deve essere configurato per funzionare correttamente. Altri riferimenti utili relativi a servizio Bot.

Condividi tramite