Samouczek: część 1 — tworzenie zasobów na potrzeby tworzenia niestandardowej aplikacji czatu przy użyciu zestawu SDK przepływu monitów
W tym samouczku użyjesz zestawu SDK przepływu monitów (i innych bibliotek) do kompilowania, konfigurowania, oceniania i wdrażania aplikacji czatu dla firmy zajmującej się sprzedażą detaliczną o nazwie Contoso Trek. Twoja firma detaliczna specjalizuje się w sprzęcie kempingowym na świeżym powietrzu i odzieży. Aplikacja do czatu powinna odpowiadać na pytania dotyczące produktów i usług. Na przykład aplikacja do czatu może odpowiedzieć na pytania, takie jak "który namiot jest najbardziej wodoodporny?" lub "jaki jest najlepszy śpiwór do zimnej pogody?".
Ten samouczek jest częścią jednego z trzech części samouczka. W tej części pokazano, jak administrator subskrypcji platformy Azure tworzy i konfiguruje zasoby potrzebne w dwóch i trzech częściach serii samouczków. W dwóch i trzech częściach pokazano, jak deweloper korzysta z zasobów. W wielu organizacjach ta sama osoba może przejąć obie te role. Z tej części dowiesz się, jak wykonywać następujące działania:
- Tworzenie centrum usługi Azure AI Studio
- Tworzenie projektu
- Tworzenie indeksu usługi Azure AI Search
- Konfigurowanie dostępu dla zasobów usługi Azure AI Studio i usługi Azure AI Search
Jeśli wykonano inne samouczki lub przewodniki Szybki start, niektóre zasoby potrzebne do tego samouczka mogły już zostać utworzone. Jeśli masz, możesz pominąć te kroki tutaj.
Ten samouczek jest częścią jednego z trzech części samouczka.
Wymagania wstępne
- Konto platformy Azure z aktywną subskrypcją. Jeśli go nie masz, utwórz bezpłatne konto.
Ważne
Musisz mieć uprawnienia niezbędne do dodawania przypisań ról w subskrypcji platformy Azure. Przyznawanie uprawnień przez przypisanie roli jest dozwolone tylko przez właściciela określonych zasobów platformy Azure. Może być konieczne zwrócenie się do właściciela subskrypcji platformy Azure (który może być administratorem IT), aby ukończyć ten samouczek.
Azure AI Studio i Witryna Azure Portal
W tym samouczku użyjesz zasobów platformy Azure do utworzenia aplikacji do czatu. Użyjesz programu Azure AI Studio i witryny Azure Portal do utworzenia i skonfigurowania tych zasobów.
- Jako administrator możesz skonfigurować dostęp do zasobów przy użyciu witryny Azure Portal.
- Jako deweloper używasz usługi Azure AI Studio do grupowania tych zasobów potrzebnych do kompilowania, oceniania i wdrażania aplikacji do czatu. Możesz również wchodzić w interakcje z modelami i wdrożeniami w programie AI Studio.
Tworzenie centrum usługi Azure AI Studio
Aby utworzyć centrum w usłudze Azure AI Studio, wykonaj następujące kroki:
Przejdź do strony głównej programu Azure AI Studio i zaloguj się przy użyciu konta platformy Azure.
Wybierz pozycję Wszystkie koncentratory w okienku po lewej stronie, a następnie wybierz pozycję + Nowe centrum.
W oknie dialogowym Tworzenie nowego centrum wprowadź nazwę centrum (np. contoso-hub), a następnie wybierz przycisk Dalej. Pozostaw wybraną opcję Połącz usługi Azure AI Services. Dla centrum jest tworzone nowe połączenie usług sztucznej inteligencji.
Przejrzyj informacje i wybierz pozycję Utwórz.
Postęp tworzenia koncentratora można wyświetlić w kreatorze.
Tworzenie projektu
Aby utworzyć projekt w usłudze Azure AI Studio, wykonaj następujące kroki:
- Przejdź do strony głównej programu Azure AI Studio.
- Wybierz pozycję + Nowy projekt.
- Wprowadź nazwę dla projektu.
- Wybierz centrum utworzone w poprzednim kroku.
Po utworzeniu projektu można uzyskać dostęp do placu zabaw, narzędzi i innych zasobów w panelu nawigacyjnym po lewej stronie.
Tworzenie indeksu usługi Azure AI Search
Celem tej aplikacji jest uziemienie odpowiedzi modelu w danych niestandardowych. Indeks wyszukiwania służy do pobierania odpowiednich dokumentów na podstawie pytania użytkownika.
Aby utworzyć indeks wyszukiwania, potrzebujesz usługa wyszukiwania i połączenia usługi Azure AI.
Uwaga
Tworzenie usługa wyszukiwania sztucznej inteligencji platformy Azure i kolejnych indeksów wyszukiwania wiąże się z kosztami. Szczegółowe informacje na temat cen i warstw cenowych dla usługi Azure AI usługa wyszukiwania można znaleźć na stronie tworzenia, aby potwierdzić koszt przed utworzeniem zasobu.
Tworzenie usługa wyszukiwania sztucznej inteligencji platformy Azure
Jeśli masz już usługa wyszukiwania usługi Azure AI, możesz przejść do następnej sekcji.
W przeciwnym razie możesz utworzyć usługa wyszukiwania usługi Azure AI przy użyciu witryny Azure Portal.
- Tworzenie usługa wyszukiwania usługi Azure AI w witrynie Azure Portal.
- Wybierz grupę zasobów i szczegóły wystąpienia. Szczegółowe informacje o cenach i warstwach cenowych można zobaczyć na tej stronie.
- Kontynuuj pracę kreatora i wybierz pozycję Przejrzyj i przypisz , aby utworzyć zasób.
- Potwierdź szczegóły usługa wyszukiwania usługi Azure AI, w tym szacowany koszt.
- Wybierz pozycję Utwórz, aby utworzyć usługa wyszukiwania usługi Azure AI.
Łączenie usługi Azure AI Search z projektem
Jeśli masz już połączenie usługi Azure AI Search w projekcie, możesz przejść do konfigurowania dostępu do usługi Azure AI usługa wyszukiwania.
W narzędziu Azure AI Studio sprawdź połączony zasób usługi Azure AI Search.
- W programie AI Studio przejdź do projektu i wybierz pozycję Ustawienia w okienku po lewej stronie.
- W sekcji Połączone zasoby sprawdź, czy masz połączenie typu Azure AI Search.
- Jeśli masz połączenie usługi Azure AI Search, możesz przejść dalej, aby skonfigurować dostęp do zasobów.
- W przeciwnym razie wybierz pozycję Nowe połączenie , a następnie pozycję Azure AI Search.
- Znajdź usługa wyszukiwania usługi Azure AI w opcjach i wybierz pozycję Dodaj połączenie.
- Kontynuuj pracę kreatora, aby utworzyć połączenie. Aby uzyskać więcej informacji na temat dodawania połączeń, zobacz ten przewodnik z instrukcjami.
Konfigurowanie dostępu dla zasobów
W tej sekcji pokazano, jak skonfigurować różne mechanizmy kontroli dostępu wymagane dla zasobów utworzonych w poprzednich sekcjach.
Zalecamy używanie identyfikatora Entra firmy Microsoft zamiast używania kluczy interfejsu API. Aby korzystać z tego uwierzytelniania, należy ustawić odpowiednie mechanizmy kontroli dostępu i przypisać odpowiednie role dla usług.
Konfigurowanie dostępu dla usług Azure AI
Rozpocznij w projekcie, aby znaleźć zasób usług sztucznej inteligencji:
- W programie AI Studio przejdź do projektu i wybierz pozycję Ustawienia w okienku po lewej stronie.
- Wybierz pozycję Połączone zasoby.
- Wybierz nazwę usługi AI Services lub Azure OpenAI na liście połączonych zasobów, aby otworzyć stronę szczegółów zasobu. Następnie ponownie wybierz nazwę zasobu na stronie Szczegóły połączenia, która otwiera zasób w witrynie Azure Portal.
Określ kontrolę dostępu w witrynie Azure Portal:
- Na lewej stronie w witrynie Azure Portal wybierz pozycję Kontrola dostępu (IAM)>+ Dodaj>przypisanie roli.
- Wyszukaj rolę Użytkownik openAI usług Cognitive Services, a następnie wybierz ją. Następnie kliknij przycisk Dalej.
- Wybierz pozycję Użytkownik, grupa lub jednostka usługi. Następnie wybierz pozycję Wybierz członków.
- W otwartym okienku Wybierz członków wyszukaj nazwę użytkownika, dla którego chcesz dodać przypisanie roli. Wybierz użytkownika, a następnie wybierz pozycję Wybierz.
- Kontynuuj pracę kreatora i wybierz pozycję Przejrzyj i przypisz , aby dodać przypisanie roli.
Konfigurowanie dostępu do usługi Azure AI Search
Teraz wróć do ustawień programu AI Studio> Połączonych zasobów. Tym razem wybierz nazwę usługi Azure AI Search na liście połączonych zasobów, aby otworzyć stronę szczegółów zasobu. Następnie ponownie wybierz nazwę zasobu na stronie Szczegóły połączenia, która otwiera zasób w witrynie Azure Portal.
Aby włączyć kontrolę dostępu opartą na rolach dla usługa wyszukiwania usługi Azure AI, wykonaj następujące kroki:
W usługa wyszukiwania usługi Azure AI w witrynie Azure Portal wybierz pozycję Klucze ustawień > w okienku po lewej stronie.
Wybierz pozycję Oba, aby upewnić się, że klucze interfejsu API i kontrola dostępu oparta na rolach są włączone dla usługa wyszukiwania usługi Azure AI.
Ostrzeżenie
Możesz użyć kontroli dostępu opartej na rolach lokalnie, ponieważ uruchomisz az login je w dalszej części tej serii samouczków. Jednak podczas wdrażania aplikacji w części 3 samouczka wdrożenie jest uwierzytelniane przy użyciu kluczy interfejsu API z usługa wyszukiwania usługi Azure AI. Obsługa uwierzytelniania identyfikatora Entra firmy Microsoft dla wdrożenia jest dostępna wkrótce. Na razie należy włączyć zarówno klucze, jak i punkty końcowe.
Następnie przyznaj tożsamość użytkownika (lub tożsamość dewelopera, który ukończy dwie i trzy części) role Współautor danych indeksu wyszukiwania i Współautor usługi wyszukiwania w usłudze Azure AI usługa wyszukiwania. Te role umożliwiają wywoływanie usługi Azure AI usługa wyszukiwania skojarzonej tożsamości użytkownika.
Nadal w witrynie Azure Portal dla usługi Azure AI usługa wyszukiwania przypisz rolę Współautor danych indeksu wyszukiwania do usługa wyszukiwania usługi Azure AI. (Są to te same kroki, które wykonaliśmy wcześniej w przypadku usługi Azure OpenAI).
- Na lewej stronie w witrynie Azure Portal wybierz pozycję Kontrola dostępu (IAM)>+ Dodaj>przypisanie roli.
- Wyszukaj rolę Współautor danych indeksu wyszukiwania, a następnie wybierz ją. Następnie kliknij przycisk Dalej.
- Wybierz pozycję Użytkownik, grupa lub jednostka usługi. Następnie wybierz pozycję Wybierz członków.
- W otwartym okienku Wybierz członków wyszukaj nazwę użytkownika, dla którego chcesz dodać przypisanie roli. Wybierz użytkownika, a następnie wybierz pozycję Wybierz.
- Kontynuuj pracę kreatora i wybierz pozycję Przejrzyj i przypisz , aby dodać przypisanie roli.
Powtórz te kroki, aby również dodać rolę Współautor usługi wyszukiwania do usługa wyszukiwania usługi Azure AI.
Teraz możesz przekazać projekt deweloperowi w celu utworzenia aplikacji do czatu. Deweloper użyje zestawu SDK przepływu monitów, aby skompilować, skonfigurować, ocenić i wdrożyć aplikację czatu dla firmy zajmującej się sprzedażą detaliczną o nazwie Contoso Trek.
Czyszczenie zasobów
Aby uniknąć niepotrzebnych kosztów platformy Azure, usuń zasoby utworzone w tym samouczku, jeśli nie są już potrzebne. Aby zarządzać zasobami, możesz użyć witryny Azure Portal.
Ale nie usuwaj ich jeszcze, jeśli chcesz utworzyć aplikację czatu w następnej części tej serii samouczków.