Praca z Microsoft Foundry dla rozszerzenia Visual Studio Code

Z tego artykułu dowiesz się, jak zainstalować i używać rozszerzenia Microsoft Foundry dla rozszerzenia Visual Studio Code. Tworzenie projektów, wdrażanie modeli z katalogu modeli Foundry oraz interakcja ze środowiskami testowymi modeli w programie VS Code.

Wymagania wstępne

Instalowanie rozszerzenia

Aby użyć funkcji foundry w programie VS Code, zainstaluj rozszerzenie Foundry dla Visual Studio Code. Zainstaluj z witryny Visual Studio Code Marketplace lub bezpośrednio z poziomu programu VS Code.

Instalowanie z witryny Visual Studio Code Marketplace

Użyj witryny Marketplace, aby zainstalować rozszerzenie bez wcześniejszego otwierania programu VS Code.

  1. Otwórz stronę rozszerzenia Foundry for Visual Studio Code.
  2. Wybierz przycisk Zainstaluj .
  3. Postępuj zgodnie z monitami, aby zainstalować rozszerzenie w Visual Studio Code.
  4. Po zakończeniu instalacji otwórz Visual Studio Code i sprawdź, czy rozszerzenie zostało pomyślnie zainstalowane z komunikatów o stanie.
  5. Ikona Foundry jest wyświetlana na podstawowym pasku nawigacyjnym po lewej stronie programu VS Code.

Instalowanie z poziomu Visual Studio Code

Alternatywnie wyszukaj rozszerzenie bezpośrednio z widoku rozszerzeń programu VS Code.

  1. Otwórz program VS Code.

  2. Wybierz pozycję Rozszerzenia w okienku po lewej stronie.

  3. Wybierz ikonę Ustawienia w prawym górnym rogu okienka rozszerzeń.

  4. Wyszukaj i wybierz Foundry.

  5. Wybierz pozycję Zainstaluj.

  6. Po zakończeniu instalacji komunikat o stanie potwierdza zainstalowanie rozszerzenia. Ikona Foundry zostanie wyświetlona na pasku nawigacyjnym po lewej stronie.

Nawiązywanie połączenia z zasobami Azure

Po zainstalowaniu rozszerzenia zaloguj się do subskrypcji Azure i otwórz projekt Foundry, aby rozpocząć pracę z modelami, agentami i placami zabaw.

Uwaga

Aby uzyskać pełną listę funkcji dostępnych w rozszerzeniu, użyj palety poleceń. Wybierz klawisz F1 , aby otworzyć paletę poleceń i wyszukać plik Foundry. Poniższy zrzut ekranu przedstawia niektóre z dostępnych poleceń. Zrzut ekranu przedstawiający paletę poleceń programu VS Code z dostępnymi poleceniami programu Foundry, takimi jak Open Model Catalog i Open Playground.

Zaloguj się do zasobów

Zaloguj się do swojej subskrypcji Azure, aby rozszerzenie mogło uzyskiwać dostęp do swoich projektów Foundry i wdrożonych modeli.

  1. Wybierz ikonę Azure na pasku nawigacyjnym programu VS Code.

  2. Wybierz pozycję Sign in to Azure... w widoku Azure Resources.

  3. W sekcji Resources0 wybierz subskrypcję Azure i grupę zasobów.

  4. Wybierz opcję Foundry, a następnie kliknij prawym przyciskiem myszy na twój projekt.

  5. Wybierz opcję Otwórz w rozszerzeniu Foundry.

    Zasoby projektu Foundry są wyświetlane w widoku rozszerzenia, a ikona Foundry jest wyświetlana na pasku nawigacyjnym programu VS Code.

Rozszerzenie Foundry organizuje obszar roboczy w trzy główne sekcje.

Zrzut ekranu przedstawiający interfejs rozszerzenia Foundry przedstawiający sekcje Zasoby, Narzędzia i Pomoc i Opinie.

Sekcja Co zawiera Kiedy należy go używać
Zasoby Wdrożone modele, agenci deklaratywne, hostowani agenci, połączenia i magazyny wektorowe dla projektu Foundry. Wyświetlanie zasobów projektu i zarządzanie nimi.
Narzędzia Katalog modeli, plac zabaw dla modelu, plac zabaw dla agentów (zdalny i lokalny), lokalny wizualizator i wdrażanie hostowanych agentów. Wdrażanie nowych modeli, monitów testowych i interakcja z agentami.
Pomoc i opinie Dokumentacja, repozytorium GitHub, Oświadczenie Microsoft dotyczące ochrony prywatności i linki społeczności. Uzyskaj pomoc lub przekaż opinię.

Tworzenie projektu

Utwórz nowy projekt Foundry bezpośrednio z rozszerzenia, aby zorganizować modele i zasoby.

  1. Wybierz ikonę znaku plus obok pozycji Zasoby w sekcji Zasoby widoku rozszerzenia Foundry.

    Możesz utworzyć nową grupę zasobów lub wybrać istniejącą.

  2. Aby utworzyć nową grupę zasobów:

    1. Wybierz pozycję Utwórz nową grupę zasobów i naciśnij klawisz Enter.

    2. Wprowadź nazwę grupy zasobów Azure w polu tekstowym Enter new resource group i naciśnij klawisz Enter.

    3. Wybierz lokalizację, której chcesz użyć z listy dostępnych lokalizacji, a następnie naciśnij klawisz Enter.

  3. Aby użyć istniejącej grupy zasobów:

    • Wybierz grupę zasobów, której chcesz użyć z listy dostępnych grup zasobów, a następnie naciśnij klawisz Enter.

  4. Wprowadź nazwę projektu Foundry w polu tekstowym Enter project name (Wprowadź nazwę projektu ) i naciśnij klawisz Enter.

Po wdrożeniu projektu zostanie wyświetlone okno podręczne z komunikatem Projekt pomyślnie wdrożony.

Aby wdrożyć model w nowo utworzonym projekcie, wybierz przycisk Wdróż model w oknie podręcznym. Ta akcja powoduje otwarcie strony Katalog modeli , na której można wybrać żądany model do wdrożenia.

Przełączanie projektu domyślnego

Po otwarciu projektu w rozszerzeniu Foundry ten projekt jest ustawiony jako projekt domyślny. Aby przełączyć projekt domyślny:

  1. Kliknij prawym przyciskiem myszy na projekt Foundry i wybierz opcję Przełącz domyślny projekt w Azure Extension.

  2. Wybierz projekt Foundry, którego chcesz użyć z listy dostępnych projektów, a następnie naciśnij klawisz Enter.

Wybrany projekt wyświetla teraz wartość Domyślna po nazwie projektu.

Wskazówka

Kliknij prawym przyciskiem myszy nazwę projektu, aby uzyskać dostęp do punktu końcowego projektu lub klucza interfejsu API projektu.

Praca z modelami

Rozszerzenie Foundry umożliwia odnajdywanie, wdrażanie i interakcję z modelami z katalogu modeli foundry bezpośrednio w programie VS Code.

Przeglądanie wykazu modeli

Wykaz modeli zapewnia dostęp do modeli z Microsoft, OpenAI, Meta, DeepSeek i innych dostawców. Wykaz modeli można otworzyć na kilka sposobów:

  • Uruchom polecenie Foundry: Otwórz katalog modeli z palety poleceń.
  • Wybierz ikonę znaku plus obok pozycji Modele w sekcji Zasoby widoku rozszerzenia Foundry.
  • Wybierz link Wykaz modeli w sekcji Narzędzia widoku rozszerzenia Foundry.

Otwieranie wykazu modeli z palety poleceń

Użyj palety poleceń, aby otworzyć wykaz modeli bez przechodzenia do widoku rozszerzenia.

  1. Wybierz klawisz F1 , aby otworzyć paletę poleceń.

  2. Wpisz Foundry: Open Model Catalog i naciśnij Enter.

  3. Zostanie otwarta strona Wykaz modeli .

    Zrzut ekranu przedstawiający stronę wykazu modeli w programie VS Code z kartami modelu z filtrami dla wydawcy i typu modelu.

  4. Przefiltruj katalog Model według Hosted by, Publisher, Feature lub Model type używając list rozwijanych w górnej części strony. Wybierz przełącznik Wsparcie dopasowywania, aby filtrować modele, które obsługują dostrajanie.

  5. Wyszukaj konkretny model przy użyciu paska wyszukiwania w górnej części strony.

Otwieranie wykazu modeli w sekcji Zasoby

W widoku rozszerzenia Foundry wybierz ikonę plus obok pozycji Modele , aby otworzyć wykaz modeli.

Wskazówka

Możesz również kliknąć prawym przyciskiem myszy pozycję Modele i wybrać pozycję Wdróż nowy model sztucznej inteligencji , aby przejść bezpośrednio do przepływu wdrażania.

Otwieranie wykazu modeli w sekcji Narzędzia

W sekcji Narzędzia widoku rozszerzenia Foundry kliknij dwukrotnie link Wykaz modeli .

Wdrażanie modelu z katalogu modeli

Po znalezieniu modelu w wykazie wdróż go w projekcie Foundry, aby móc go używać w aplikacjach.

  1. Wybierz przycisk Wdróż obok wybranej nazwy modelu.

  2. Zostanie otwarta strona Wdrażanie modelu .

  3. Wprowadź nazwę wdrożenia modelu w polu tekstowym Wprowadź nazwę wdrożenia i naciśnij klawisz Enter.

  4. Wybierz typ wdrożenia z listy rozwijanej Typ wdrożenia .

  5. Wybierz wersję modelu z listy rozwijanej Wersja modelu .

  6. (Opcjonalnie) Dostosuj tokeny na minutę za pomocą suwaka Tokeny na minutę .

  7. Wybierz przycisk Wdróż w narzędziu Foundry w lewym dolnym rogu.

  8. W oknie dialogowym potwierdzenia wybierz pozycję Wdróż.

  9. Po zakończeniu wdrażania model zostanie wyświetlony według nazwy wdrożenia w sekcji Modele w projekcie.

Wyświetlanie wdrożonych modeli i zarządzanie nimi

Rozwiń sekcję Modele w widoku rozszerzenia Foundry, aby wyświetlić wszystkie wdrożone modele w projekcie.

Wyświetlanie informacji o karcie modelu

Wybierz wdrożony model, aby otworzyć panel z następującymi szczegółami:

  • Informacje o wdrożeniu: nazwa, stan aprowizacji, typ wdrożenia, limit szybkości, informacje o wersji, nazwa modelu i wersja modelu.
  • Informacje o punkcie końcowym: link docelowego URI, typ uwierzytelniania i klucz.
  • Przydatne linki: repozytorium z przykładowym kodem i linki do szkoleń dotyczących tworzenia aplikacji sztucznej inteligencji.

Aktualizowanie ustawień wdrażania modelu

Aby zaktualizować ustawienia wdrożenia, takie jak limity szybkości:

  1. Wybierz przycisk Edytuj w prawym górnym rogu karty modelu.
  2. Zaktualizuj pola edytowalne.
  3. Wybierz przycisk Zapisz , aby zastosować zmiany.

Generowanie przykładowego kodu dla modelu

Wygeneruj plik kodu początkowego dla wdrożonego modelu, aby przyspieszyć tworzenie aplikacji.

  1. Kliknij prawym przyciskiem myszy wdrożony model i wybierz polecenie Otwórz plik kodu.

  2. Wybierz preferowany zestaw SDK z listy rozwijanej Wybierz preferowany zestaw SDK .

  3. Wybierz preferowany język na liście rozwijanej Wybierz język .

  4. Wybierz preferowaną metodę uwierzytelniania z listy rozwijanej Wybierz metodę uwierzytelniania .

  5. Przykładowy plik kodu zostanie otwarty na nowej karcie w programie VS Code.

Poniższy zrzut ekranu przedstawia wygenerowany przykładowy skrypt Pythona, który wykonuje synchroniczne wywołanie odpowiedzi API:

Zrzut ekranu wygenerowanego pliku przykładowego kodu Python pokazującego wywołanie synchroniczne API w VS Code.

Interakcja z modelami na placu zabaw

Użyj placu zabaw dla modelu, aby interaktywnie porozmawiać z wdrożonym modelem, dostosować ustawienia i zmodyfikować instrukcje systemowe.

Aby otworzyć plac zabaw, kliknij dwukrotnie link Model Playground w sekcji Narzędzia widoku rozszerzenia Foundry. Alternatywnie kliknij prawym przyciskiem myszy wdrożony model i wybierz polecenie Otwórz na placu zabaw.

  1. Strona Playground zostanie otwarta.

  2. Wpisz monit i przejrzyj dane wyjściowe.

  3. Wybierz pozycję Wyświetl kod w prawym górnym rogu, aby zobaczyć, jak programowo uzyskać dostęp do wdrożenia modelu.

  4. Wybierz link Historia w lewym górnym rogu placu zabaw, aby wyświetlić historię czatów.

Rozwiązywanie typowych problemów

Jeśli wystąpią problemy podczas korzystania z rozszerzenia Foundry, sprawdź następujące typowe problemy:

Kwestia Rozdzielczość
Rozszerzenie nie jest wyświetlane po instalacji Uruchom ponownie program VS Code i sprawdź, czy rozszerzenie jest włączone w widoku Rozszerzenia .
Logowanie kończy się niepowodzeniem lub subskrypcje nie są ładowane Sprawdź, czy twoje konto Azure ma odpowiednie uprawnienia. Spróbuj wylogować się i zalogować się ponownie z widoku zasobów Azure.
Wdrażanie modelu kończy się niepowodzeniem z powodu błędu przydziału Sprawdź limit przydziału subskrypcji i zażądaj zwiększenia lub usunięcia nieużywanych wdrożeń.

Czyszczenie zasobów

Za zasoby Azure utworzone w tym artykule są naliczane opłaty za subskrypcję Azure. Jeśli nie spodziewasz się, że te zasoby będą potrzebne w przyszłości, usuń je, aby uniknąć naliczania dodatkowych opłat.

Usuń swoje modele

  1. Na pasku nawigacyjnym programu VS Code odśwież rozszerzenie Foundry. W sekcji Zasoby rozwiń podsekcję Modele .

  2. Kliknij prawym przyciskiem myszy wdrożony model, który chcesz usunąć, a następnie wybierz polecenie Usuń.

Usuwanie zasobów Azure

Aby usunąć grupę zasobów i wszystkie zasoby w niej, wykonaj następujące elementy:

Ostrzeżenie

Usunięcie grupy zasobów trwale usuwa wszystkie zasoby w nim, w tym projekt Foundry i wszystkie wdrożone modele. Tej akcji nie można cofnąć.

  1. Otwórz portal Azure.
  2. Przejdź do grupy zasobów zawierającej projekt Foundry.
  3. Wybierz pozycję Usuń grupę zasobów i potwierdź usunięcie.

Następne kroki

  • Last updated on