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

Ważne

Elementy oznaczone (wersja zapoznawcza) w tym artykule są obecnie dostępne w publicznej wersji zapoznawczej. Ta wersja zapoznawcza jest udostępniana bez umowy dotyczącej poziomu usług i nie zalecamy korzystania z niej w przypadku obciążeń produkcyjnych. Niektóre funkcje mogą być nieobsługiwane lub ograniczone. Aby uzyskać więcej informacji, zobacz Uzupełniające warunki korzystania z wersji zapoznawczych platformy Microsoft Azure.

W tym artykule wdrożysz aplikację internetową do czatu dla przedsiębiorstw, która używa własnych danych z dużym modelem językowym w portalu Azure AI Foundry.

Źródło danych służy do uziemienia modelu z określonymi danymi. Uziemienie oznacza, że model używa danych, aby ułatwić zrozumienie kontekstu pytania. Nie zmieniasz samego wdrożonego modelu. Dane są przechowywane oddzielnie i bezpiecznie w oryginalnym źródle danych

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

1. Wdrażanie i testowanie modelu czatu bez danych.
2. Dodaj dane.
3. Przetestuj model przy użyciu danych.
4. Wdróż aplikację internetową.

Wymagania wstępne

• Subskrypcja platformy Azure — utwórz bezpłatnie.

• Wdrożony model czatu usługi Azure OpenAI. Ukończ przewodnik Szybki start dotyczący platformy Azure AI Foundry, aby utworzyć ten zasób, jeśli jeszcze tego nie zrobiono.

• Połączenie usługi Azure AI usługa wyszukiwania z indeksem przykładowych danych produktu.

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

• Dostawca zasobów Microsoft.Web zarejestrowany w wybranej subskrypcji, aby móc wdrożyć go w aplikacji internetowej.

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

W przewodniku Szybki start dotyczącym platformy Azure AI Foundry (jest to wymaganie wstępne dla tego samouczka) zobacz, jak model reaguje bez danych. Teraz dodasz dane do modelu, aby pomóc mu 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 usłudze Azure AI Foundry.

2. Wybierz pozycję Place zabaw.

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 kliknij przycisk Dalej.

   

10. Wybierz usługa wyszukiwania usługi Azure AI. W tym przykładzie wybierzemy pozycję Połącz inny zasób usługi Azure AI Search z listy rozwijanej Wybierz usługę Azure AI usługa wyszukiwania. Jeśli nie masz zasobu wyszukiwania, możesz go utworzyć, wybierając pozycję Utwórz nowy zasób usługi Azure AI Search. Następnie wróć do tego kroku, aby nawiązać połączenie i wybrać go.

    

11. Wyszukaj usługa wyszukiwania usługi Azure AI i wybierz pozycję Dodaj połączenie.

    

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

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

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

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

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

    

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

Gdy środowisko w portalu azure AI Foundry jest zadowalające, możesz wdrożyć model jako autonomiczną aplikację internetową.

Znajdowanie grupy zasobów w witrynie Azure Portal

W tym samouczku aplikacja internetowa jest wdrażana w tej samej grupie zasobów co centrum usługi Azure AI Foundry. Później skonfigurujesz uwierzytelnianie dla aplikacji internetowej w witrynie Azure Portal.

Wykonaj następujące kroki, aby przejść z usługi Azure AI Foundry do grupy zasobów w witrynie Azure Portal:

1. Przejdź do projektu w usłudze Azure AI Foundry. Następnie wybierz pozycję Centrum zarządzania w okienku po lewej stronie.

2. W obszarze nagłówka Project (Projekt) wybierz pozycję Overview (Przegląd).

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

   

4. Teraz powinien znajdować się w witrynie Azure Portal, wyświetlając zawartość grupy zasobów, w której wdrożono centrum. 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że to wiązać się z kosztami w zależności od wybranego planu cenowego. Po zakończeniu pracy z aplikacją możesz usunąć ją z witryny Azure Portal.

Aby wdrożyć aplikację internetową:

Uwaga

Aby móc wdrożyć aplikację internetową, musisz mieć zarejestrowanego dostawcę zasobów Microsoft.Web w wybranej subskrypcji.

1. Wykonaj kroki opisane w poprzedniej sekcji, aby dodać dane do placu zabaw.

   Uwaga

   Aplikację internetową można wdrożyć z własnymi danymi lub bez tych danych, ale przynajmniej potrzebujesz wdrożonego modelu zgodnie z opisem w przewodniku Szybki start platformy Azure AI Foundry.

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.
   • Grupa zasobów: wybierz grupę zasobów, w której chcesz wdrożyć aplikację internetową. Możesz użyć tej samej grupy zasobów co centrum.
   • Lokalizacja: wybierz lokalizację, w której ma zostać wdrożona aplikacja internetowa. Możesz użyć 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 będą mieli 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, co może potrwać kilka minut.

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

Konfigurowanie uwierzytelniania aplikacji internetowej

Domyślnie aplikacja internetowa będzie dostępna tylko dla Ciebie. W tym samouczku dodasz uwierzytelnianie w celu ograniczenia dostępu do aplikacji do członków dzierżawy platformy Azure. Użytkownicy są proszeni o zalogowanie się przy użyciu konta Microsoft Entra w celu uzyskania dostępu do aplikacji. Jeśli wolisz, możesz wykonać podobny proces, aby dodać innego dostawcę tożsamości. Aplikacja nie używa informacji logowania użytkownika w inny sposób niż weryfikowanie, czy jest członkiem dzierżawy.

1. Wróć do karty przeglądarki zawierającej witrynę Azure Portal (lub otwórz ponownie witrynę Azure Portal na nowej karcie przeglądarki) i wyświetl zawartość grupy zasobów, w której wdrożono centrum i aplikację internetową (może być konieczne odświeżenie widoku zobacz 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. 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

Prawie gotowe. Teraz możesz przetestować aplikację internetową.

1. Poczekaj 10 minut lub tak, aby ustawienia uwierzytelniania zaczęły obowiązywać.

2. Wróć do karty przeglądarki zawierającej stronę placu zabaw czatu w portalu usługi Azure AI Foundry.

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

   Jeśli ustawienia uwierzytelniania nie zostały jeszcze zastosowane, zamknij kartę przeglądarki dla aplikacji internetowej i wróć do placu zabaw czatu w portalu Azure AI Foundry. Następnie zaczekaj trochę dłużej i spróbuj ponownie.

4. W aplikacji internetowej możesz zadać to samo pytanie, co wcześniej ("Ile to 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.

   

Informacje o historii czatów

Dzięki funkcji historii czatów użytkownicy będą mieli dostęp do poszczególnych poprzednich zapytań i odpowiedzi.

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

Ważne

Włączenie historii czatów spowoduje utworzenie wystąpienia usługi Cosmos DB w grupie zasobów i naliczenie dodatkowych opłat za używany magazyn. Usunięcie aplikacji internetowej nie powoduje automatycznego usunięcia wystąpienia usługi Cosmos DB. Aby usunąć wystąpienie usługi Cosmos DB wraz ze wszystkimi przechowywanymi czatami, musisz przejść do skojarzonego zasobu w witrynie Azure Portal i usunąć go.

Po włączeniu historii czatów użytkownicy będą mogli je wyświetlać i ukrywać w prawym górnym rogu aplikacji. Gdy historia jest wyświetlana, mogą zmieniać nazwy lub usuwać konwersacje. Po zalogowaniu się do aplikacji konwersacje będą automatycznie uporządkowane od najnowszych do najstarszych i nazwane 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 będą powiadamiani o błędzie połączenia, ale mogą nadal korzystać z aplikacji internetowej bez dostępu do historii czatów.

Czyszczenie zasobów

Aby uniknąć ponoszenia niepotrzebnych kosztów platformy Azure, usuń zasoby utworzone w tym przewodniku Szybki start, jeśli nie są już potrzebne. Aby zarządzać zasobami, możesz użyć witryny Azure Portal.

Powiązana zawartość

• Wprowadzenie do tworzenia aplikacji czatu przy użyciu zestawu SDK przepływu monitów
• Tworzenie niestandardowej aplikacji do czatów przy użyciu zestawu AZURE AI SDK.