Rejestrowanie bota na platformie Azure
DOTYCZY: ZESTAW SDK w wersji 4
Jeśli obecnie nie hostujesz bota na platformie Azure, nadal możesz udostępnić go na platformie Azure i użyć platformy Azure, aby połączyć bota z kanałami. W tym celu wprowadź adres internetowy platformy Azure, na którym jest hostowany bot.
W tym artykule pokazano, jak zarejestrować takiego bota w usłudze Azure AI Bot Service.
Ważne
Musisz zarejestrować bota tylko wtedy, gdy nie jest on hostowany na platformie Azure. Boty utworzone przy użyciu interfejsu wiersza polecenia platformy Azure są już zarejestrowane w usłudze Azure AI Bot Service.
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# i JavaScript |
| Wiele dzierżaw | Azure AI Bot Service, wszystkie języki zestawu BOT Framework SDK, Composer, Emulator i ngrok |
W tym artykule nie opisano sposobu tworzenia ani wdrażania bota w celu zarejestrowania. Aby uzyskać więcej informacji, zobacz:
- Przewodnik Szybki start Tworzenie bota
- Samouczek Wdrażanie podstawowego bota
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
Wersje języka Java i Python zestawu Bot Framework SDK obsługują tylko boty wielodostę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 tylko boty z wieloma dzierżawami. Podaj właściwości tożsamoś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.
Ręczna rejestracja aplikacji
Rejestracja ręczna jest niezbędna w przypadku:
- Nie możesz utworzyć rejestracji w organizacji i potrzebujesz innej strony, aby utworzyć identyfikator aplikacji dla tworzonego bota.
- Musisz ręcznie utworzyć własny identyfikator aplikacji i hasło.
Aktualizowanie bota
Aby zaktualizować plik konfiguracji bota w celu uwzględnienia jego identyfikatora aplikacji i hasła, zobacz Identyfikator aplikacji i hasło w temacie Konfigurowanie ustawień rejestracji bota.
Dodatkowe informacje
Zobacz te artykuły, aby uzyskać więcej informacji na temat aplikacji platformy Azure w ogóle.
| Subject | Artykuł |
|---|---|
| Rejestracja aplikacji | Szybki start: Rejestrowanie aplikacji za pomocą platformy tożsamości firmy Microsoft |
| Tożsamości zarządzane | Co to są tożsamości zarządzane dla zasobów platformy Azure? |
| Aplikacje z jedną dzierżawą i wieloma dzierżawami | Dzierżawa w usłudze Microsoft Entra ID |