Tworzenie zasobu usługi Azure Bot przy użyciu witryny Azure Portal
DOTYCZY: ZESTAW SDK w wersji 4
Zasób usługi Azure Bot (zasób bota) umożliwia zarejestrowanie bota w usłudze Azure AI Bot Service i połączenie bota z kanałami. Możesz tworzyć i łączyć boty oraz zarządzać nimi, aby wchodzić w interakcje z użytkownikami wszędzie tam, gdzie są, z twojej aplikacji lub witryny internetowej do aplikacji Teams, Messengera i wielu innych kanałów.
W tym artykule opisano sposób tworzenia zasobu bota za pośrednictwem witryny Azure Portal.
- Aby dowiedzieć się, jak utworzyć bota, zobacz Przewodnik Szybki start Tworzenie bota przy użyciu zestawu SDK platformy Bot Framework.
- Aby uzyskać informacje na temat aprowizacji i publikowania bota na platformie Azure, zobacz jak wdrożyć bota na platformie Azure.
Zarządzanie zasobami
Podczas tworzenia zasobu bota platforma Azure tworzy skojarzone zasoby. Niektóre utworzone zasoby zależą od sposobu, w jaki decydujesz się zarządzać tożsamością bota.
Tożsamość bota może być zarządzana na platformie Azure na kilka różnych sposobów.
- Jako tożsamość zarządzana przypisana przez użytkownika, aby nie trzeba było samodzielnie zarządzać poświadczeniami bota.
- Jako aplikacja z jedną dzierżawą.
- Jako aplikacja wielodostępna.
Dodano obsługę tożsamości zarządzanej przypisanej przez użytkownika i typów aplikacji z jedną dzierżawą do zestawu Bot Framework SDK dla języka C# i języka JavaScript w wersji 4.15.0. Te typy aplikacji nie są obsługiwane w innych językach ani w narzędziu Bot Framework Composer, Bot Framework Emulator lub ngrok.
| Typ aplikacji | Pomoc techniczna |
|---|---|
| Tożsamość zarządzana przypisana przez użytkownika | Azure AI Bot Service i zestawy SDK języka C# i JavaScript |
| Pojedyncza dzierżawa | Azure AI Bot Service i zestawy SDK języka C#, JavaScript i Python |
| Wiele dzierżaw | Azure AI Bot Service, wszystkie języki zestawu BOT Framework SDK, Composer, Emulator i ngrok |
Wymagania wstępne
- Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto.
- Zestaw SDK platformy Bot Framework dla języka C# lub JavaScript w wersji 4.15.0 lub nowszej dla tożsamości zarządzanej przypisanej przez użytkownika i botów z jedną dzierżawą.
Tworzenie zasobu
Utwórz zasób usługi Azure Bot, który umożliwi zarejestrowanie bota w usłudze Azure AI Bot Service.
Napiwek
Nie można utworzyć nowych zasobów rejestracji bota aplikacji internetowej i kanałów bota, jednak wszystkie takie zasoby, które są skonfigurowane i wdrożone, będą nadal działać. Boty utworzone na podstawie szablonu VSIX lub Yeoman z zestawu SDK w wersji 4.14.1.2 lub nowszej zawierają szablony usługi ARM, które wygenerują zasób usługi Azure Bot.
Przejdź do portalu Azure Portal.
W okienku po prawej stronie wybierz pozycję Utwórz zasób.
W polu wyszukiwania wprowadź ciąg
bot, a następnie naciśnij klawisz Enter.Wybierz kartę Azure Bot .
Wybierz pozycję Utwórz.
Wprowadź wartości w wymaganych polach i przejrzyj i zaktualizuj ustawienia.
Podaj informacje w obszarze Szczegóły projektu. Wybierz, czy bot będzie miał globalną, czy lokalną rezydencję danych. Obecnie funkcja lokalnego przechowywania danych jest dostępna dla zasobów w regionie "westeurope" i "centralindia". Aby uzyskać więcej informacji, zobacz Regionalizacja w usłudze Azure AI Bot Service.
Podaj informacje w obszarze Identyfikator aplikacji microsoft. Wybierz sposób zarządzania tożsamością bota na platformie Azure i określ, czy chcesz utworzyć nową tożsamość, czy użyć istniejącej.
Wybierz pozycję Przejrzyj i utwórz.
Jeśli walidacja zakończy się pomyślnie, wybierz pozycję Utwórz.
Po zakończeniu wdrażania wybierz pozycję Przejdź do zasobu. Powinien zostać wyświetlony bot i powiązane zasoby wymienione w wybranej grupie zasobów.
Jeśli nie masz jeszcze zestawu SDK platformy Bot Framework, wybierz pozycję Pobierz z usługi GitHub , aby dowiedzieć się, jak korzystać z pakietów dla preferowanego języka.
Teraz możesz przystąpić do kompilowania bota przy użyciu zestawu Sdk platformy Bot Framework.
Napiwek
Gdy platforma Azure tworzy nowy zasób usługi Azure Bot z jedną dzierżawą lub wieloma dzierżawami z nowym identyfikatorem aplikacji, generuje również hasło.
Informacje o tożsamości bota
Wykonaj następujące kroki, aby dodać informacje o tożsamości do pliku konfiguracji bota. Plik różni się w zależności od języka programowania używanego do utworzenia bota.
Ważne
Wersja java zestawu Bot Framework SDK obsługuje tylko boty wielodostępne. Wersja języka Python zestawu Bot Framework SDK obsługuje boty wielodostępne i jednodostępne. Wersje języków C# i JavaScript obsługują wszystkie trzy typy aplikacji do zarządzania tożsamością bota.
| Język | Nazwa pliku | Uwagi |
|---|---|---|
| C# | appsettings.json | Obsługuje wszystkie trzy typy aplikacji do zarządzania tożsamością bota. |
| JavaScript | .Env | Obsługuje wszystkie trzy typy aplikacji do zarządzania tożsamością bota. |
| Java | application.properties | Obsługuje tylko boty z wieloma dzierżawami. |
| Python | config.py | Obsługuje boty wielodostępne i jednodostępne. Podaj właściwości jako argumenty wywołań os.environ.get metody. |
Informacje o tożsamości, które należy dodać, zależą od typu aplikacji bota. Podaj następujące wartości w pliku konfiguracji.
Dostępne tylko dla botów języka C# i JavaScript.
| Właściwości | Wartość |
|---|---|
MicrosoftAppType |
UserAssignedMSI |
MicrosoftAppId |
Identyfikator klienta tożsamości zarządzanej przypisanej przez użytkownika. |
MicrosoftAppPassword |
Nie dotyczy. Pozostaw to pole puste dla bota tożsamości zarządzanej przypisanej przez użytkownika. |
MicrosoftAppTenantId |
Identyfikator dzierżawy tożsamości zarządzanej przypisanej przez użytkownika. |
Aby zaktualizować usługę App Service
Jeśli masz istniejący zasób usługi App Service (aplikację internetową) dla bota, a bot jest aplikacją tożsamości zarządzanej przypisanej przez użytkownika, może być konieczne zaktualizowanie usługi aplikacji bota:
- Przejdź do bloku App Service dla aplikacji internetowej bota.
- W obszarze Ustawienia wybierz pozycję Tożsamość.
- W bloku Tożsamość wybierz kartę Przypisane przez użytkownika i Dodaj (+).
- W bloku Dodawanie tożsamości zarządzanej przypisanej przez użytkownika:
Wybierz subskrypcję.
W obszarze Tożsamości zarządzane przypisane przez użytkownika wybierz tożsamość zarządzaną bota. Jeśli tożsamość zarządzana została wygenerowana automatycznie, będzie miała taką samą nazwę jak bot.
Wybierz pozycję Dodaj , aby użyć tej tożsamości dla bota.
Aby uzyskać identyfikator aplikacji lub dzierżawy
Aby uzyskać identyfikator aplikacji lub dzierżawy bota:
- Przejdź do bloku zasobów usługi Azure Bot dla bota.
- Przejdź do bloku Konfiguracja bota. W tym bloku możesz skopiować identyfikator aplikacji firmy Microsoft lub identyfikator dzierżawy aplikacji bota.
Aby wygenerować nowe hasło
Boty z jedną dzierżawą i wieloma dzierżawami mają klucz tajny aplikacji lub hasło potrzebne do niektórych operacji. Usługa Azure AI Bot Service ukrywa wpis tajny bota. Jednak właściciel zasobu usługi App Service bota może wygenerować nowe hasło:
- Przejdź do bloku zasobów usługi Azure Bot dla bota.
- Przejdź do bloku Konfiguracja bota.
- Wybierz pozycję Zarządzaj obok pozycji Identyfikator aplikacji firmy Microsoft, aby przejść do bloku Certyfikaty i wpisy tajne dla usługi App Service.
- Postępuj zgodnie z instrukcjami w bloku, aby utworzyć nowy klucz tajny klienta i zarejestrować wartość w bezpiecznym miejscu.
Dodatkowe informacje
- Aby uzyskać informacje na temat zarządzania tożsamościami za pomocą identyfikatora Entra firmy Microsoft, zobacz Co to jest identyfikator Entra firmy Microsoft?.
- Aby uzyskać informacje o planach usługi aplikacja systemu Azure Service i usługi App Service, zobacz Omówienie usługi App Service.
- Aby uzyskać informacje o zasobach platformy Azure i sposobie ich zarządzania w ogóle, zobacz Omówienie usługi Azure Resource Manager.
Uwaga
Bot Framework Composer and Bot Framework Emulator obecnie obsługuje tylko boty wielodostępne. Zestaw SDK platformy Bot Framework dla języka C# lub JavaScript w wersji 4.15.0 lub nowszej jest wymagany dla tożsamości zarządzanej przypisanej przez użytkownika i botów z jedną dzierżawą.
Obsługa umiejętności
Niektóre typy konsumentów umiejętności nie mogą używać niektórych typów botów umiejętności. W poniższej tabeli opisano, które kombinacje są obsługiwane.
| Umiejętność obsługi wielu dzierżaw | Umiejętność z jedną dzierżawą | Umiejętność tożsamości zarządzanej przypisanej przez użytkownika | |
|---|---|---|---|
| Użytkownik z wieloma dzierżawami | Obsługiwane | Nieobsługiwane | Nieobsługiwane |
| Użytkownik z jedną dzierżawą | Nieobsługiwane | Obsługiwane, jeśli obie aplikacje należą do tej samej dzierżawy | Obsługiwane, jeśli obie aplikacje należą do tej samej dzierżawy |
| Odbiorca tożsamości zarządzanej przypisanej przez użytkownika | Nieobsługiwane | Obsługiwane, jeśli obie aplikacje należą do tej samej dzierżawy | Obsługiwane, jeśli obie aplikacje należą do tej samej dzierżawy |
Aby uzyskać informacje na temat konfigurowania umiejętności lub konsumenta umiejętności, zobacz Implementowanie umiejętności lub Implementowanie konsumenta umiejętności.