Tworzenie zasobu usługi Azure Bot przy użyciu witryny Azure Portal

DOTYCZY: SDK v4

Zasób Azure Bot (zasób bota) umożliwia zarejestrowanie bota w usłudze Azure AI Bot Service oraz łą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ć agenta, zobacz Szybki start: tworzenie i testowanie podstawowego agenta — szybki start.
• 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 sposobów:

• Używając tożsamości zarządzanej przypisanej przez użytkownika, nie musisz zarządzać poświadczeniami ręcznie.
• Jako aplikacja jednodostępna.
• Jako aplikacja wielodostępna.

Obsługiwane typy aplikacji

Wymagania wstępne

• Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto.
• 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 jednodzierżawowych.

Tworzenie zasobu

Utwórz zasób usługi Azure Bot, który umożliwi zarejestrowanie bota w usłudze Azure AI Bot Service.

1. Przejdź do portalu Azure Portal.

2. W okienku po prawej stronie wybierz pozycję Utwórz zasób.

3. W polu wyszukiwania wprowadź ciąg bot, a następnie naciśnij Enter.

4. Wybierz kartę Azure Bot .

   

5. Wybierz pozycję Utwórz.

6. Wprowadź wartości w wymaganych polach i przejrzyj i zaktualizuj ustawienia.

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

      

   2. Podaj informacje w sekcji Microsoft App ID. 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.

      

7. Wybierz pozycję Przejrzyj i utwórz.

8. Jeśli walidacja zakończy się pomyślnie, wybierz pozycję Utwórz.

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

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

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 tworzenia bota.

Informacje o tożsamości, które należy dodać, zależą od typu aplikacji bota. Podaj następujące wartości w pliku konfiguracji.

Aby zaktualizować usługę App Service

Jeśli masz istniejący zasób App Service (aplikację internetową) dla swojego bota, a bot korzysta z aplikacji z tożsamością zarządzaną przypisaną przez użytkownika, może być konieczne zaktualizowanie zasobu App Service bota:

1. Przejdź do bloku App Service dla aplikacji internetowej bota.
2. W obszarze Ustawienia wybierz pozycję Tożsamość.
3. W bloku Tożsamość wybierz kartę Przypisane przez użytkownika, a następnie Dodaj (+).
4. W bloku Dodawanie tożsamości zarządzanej przypisanej przez użytkownika:

   1. Wybierz subskrypcję.

   2. W obszarze Tożsamości zarządzane przypisane przez użytkownika wybierz tożsamość zarządzaną dla bota. Jeśli tożsamość zarządzana została wygenerowana automatycznie dla Ciebie, będzie miała taką samą nazwę co bot.

   3. 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:

1. Przejdź do panelu zasobu Azure Bot dla swojego bota.
2. 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 klucz tajny bota. Jednak właściciel zasobu usługi App Service bota może wygenerować nowe hasło:

1. Przejdź do panelu zasobu Azure Bot dla swojego bota.
2. Przejdź do bloku Konfiguracja bota.
3. Wybierz pozycję Zarządzaj obok pozycji Microsoft App ID, aby przejść do sekcji Certificates + secrets dla usługi App Service.
4. 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 usłudze Azure App Service i planach 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.

Obsługa umiejętności

Niektóre rodzaje użytkowników umiejętności nie mogą korzystać z niektórych rodzajów botów obsługujących umiejętności. W poniższej tabeli opisano, które kombinacje są obsługiwane.

Aby uzyskać informacje na temat konfigurowania umiejętności lub konsumenta umiejętności, zobacz Implementacja umiejętności lub Implementacja konsumenta umiejętności.

Następne kroki

• Tworzenie bota za pomocą narzędzia Bot Framework Composer
• Szybki start: tworzenie i testowanie podstawowego agenta