Integrowanie bota OpenAI z czatem

Warning

Azure Communication Services wprowadza nowatorskie zmiany, a niektóre usługi są wycofywane. Dowiedz się więcej w przewodniku po zmianach emerytalnych i przełamowych.

W tym artykule pokazano, jak zintegrować konwersacyjnego bota OpenAI z czatem usług Azure Communication Services. Czatbot OpenAI używa platformy Microsoft Bot Framework zintegrowanej z jądrem semantycznym. Bot OpenAI pobiera i podsumowuje odpowiedzi z wewnętrznej bazy wiedzy, aby odpowiedzieć na pytania użytkowników w języku naturalnym.

Diagram architektury usługi Azure OpenAI.

Krok 1. Wdrażanie modelu podstawowego za pomocą rozwiązania Microsoft Foundry

  1. W portalu Foundry postępuj zgodnie z artykułem Tworzenie projektu , aby utworzyć nowy projekt. Po wyświetleniu monitu utwórz nowe centrum i zaakceptuj wszystkie ustawienia domyślne.

  2. Otwórz projekt, przejdź do pozycji Uwzględnione możliwości, wybierz pozycję Azure OpenAI Service i zapisz zarówno klucz interfejsu API, jak i adres URL punktu końcowego usługi.

    Zrzut ekranu przedstawiający stronę przeglądu portalu Foundry.

  3. W menu po lewej stronie przejdź do pozycji Moje zasoby → Modele i punkty końcowe. Następnie kliknij pozycję + Wdróż model i wybierz pozycję Wdróż model podstawowy.

    Zrzut ekranu przedstawiający stronę Zarządzanie wdrożeniami modeli i usług z wybranym elementem menu Wdróż model podstawowy.

  4. Wybierz pozycję gpt-4o i kliknij przycisk Potwierdź.

    Zrzut ekranu okna dialogowego Wybieranie modelu z wybranym gpt-4o.

  5. Wprowadź wybraną nazwę wdrożenia, a następnie kliknij pozycję Połącz i wdróż.

    Zrzut ekranu przedstawiający okno dialogowe

  6. Po zakończeniu wdrażania wróć do folderu Modele i punkty końcowe , aby sprawdzić, czy model jest uruchomiony. W tym przykładzie wdrożony model to gpt-4o.

    Zrzut ekranu zasobu Modele i punkty końcowe, który przedstawia GTP-4o jako wdrożony model i powiązane informacje o wdrożeniu.

Krok 2. Tworzenie zasobu aplikacji internetowej

  1. W witrynie Azure Portal wybierz polecenie Utwórz zasób. W polu wyszukiwania wprowadź ciąg aplikacja internetowa. Wybierz kafelek Aplikacja internetowa.

    Zrzut ekranu przedstawiający tworzenie zasobu aplikacji internetowej w witrynie Azure Portal.

  2. W obszarze Tworzenie aplikacji internetowej wybierz lub wprowadź szczegóły aplikacji, w tym region, w którym chcesz wdrożyć aplikację.

    Zrzut ekranu strony

  3. Wybierz pozycję Przejrzyj i utwórz , aby zweryfikować wdrożenie i przejrzeć szczegóły wdrożenia. Następnie wybierz przycisk Utwórz.

  4. Po utworzeniu zasobu aplikacji internetowej skopiuj adres URL nazwy hosta wyświetlany w szczegółach zasobu. Adres URL jest częścią punktu końcowego utworzonego dla aplikacji internetowej.

    Zrzut ekranu przedstawiający stronę My-First-Bot-WebApp z adresem URL punktu końcowego aplikacji internetowej, który należy skopiować do użytku w przyszłości.

Krok 3. Tworzenie zasobu usługi Azure Bot Service

  1. W witrynie Azure Portal wybierz polecenie Utwórz zasób. W polu wyszukiwania wprowadź bot. Wybierz kafelek Azure Bot .

    Zrzut ekranu przedstawiający kafelek bota platformy Azure przedstawiający szczegóły potrzebne do utworzenia usługi Azure Bot Service.

  2. W Tworzenie bota platformy Azure wybierz Wielodostępne jako Typ aplikacji i Utwórz nowy identyfikator aplikacji firmy Microsoft jako Typ tworzenia.

  3. Wybierz pozycję Przejrzyj i utwórz , aby zweryfikować wdrożenie i przejrzeć szczegóły wdrożenia. Następnie wybierz przycisk Utwórz.

  4. Pobierz identyfikator aplikacji bota i utwórz hasło. Zapisz te wartości do użycia w przypadku późniejszych konfiguracji.

Krok 4. Tworzenie punktu końcowego obsługi komunikatów dla bota

Usługa Azure Bot Service zwykle oczekuje, że kontroler aplikacji sieciowej bota uwidoczni punkt końcowy w postaci /api/messages. Punkt końcowy obsługuje wszystkie komunikaty wysyłane do bota. Następnie w zasobie bota utwórz punkt końcowy komunikacji aplikacji webowej.

  1. W witrynie Azure Portal przejdź do zasobu usługi Azure Bot. W menu zasobów wybierz pozycję Konfiguracja.

  2. W konfiguracji, dla punktu końcowego wiadomości, wklej adres URL nazwy hosta aplikacji internetowej, który skopiowałeś w poprzedniej sekcji. Dołącz adres URL za pomocą /api/messagespolecenia .

  3. Wybierz i zastosuj.

Zrzut ekranu przedstawiający sposób tworzenia punktu końcowego obsługi komunikatów bota przy użyciu nazwy hosta aplikacji internetowej.

Krok 5. Tworzenie zasobu usługi Azure Communication Service

  1. W witrynie Azure Portal wybierz pozycję Utwórz zasób. W polu wyszukiwania wprowadź usługi komunikacyjne. Wybierz element Usługi komunikacyjne.

    Zrzut ekranu przedstawiający kafelek usługi Communication Services przedstawiający szczegółowe informacje potrzebne do utworzenia zasobu usług Azure Communication Services.

  2. W Tworzenie usługi Azure Communication Service można określić subskrypcję, grupę zasobów, nazwę zasobu usług komunikacyjnych i lokalizację geograficzną powiązaną z zasobem.

  3. Wybierz pozycję Przejrzyj i utwórz , aby zweryfikować wdrożenie i przejrzeć szczegóły wdrożenia. Następnie wybierz Utwórz.

  4. Przejdź do zasobu. Wybierz Ustawienia - Tożsamości i Tokeny Dostępu Użytkowników>Czat, a następnie kliknij Generuj. Zapisz token tożsamości i dostępu użytkownika do użycia w przyszłości.

    Zrzut ekranu przedstawiający sposób tworzenia identyfikatora użytkownika usług Communication Services i tokenu dostępu

Krok 6. Włączanie kanału czatu usług komunikacyjnych

Jeśli masz zasób usług komunikacyjnych, możesz skonfigurować kanał usług komunikacyjnych w zasobie bota. Ten proces generuje identyfikator użytkownika usługi Bot Azure Communication Services dla bota.

  1. W witrynie Azure Portal przejdź do zasobu usługi Azure Bot. W menu zasobów wybierz pozycję Kanały. Na liście dostępnych kanałów wybierz pozycję Usługi komunikacyjne — czat.

    Zrzut ekranu przedstawiający otwieranie kanału czatu usług komunikacyjnych.

  2. Wybierz pozycję Połącz , aby wyświetlić listę zasobów usług komunikacyjnych, które są dostępne w ramach subskrypcji.

    Zrzut ekranu przedstawiający sposób łączenia zasobu usługi komunikacyjnej z botem.

  3. W okienku Nowe połączenie wybierz zasób czatu usług komunikacyjnych, a następnie kliknij Zastosuj.

    Zrzut ekranu przedstawiający sposób zapisywania wybranego zasobu usługi komunikacyjnej w celu utworzenia nowego identyfikatora użytkownika usług Communication Services.

  4. Po zweryfikowaniu szczegółów zasobu identyfikator użytkownika usług Bot Azure Communication Services jest wyświetlany w kolumnie Identyfikator usług Bot Azure Communication Services . Zapisz identyfikator do późniejszego użycia.

    Zrzut ekranu przedstawiający nowy identyfikator użytkownika usług Communication Services przypisany do bota.

Krok 7. Wdrażanie aplikacji internetowej

  1. Otwórz folder ChatBot w przykładowym repozytorium w programie Visual Studio Code (VS Code). Używaj VS Code, ponieważ obsługuje Microsoft Entra ID podczas wdrażania kodu.

  2. Zastąp symbole zastępcze w przykładowym repozytorium rzeczywistymi wartościami:

    1. SemanticKernelService.cs W pliku wypełnij wartości zmiennych modelId, endpointi apiKey.
    2. W pliku appsettings.json wypełnij wartości zmiennych MicrosoftAppId i MicrosoftAppPassword przy użyciu bot app id i bot password zanotowanego w Kroku 3.

  3. Zainstaluj rozszerzenie usługi Azure App Service w programie VS Code.

    Zrzut ekranu przedstawiający sposób instalowania rozszerzenia usługi App Service.

  4. Zaloguj się do konta platformy Azure w programie VS Code. Aby uzyskać dostęp do panelu logowania, kliknij ikonę platformy Azure na pasku działań po stronie okna.

  5. Zainstaluj rozszerzenie usługi Azure App Service w programie VS Code.

    Zrzut ekranu przedstawiający sposób logowania się do konta platformy Azure w programie VS Code.

  6. Skompiluj projekt, uruchamiając następujące polecenie w katalogu głównym projektu "ChatBot".

    dotnet publish -c Release -o ./bin/Publish

To polecenie generuje foldery bin i obj .

  1. Aby wdrożyć aplikację internetową, kliknij prawym przyciskiem myszy nowy /bin/Publish folder i wybierz polecenie Wdróż w aplikacji internetowej.

    Zrzut ekranu przedstawiający sposób wybierania folderu do wdrożenia.

  2. Wybierz aplikację internetową usługi Azure App Service, do której chcesz wdrożyć aplikację. Potwierdź wdrożenie.

    Zrzut ekranu przedstawiający sposób wdrażania aplikacji internetowej na platformie Azure.

Krok 8. Uruchamianie pokazu

  1. Wykonaj kroki poprzedzające sekcję "Pobierz klienta wątku czatu" w Dodawanie czatu do aplikacji, aby utworzyć aplikację czatu i rozpocząć wątek.

    Najważniejsze uwagi:

    • Zasób usługi Azure Communication Service został już utworzony w portalu, więc możesz bezpośrednio użyć elementu <Azure Communication Services endpoint>, <Access_ID>i <Access_Token> w kodzie.
    • Podczas tworzenia wątku należy utworzyć inny ChatParticipant obiekt przy użyciu obiektu utworzonego Bot Azure Communication Services User ID w kroku 6: Włącz kanał czatu usługi komunikacyjnej jako <Access_ID> obiekt, aby reprezentować użytkownika bota.
    • Zapisz Thread Id do późniejszego użycia.

  2. Otwórz złożoną bibliotekę interfejsu użytkownika: Azure Communication Services Chat Thread UI — Dołącz do Istniejącego Wątku czatu.

  3. Podaj wymagane informacje, aby dołączyć do istniejącego wątku czatu.

    • Nazwa wyświetlana: możesz wybrać preferowaną nazwę.
    • Identyfikator użytkownika dla użytkownika: <Access_ID> zapisany w kroku 8.1.
    • Prawidłowy token dla użytkownika: <Access_Token> zapisany w kroku 8.1.
    • Punkt końcowy usług Azure Communication Services: <Azure Communication Services endpoint> zapisany w kroku 8.1.
    • Istniejący wątek Thread Id: zapisany w kroku 8.1.

  4. Zadaj następujące pytania w sekwencji:

    • Pytania 1: Mój identyfikator użytkownika to 110. Kupiłem laptopa kilka dni temu. Czy możesz pomóc w śledzeniu dostawy?
    • Pytanie 2: Poprosiłem o zwrot dla mojego Power Banku. Jakieś aktualizacje?
    • Pytanie 3: Kupiłem słuchawki Bluetooth 2 dni temu, ale nie zostały jeszcze wysłane. Dlaczego?

Interfejs OpenAI pobiera dane istotne dla semantyki pytania i udostępnia odpowiedź na podstawie dostępnych danych.

Znaki towarowe

Ten projekt może zawierać znaki towarowe lub logo projektów, produktów lub usług. Autoryzowane używanie znaków towarowych lub logo firmy Microsoft podlega i musi być zgodne z wytycznymi firmy Microsoft dotyczącymi znaków towarowych i marki.

Użycie znaków towarowych lub logotypów Microsoft w zmodyfikowanych wersjach tego projektu nie może powodować niejasności ani sugerować, że projekt jest sponsorowany przez Microsoft.

Wszelkie zastosowania znaków towarowych lub logo innych firm podlegają zasadom tych firm trzecich.

  • Ostatnia aktualizacja o