Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
W tym artykule pokazano, jak wdrożyć i uruchomić bezserwerowy Szybki start asystenta Azure OpenAI. Ten przykład implementuje aplikację asystentów przy użyciu języka JavaScript, asystentów usługi Azure OpenAI z wywoływaniem funkcji i usługą Azure Functions.
Omówienie architektury
Asystenci usługi Azure OpenAI umożliwiają tworzenie asystentów sztucznej inteligencji dostosowanych do potrzeb za pomocą niestandardowych instrukcji i rozszerzonych przez zaawansowane narzędzia, takie jak interpreter kodu i funkcje niestandardowe. W tym artykule szczegółowo omawiamy, jak rozpocząć pracę z Assistants API.
Ta aplikacja jest oparta na dwóch głównych składnikach:
Prosta strona HTML z czystymi plikami CSS i JavaScript, hostowana w usłudze Azure Static Web Apps.
Bezserwerowy interfejs API utworzony przy użyciu Azure Functions i zestawu SDK OpenAI dla języka JavaScript. Aplikacja bezserwerowa wysyła definicję asystentów, w tym wywołanie funkcji do punktu końcowego openAI. Punkt końcowy odpowiada za pomocą wywołania funkcji kontynuacji i parametrów wymaganych do ukończenia tego wywołania.
- Wywołanie funkcji w przykładzie symuluje wywołanie interfejsu API przez wygenerowanie losowej wartości tickera giełdowego na podstawie symbolu akcji przesłanego do funkcji Azure. Tę symulację można zastąpić zdalnym interfejsem API w rozwiązaniu.
Wymagania wstępne
Środowisko kontenera programistycznego jest dostępne ze wszystkimi zależnościami wymaganymi do ukończenia tego artykułu. Kontener deweloperski można uruchomić w usłudze GitHub Codespaces (w przeglądarce) lub lokalnie przy użyciu programu Visual Studio Code.
Aby użyć tego artykułu, potrzebne są następujące wymagania wstępne:
- Subskrypcja platformy Azure — Utwórz bezpłatnie
- Uprawnienia konta Azure — Twoje konto Azure musi mieć uprawnienia Microsoft.Authorization/roleAssignments/write, takie jak Administrator dostępu użytkowników lub Właściciel.
- Konto usługi GitHub.
Otwieranie środowiska projektowego
Skorzystaj z poniższych instrukcji, aby wdrożyć wstępnie skonfigurowane środowisko programistyczne zawierające wszystkie wymagane zależności, aby ukończyć ten artykuł.
GitHub Codespaces uruchamia kontener programistyczny zarządzany przez GitHub, używając Visual Studio Code dla przeglądarki internetowej jako interfejsu użytkownika. W przypadku najprostszego środowiska programistycznego użyj usługi GitHub Codespaces, aby wstępnie zainstalować odpowiednie narzędzia deweloperskie i zależności, aby ukończyć ten artykuł.
Ważne
Wszystkie konta usługi GitHub mogą korzystać z usługi Codespaces przez maksymalnie 60 godzin bezpłatnych każdego miesiąca z dwoma podstawowymi wystąpieniami. Aby uzyskać więcej informacji, zobacz miesięczny limit uwzględnionej przestrzeni dyskowej i godzin rdzeni w usłudze GitHub Codespaces.
Rozpocznij proces tworzenia nowego środowiska GitHub Codespaces w gałęzi
mainrepozytorium GitHubAzure-Samples/azure-openai-assistant-javascript.Kliknij prawym przyciskiem myszy poniższy przycisk i wybierz pozycję Otwórz link w nowych oknach, aby mieć jednocześnie dostępne środowisko deweloperskie i dokumentację.
Na stronie Tworzenie przestrzeni kodu przejrzyj ustawienia konfiguracji przestrzeni kodu, a następnie wybierz pozycję Utwórz nową przestrzeń kodu
Poczekaj, aż codespace się uruchomi. Ten proces uruchamiania może potrwać kilka minut.
Zaloguj się na platformie Azure przy użyciu interfejsu wiersza polecenia dla deweloperów platformy Azure w terminalu w dolnej części ekranu.
azd auth loginSkopiuj kod z terminalu, a następnie wklej go w przeglądarce. Postępuj zgodnie z instrukcjami, aby uwierzytelnić się przy użyciu konta platformy Azure.
Pozostałe zadania w tym artykule mają miejsce w kontekście tego kontenera deweloperskiego.
Wdrażanie i uruchamianie
Przykładowe repozytorium zawiera wszystkie pliki kodu i konfiguracji potrzebne do wdrożenia aplikacji funkcji na platformie Azure. W poniższych krokach przedstawiono proces wdrażania przykładu na platformie Azure.
Wdrażanie aplikacji asystentów na platformie Azure
Ważne
Zasoby platformy Azure utworzone w tej sekcji powodują natychmiastowe koszty, głównie z zasobu usługi Wyszukiwanie AI platformy Azure. Te zasoby mogą generować koszty, nawet gdy przerywasz polecenie przed jego zakończeniem.
Uruchom następujące polecenie interfejsu wiersza polecenia dla deweloperów platformy Azure, aby aprowizować zasoby platformy Azure i wdrożyć kod źródłowy:
azd upGdy pojawi się monit o wprowadzenie nazwy środowiska, niech będzie ona krótka i zapisana małymi literami. Na przykład
myenv. Jest ona używana jako część nazwy grupy zasobów.Gdy zostanie wyświetlony monit, wybierz subskrypcję, w ramach której chcesz utworzyć zasoby.
Po wyświetleniu monitu o wybranie lokalizacji po raz pierwszy wybierz lokalizację w pobliżu. Ta lokalizacja jest używana dla większości zasobów, w tym hostingu.
Jeśli zostanie wyświetlony monit o lokalizację modelu OpenAI, wybierz lokalizację znajdującą się blisko Ciebie. Jeśli ta sama lokalizacja jest dostępna jako pierwsza lokalizacja, wybierz tę lokalizację.
Poczekaj na wdrożenie aplikacji. Ukończenie wdrożenia może potrwać od 5 do 10 minut.
Po pomyślnym wdrożeniu aplikacji w terminalu zostanie wyświetlony adres URL.
Wybierz ten adres URL oznaczony jako
Deploying service web, aby otworzyć aplikację asystenta w przeglądarce.
Korzystanie z aplikacji asystenta
Użyj aplikacji asystenta, aby uzyskać cenę akcji MSFT. Poniższe kroki przeprowadzą Cię przez proces korzystania z aplikacji asystenta. Asystent może wysłać Ci odpowiedzi w wiadomości e-mail. Ponieważ funkcja wysyłania wiadomości e-mail nie jest skonfigurowana, zmodyfikuj monit, aby nie używać tej instrukcji.
W przeglądarce skopiuj i wklej następujące polecenie:
Based on the latest financial data and current stock market trends, can you provide a detailed analysis of Microsoft's current state? Please include insights into their recent performance, market position, and future outlook. Additionally, retrieve and include the latest closing price of Microsoft's stock using its ticker symbol (MSFT).Wybierz przycisk Run (Uruchom). Wyniki powinny wyglądać podobnie do poniższej odpowiedzi.
Czyszczenie zasobów
Czyszczenie zasobów platformy Azure
Zasoby platformy Azure utworzone w tym artykule są rozliczane z subskrypcją platformy Azure. Jeśli nie spodziewasz się, że te zasoby będą potrzebne w przyszłości, usuń je, aby uniknąć naliczania dodatkowych opłat.
Uruchom następujące polecenie interfejsu wiersza polecenia dla deweloperów platformy Azure, aby usunąć zasoby platformy Azure i usunąć kod źródłowy:
azd down --purge
Czyszczenie usługi GitHub Codespaces
Usunięcie środowiska Usługi GitHub Codespaces gwarantuje, że możesz zmaksymalizować ilość bezpłatnych godzin na godziny korzystania z konta.
Ważne
Aby uzyskać więcej informacji na temat uprawnień konta GitHub, zobacz miesięczny limit uwzględnionej przestrzeni dyskowej i godzin rdzenia w usłudze GitHub Codespaces.
Zaloguj się do pulpitu nawigacyjnego usługi GitHub Codespaces .
Znajdź obecnie uruchomione środowiska Codespaces pochodzące z repozytorium GitHub
Azure-Samples/azure-openai-assistant-javascript.
Otwórz menu kontekstowe
...dla obszaru codespace, a następnie wybierz Usuń.
Uzyskaj pomoc
To przykładowe repozytorium oferuje informacje dotyczące rozwiązywania problemów.
Jeśli Twój problem nie został rozwiązany, zgłoś go w sekcji Issues repozytorium.