Samouczek: wdrażanie aplikacji internetowej do czatu dla przedsiębiorstw

W tym artykule wdrożysz aplikację internetową do czatu dla przedsiębiorstw, która wykorzystuje twoje dane w połączeniu z dużym modelem językowym w portalu Microsoft Foundry.

Źródło danych jest podstawą modelu z określonymi danymi. Uziemienia oznacza, że model używa danych do zrozumienia kontekstu pytania. Nie zmieniasz samego wdrożonego modelu. Dane pozostają oddzielone i bezpieczne w oryginalnym źródle danych.

Kroki opisane w tym samouczku są następujące:

Wymagania wstępne

• Konto Azure z aktywną subskrypcją. Jeśli go nie masz, utwórz bezpłatne konto platformy Azure, które obejmuje subskrypcję bezpłatnej wersji próbnej.
• Jeśli go nie masz, utwórz projekt oparty na centrum.

• Wdrożony model czatu usługi Azure OpenAI. Ukończ przewodnik Szybki start dotyczący narzędzia Foundry, aby utworzyć ten zasób, jeśli go nie masz.

• Połączenie usługa wyszukiwania z indeksem przykładowych danych produktu. Jeśli go nie masz, wykonaj kroki tworzenia i łączenia usługi wyszukiwania.

• Lokalna kopia danych produktu. Repozytorium Azure-Samples/rag-data-openai-python-promptflow w witrynie GitHub zawiera przykładowe informacje o produkcie detalicznym dla tego scenariusza samouczka. Plik product_info_11.md zawiera informacje o produktach dotyczących butów turystycznych TrailWalker na potrzeby tego przykładu samouczka. Pobierz przykładowe dane produktów detalicznych Contoso Trek w pliku ZIP na komputer lokalny.

• Dostawca zasobów Microsoft.Web zarejestrowany w wybranej subskrypcji, który umożliwia wdrożenie w aplikacji internetowej. Aby uzyskać więcej informacji na temat rejestrowania dostawcy zasobów, zobacz Rejestrowanie dostawcy zasobów.

• Niezbędne uprawnienia do dodawania przypisań ról w subskrypcji platformy Azure. Tylko właściciel określonych zasobów platformy Azure może udzielić uprawnień przez przypisanie roli.

Witryna Foundry Portal i witryna Azure Portal

W tym samouczku wykonasz niektóre zadania w portalu Foundry i niektóre zadania w witrynie Azure Portal.

Portal Foundry to internetowe środowisko do tworzenia, trenowania i wdrażania modeli sztucznej inteligencji. Jako deweloper jest to miejsce, w którym tworzysz i wdrażasz aplikację internetową czatu.

Witryna Azure Portal umożliwia administratorowi zarządzanie zasobami platformy Azure i monitorowanie ich. Jako administrator używasz portalu do konfigurowania ustawień dla różnych usług platformy Azure wymaganych do uzyskania dostępu z aplikacji internetowej.

Konfigurowanie zasobów

Aby zasoby działały poprawnie w aplikacji internetowej, skonfiguruj odpowiednie uprawnienia w witrynie Azure Portal.

Najpierw zidentyfikuj zasoby, które należy skonfigurować w portalu Foundry.

1. Otwórz portal Foundry, a następnie wybierz projekt oparty na centrum, który został użyty do wdrożenia modelu czatu Usługi Azure OpenAI.

2. Wybierz Centrum zarządzania z lewego panelu.

3. Wybierz pozycję Połączone zasoby w projekcie.

4. Zidentyfikuj trzy zasoby, które należy skonfigurować: Azure OpenAI, Azure AI Search i Azure Blob Storage, który odpowiada twojemu obszarowi roboczemublobstore.

   

   Wskazówka

   Jeśli nie widzisz pozycji Typ w tabeli, wybierz pozycję Kolumny w prawym górnym rogu i dodaj lub zmień kolejność wybranych kolumn. Jeśli masz wiele zasobów usługi Azure OpenAI , użyj tego, który zawiera wdrożony model czatu.

5. Wyszukaj każdą z tych nazw w witrynie Azure Portal. Otwórz każdy z nich na nowej karcie przeglądarki, aby można było przełączać się między nimi.

6. Gdy skończysz, zostaną otwarte trzy nowe karty przeglądarki: usługa wyszukiwania, Foundry i kontener blobstore. Pozostaw otwarte wszystkie trzy karty, ponieważ przełączasz się między nimi, aby skonfigurować zasoby.

Włącz tożsamość zarządzaną

Na karcie przeglądarki zasobu usługi Wyszukiwania w witrynie Azure Portal włącz tożsamość zarządzaną:

1. W okienku po lewej stronie w obszarze Ustawienia wybierz pozycję Tożsamość.
2. Przełącz pozycję Stan na Włączone.
3. Wybierz Zapisz.

Na karcie przeglądarki dla zasobu Foundry w witrynie Azure Portal włącz tożsamość zarządzaną:

1. W okienku po lewej stronie w obszarze Zarządzanie zasobami wybierz pozycję Tożsamość.
2. Przełącz pozycję Stan na Włączone.
3. Wybierz Zapisz.

Ustawianie kontroli dostępu do wyszukiwania

Na karcie przeglądarki dla zasobu usługi Wyszukiwania w witrynie Azure Portal ustaw zasady dostępu do interfejsu API:

1. W okienku po lewej stronie w obszarze Ustawienia wybierz pozycję Klucze.
2. W obszarze Kontrola dostępu do interfejsu API wybierz pozycję Oba.
3. Po wyświetleniu monitu wybierz pozycję Tak , aby potwierdzić.

Przypisywanie ról

Powtórz ten wzorzec dla każdego zasobu w poniższych krokach.

Ogólny wzorzec przypisywania kontroli dostępu opartej na rolach (RBAC) dla dowolnego zasobu to:

1. Przejdź do witryny Azure Portal dla danego zasobu.
2. Na lewej stronie w witrynie Azure Portal wybierz pozycję Kontrola dostępu (Zarządzanie dostępem i tożsamościami).
3. Wybierz pozycję + Dodaj>Dodaj przypisanie roli.
4. Wyszukaj rolę, którą chcesz przypisać, i wybierz ją. Następnie wybierz Dalej.
5. Podczas przypisywania roli do siebie:
   1. Wybierz użytkownika, grupę lub usługę główną.
   2. Wybierz Wybierz członków.
   3. Wyszukaj swoją nazwę i wybierz ją.
6. Podczas przypisywania roli do innego zasobu:
   1. Wybierz pozycję Tożsamość zarządzana.
   2. Wybierz Wybierz członków.
   3. Użyj listy rozwijanej, aby znaleźć typ zasobu, który chcesz przypisać. Na przykład narzędzia Foundry lub serwis wyszukiwania.
   4. Wybierz zasób z wyświetlonej listy. Może istnieć tylko jeden, ale nadal musisz go wybrać.
7. Kontynuuj pracę kreatora i wybierz pozycję Przejrzyj i przypisz , aby dodać przypisanie roli.

Wykonaj następujące kroki, aby przypisać role dla zasobów skonfigurowanych w tym samouczku:

• Przypisz te role na karcie przeglądarki dla usługi Wyszukiwania w witrynie Azure Portal:

  • Czytnik danych indeksu wyszukiwania w tożsamości zarządzanej usługi Foundry
  • Współautor usługi wyszukiwania w tożsamości zarządzanej usługi Foundry
  • Współautor do siebie (aby znaleźć współautora, przejdź do karty Role administratora uprzywilejowanego u góry. Wszystkie inne role znajdują się na karcie Role funkcji zadania.

• Przypisz te role na karcie przeglądarki dla Foundry w portalu Azure.

  • Współautor openAI usług Cognitive Services dla tożsamości zarządzanej usługa wyszukiwania
  • Współautor do siebie.

• Przypisz te role na karcie przeglądarki dla usługi Azure Blob Storage w witrynie Azure Portal:

  • Współautor danych obiektu blob usługi Storage do tożsamości zarządzanej usługi Foundry
  • Czytelnik danych obiektu blob usługi Storage do tożsamości zarządzanej usługa wyszukiwania
  • Współautor do siebie

Zakończono konfigurowanie zasobów. Jeśli chcesz, możesz teraz zamknąć karty przeglądarki witryny Azure Portal.

Dodaj dane i spróbuj ponownie użyć modelu czatu

W szybkim starcie środowiska testowego Foundry (jest to wymaganie wstępne dla tego samouczka) zobaczysz, jak model reaguje bez danych. Dodaj dane do modelu, aby mógł odpowiedzieć na pytania dotyczące produktów.

Do ukończenia tej sekcji potrzebna jest lokalna kopia danych produktu. Repozytorium Azure-Samples/rag-data-openai-python-promptflow w witrynie GitHub zawiera przykładowe informacje o produkcie detalicznym, które są istotne dla tego scenariusza samouczka. W szczególności product_info_11.md plik zawiera informacje o produkcie dotyczące butów turystycznych TrailWalker, które są istotne dla tego przykładu samouczka. Pobierz przykładowe dane produktów detalicznych Contoso Trek w pliku ZIP na komputer lokalny.

Wykonaj następujące kroki, aby dodać dane na placu zabaw czatu, aby ułatwić asystentowi udzielenie odpowiedzi na pytania dotyczące produktów. Nie zmieniasz samego wdrożonego modelu. Dane są przechowywane oddzielnie i bezpiecznie w ramach subskrypcji platformy Azure.

1. Przejdź do projektu w witrynie Microsoft Foundry.

2. Wybierz pozycję Place zabaw w okienku po lewej stronie.

3. Wybierz pozycję Wypróbuj plac zabaw dla czatu.

4. Wybierz wdrożony model czatu z listy rozwijanej Wdrożenie .

   

5. Po lewej stronie placu zabaw dla czatu wybierz pozycję Dodaj dane>+ Dodaj nowe źródło danych.

   

6. Na liście rozwijanej Źródło danych wybierz pozycję Przekaż pliki.

   

7. Wybierz pozycję Przekaż>pliki, aby przeglądać pliki lokalne.

8. Wybierz pliki, które chcesz przekazać. Wybierz pobrane lub utworzone wcześniej pliki informacji o produkcie. Dodaj teraz wszystkie pliki. Nie będzie można dodać więcej plików w dalszej części tej samej sesji placu zabaw.

9. Wybierz pozycję Przekaż , aby przekazać plik na konto usługi Azure Blob Storage. Następnie wybierz Dalej.

   

10. Wybierz usługę Azure AI Search .

11. W polu Nazwa indeksu wektorowego wprowadź ciąg product-info i wybierz przycisk Dalej.

12. Na stronie Ustawienia wyszukiwania w obszarze Ustawienia wektora usuń zaznaczenie pola wyboru Dodaj wyszukiwanie wektorów do tego zasobu wyszukiwania. To ustawienie pomaga określić, jak model odpowiada na żądania. Następnie wybierz Dalej.

    Uwaga / Notatka

    Jeśli dodasz wyszukiwanie wektorów, więcej opcji będzie dostępnych tutaj w celu uzyskania dodatkowych kosztów.

13. Przejrzyj ustawienia i wybierz pozycję Utwórz indeks wektora.

14. Na placu zabaw widać, że pozyskiwanie danych jest w toku. Ten proces może potrwać kilka minut. Przed kontynuowaniem poczekaj, aż zostanie wyświetlona nazwa źródła danych i indeksu zamiast stanu.

    

15. Teraz możesz porozmawiać z modelem, zadając to samo pytanie co wcześniej ("Ile są buty turystyczne TrailWalker"), a tym razem używa informacji z danych do konstruowania odpowiedzi. Możesz rozwinąć przycisk odwołania , aby wyświetlić dane, które zostały użyte.

Wdrażanie aplikacji internetowej

Jeśli środowisko w portalu Foundry jest zadowalające, wdróż model jako autonomiczną aplikację internetową.

Znajdowanie grupy zasobów w witrynie Azure Portal

W tym samouczku wdróż aplikację internetową w tej samej grupie zasobów co centrum Foundry. Skonfigurujesz uwierzytelnianie dla aplikacji internetowej w witrynie Azure Portal.

Wykonaj następujące kroki, aby przejść do grupy zasobów w witrynie Azure Portal:

1. Przejdź do projektu w witrynie Foundry. Wybierz Centrum zarządzania z lewego panelu.

2. W nagłówku Project wybierz pozycję Overview.

3. Wybierz nazwę grupy zasobów, aby otworzyć grupę zasobów w witrynie Azure Portal. W tym przykładzie grupa zasobów ma nazwę rg-sdg-ai.

   

4. Jesteś teraz w witrynie Azure Portal, wyświetlając zawartość grupy zasobów, w której wdrożono centrum. Zanotuj nazwę i lokalizację grupy zasobów. Te informacje będą używane w następnej sekcji.

5. Pozostaw tę stronę otwartą na karcie przeglądarki. Wrócisz do niego później.

Wdrażanie aplikacji internetowej

Publikowanie tworzy usługę aplikacja systemu Azure w ramach subskrypcji. Możesz ponieść koszty w zależności od wybranego planu cenowego . Po zakończeniu pracy z aplikacją usuń ją z witryny Azure Portal.

Aby wdrożyć aplikację internetową:

1. Wykonaj kroki opisane w poprzedniej sekcji, aby dodać dane do placu zabaw. Możesz wdrożyć aplikację webową z własnymi danymi lub bez nich, jednak potrzebujesz wdrożonego modelu zgodnie z opisem w przewodniku szybkiego startu platformy Foundry playground.

2. Wybierz pozycję Wdróż > ... jako aplikacja internetowa.

   

3. Na stronie Wdrażanie w aplikacji internetowej wprowadź następujące szczegóły:

   • Nazwa: unikatowa nazwa aplikacji internetowej.
   • Subskrypcja: Twoja subskrypcja platformy Azure. Jeśli nie widzisz żadnych dostępnych subskrypcji, najpierw zarejestruj Microsoft.Web jako dostawcę zasobów.
   • Grupa zasobów: wybierz grupę zasobów, w której chcesz wdrożyć aplikację internetową. Użyj tej samej grupy zasobów co centrum.
   • Lokalizacja: wybierz lokalizację, w której ma zostać wdrożona aplikacja internetowa. Użyj tej samej lokalizacji co centrum.
   • Plan cenowy: wybierz plan cenowy dla aplikacji internetowej.
   • Włącz historię czatów w aplikacji internetowej: na potrzeby samouczka pole historii czatów nie jest zaznaczone. Jeśli włączysz tę funkcję, użytkownicy mają dostęp do poszczególnych poprzednich zapytań i odpowiedzi. Aby uzyskać więcej informacji, zobacz uwagi dotyczące historii czatów.

4. Wybierz Wdróż.

5. Poczekaj na wdrożenie aplikacji. Ten proces może potrwać kilka minut.

6. Gdy wszystko będzie gotowe, przycisk Uruchom jest włączony na pasku narzędzi. Nie uruchamiaj jeszcze aplikacji i nie zamykaj strony placu zabaw czatu — wrócisz do niej później.

Konfigurowanie uwierzytelniania aplikacji internetowej

Domyślnie tylko ty możesz uzyskać dostęp do aplikacji internetowej. W tym samouczku dodaj uwierzytelnianie, aby ograniczyć dostęp do członków dzierżawy platformy Azure. Użytkownicy logują się przy użyciu konta Microsoft Entra, aby uzyskać dostęp do aplikacji. Jeśli wolisz, możesz wykonać podobny proces, aby dodać innego dostawcę tożsamości. Aplikacja używa tylko informacji logowania użytkownika, aby sprawdzić, czy są członkami dzierżawy.

1. Wróć do karty przeglądarki za pomocą witryny Azure Portal lub otwórz witrynę Azure Portal na nowej karcie przeglądarki. Wyświetl zawartość grupy zasobów, w której wdrożono aplikację internetową. Może być konieczne odświeżenie widoku, aby wyświetlić aplikację internetową.

2. Wybierz zasób usługi App Service z listy zasobów w grupie zasobów.

3. Z zwijanego menu po lewej stronie w obszarze Ustawienia wybierz pozycję Uwierzytelnianie.

   

4. Jeśli na tej stronie zobaczysz, że firma Microsoft wyświetli dostawcę tożsamości, nic więcej nie jest potrzebne. Możesz pominąć następny krok.

5. Dodaj dostawcę tożsamości z następującymi ustawieniami:

   • Dostawca tożsamości: wybierz pozycję Microsoft jako dostawcę tożsamości. Ustawienia domyślne na tej stronie ograniczają aplikację tylko do dzierżawy, więc nie musisz zmieniać żadnych innych elementów w tym miejscu.
   • Typ dzierżawy: Pracownicy
   • Rejestracja aplikacji: tworzenie nowej rejestracji aplikacji
   • Nazwa: nazwa usługi aplikacji internetowej
   • Obsługiwane typy kont: Bieżąca dzierżawa — pojedyncza dzierżawa
   • Ograniczanie dostępu: wymaga uwierzytelniania
   • Nieuwierzytelnione żądania: znaleziono przekierowanie HTTP 302 — zalecane w przypadku witryn internetowych

Używanie aplikacji sieci Web

Jesteś prawie tam. Teraz możesz przetestować aplikację internetową.

1. Jeśli zmieniono ustawienia, poczekaj około 10 minut na zastosowanie ustawień uwierzytelniania.

2. Wróć do karty przeglądarki ze stroną testów czatu w portalu Foundry.

3. Wybierz pozycję Uruchom , aby otworzyć wdrożona aplikacja internetowa. Jeśli zostanie wyświetlony monit, zaakceptuj żądanie uprawnień.

4. Jeśli nie widzisz pozycji Uruchom na placu zabaw, wybierz pozycję Aplikacje internetowe w okienku po lewej stronie, a następnie wybierz aplikację z listy, aby ją otworzyć.

   Jeśli ustawienia uwierzytelniania nie są jeszcze aktywne, zamknij kartę przeglądarki dla aplikacji webowej i wróć do centrum czatu w portalu Foundry. Poczekaj trochę dłużej, a następnie spróbuj ponownie.

5. W aplikacji internetowej zadaj to samo pytanie, co wcześniej ("Ile to buty turystyczne TrailWalker"). Tym razem aplikacja używa informacji z danych do konstruowania odpowiedzi. Rozwiń przycisk odwołania , aby wyświetlić użyte dane.

   

Informacje o historii czatów

Dzięki funkcji historii czatów użytkownicy mogą zobaczyć swoje poprzednie zapytania i odpowiedzi.

Włącz historię czatów podczas wdrażania aplikacji internetowej. Zaznacz pole wyboru Włącz historię czatu w aplikacji internetowej.

Po włączeniu historii czatów użytkownicy mogą wyświetlać lub ukrywać ją w prawym górnym rogu aplikacji. Gdy historia jest wyświetlana, mogą zmieniać nazwy lub usuwać konwersacje. Po zalogowaniu się do aplikacji konwersacje są uporządkowane od najnowszych do najstarszych i nazwanych na podstawie pierwszego zapytania w konwersacji.

Jeśli usuniesz zasób usługi Cosmos DB, ale zachowasz włączoną opcję historii czatów w programie Studio, użytkownicy zobaczą błąd połączenia, ale mogą nadal korzystać z aplikacji internetowej bez historii czatów.

Aktualizowanie aplikacji internetowej

Użyj placu zabaw, aby dodać więcej danych lub przetestować model przy użyciu różnych scenariuszy. Gdy wszystko będzie gotowe do zaktualizowania aplikacji internetowej przy użyciu nowego modelu, wybierz pozycję Wdróż > ... ponownie jako aplikacja internetowa. Wybierz pozycję Aktualizuj istniejącą aplikację internetową i wybierz istniejącą aplikację internetową z listy. Nowy model jest wdrażany w istniejącej aplikacji internetowej.

Uprzątnij zasoby

Aby uniknąć niepotrzebnych kosztów platformy Azure, usuń zasoby utworzone w tym przewodniku Szybki start, jeśli ich nie potrzebujesz. Zarządzanie zasobami w witrynie Azure Portal.

Treści powiązane

• Rozpocznij tworzenie aplikacji czatu przy użyciu prompt flow SDK
• Tworzenie niestandardowej aplikacji do czatów przy użyciu zestawu Azure AI SDK