Konfigurowanie bota na platformie Microsoft Azure obsługiwanego przez firmę 21Vianet

Artykuł
10/09/2024

Ten przewodnik ułatwia klientom platformy Microsoft Azure wdrażanie botów Bot Framework i botów usługi Azure AI na platformie Microsoft Azure obsługiwanej przez firmę 21Vianet.

Wymagania wstępne

Konto na platformie Microsoft Azure.
Projekt bota języka C# lub JavaScript, który chcesz skonfigurować.
Zestaw Bot Framework SDK w wersji 4.14 lub nowszej.

Korzystanie z adaptera w chmurze

Upewnij się, że bot używa karty w chmurze lub karty pochodzącej z karty chmury. Karta w chmurze umożliwia określenie ustawień specyficznych dla chmury platformy Microsoft Azure.

C#
JavaScript

Klasa ConfigurationBotFrameworkAuthentication odczytuje ustawienia uwierzytelniania z pliku konfiguracji bota. Po utworzeniu karta w chmurze korzysta z tych ustawień uwierzytelniania.

Upewnij się, że ConfigureServices metoda w pliku Startup.cs zawiera ten wiersz.

services.AddSingleton<BotFrameworkAuthentication, ConfigurationBotFrameworkAuthentication>();

Konstruktor ConfigurationBotFrameworkAuthentication odczytuje ustawienia uwierzytelniania z pliku konfiguracji bota.

W pliku index.js kod do utworzenia karty powinien wyglądać następująco:

const botFrameworkAuthentication = new ConfigurationBotFrameworkAuthentication(process.env);

const adapter = new CloudAdapter(botFrameworkAuthentication);

Konfigurowanie bota UserAssignedMSI/SingleTenant

Aby upewnić się, że bot działa poprawnie w chmurze platformy Microsoft Azure, niezbędne są dodatkowe ustawienia uwierzytelniania. Zastąp wartość "App-Tenant-ID" identyfikatorem dzierżawy bota.

C#
JavaScript

Dodaj następujące ustawienia do pliku 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

Dodaj następujące ustawienia do pliku 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

Konfigurowanie bota wielodostępnych

W przypadku bota wielodostępu użyj następujących ustawień.

C#
JavaScript

Dodaj następujące ustawienia do pliku 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

Dodaj następujące ustawienia do pliku 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

Dodawanie uwierzytelniania użytkownika do bota

Bot może używać różnych dostawców tożsamości do uzyskiwania dostępu do zasobów w imieniu użytkownika, takich jak Microsoft Entra ID i wielu innych dostawców OAuth.

Usługa Microsoft Azure Cloud używa adresu URL przekierowania, który różni się od tych używanych w innych środowiskach. Aby skonfigurować bota do uwierzytelniania, użyj go https://token.botframework.azure.cn/.auth/web/redirect jako adresu URL przekierowania protokołu OAuth i wykonaj kroki opisane w temacie Dodawanie uwierzytelniania do bota.

Konfigurowanie bota do uruchamiania na co najmniej jednym kanale

Aby skonfigurować bota w celu nawiązania połączenia z kanałem, wykonaj następujące kroki:

Zaloguj się w witrynie Azure Portal.
Wybierz bota, który chcesz skonfigurować.
W okienku po lewej stronie wybierz pozycję Kanały w obszarze Ustawienia.
W okienku po prawej stronie wybierz ikonę kanału, który chcesz dodać do bota. Może być konieczne przewinięcie w dół, aby wyświetlić listę wszystkich dostępnych kanałów. Kroki połączenia różnią się w zależności od kanału. Aby uzyskać więcej informacji na temat obsługiwanych kanałów, zobacz powiązane artykuły.

Kanał	opis
Linia bezpośrednia	Integrowanie bota z aplikacją mobilną, stroną internetową lub innymi aplikacjami.
Microsoft Teams	Skonfiguruj bota do komunikowania się z użytkownikami za pośrednictwem usługi Microsoft Teams.
czat internetowy	Automatycznie konfigurowane podczas tworzenia bota za pomocą usługi Bot Framework Service.

Następne kroki

W tych krokach bot powinien zostać skonfigurowany tak, aby działał pomyślnie. Inne przydatne odwołania dotyczące usługi Bot Service.

Udostępnij za pośrednictwem