Praca z rozszerzeniem Microsoft Foundry for Visual Studio Code

Z tego artykułu dowiesz się, jak zainstalować rozszerzenie Microsoft Foundry dla programu Visual Studio Code i korzystać z niego. Twórz projekty, wdrażaj modele z katalogu modeli Foundry i korzystaj z placów zabaw dla modeli z poziomu programu VS Code.

Ważna

Elementy oznaczone jako (wersja zapoznawcza) w tym artykule są aktualnie 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ą nie być obsługiwane lub mogą mieć ograniczone możliwości. Aby uzyskać więcej informacji, zobacz Warunki dodatkowe korzystania z testowych wersji Microsoft Azure.

Wymagania wstępne

• Subskrypcja platformy Azure. Utwórz je bezpłatnie.
• Zainstalowany program Visual Studio Code .
• Twoja subskrypcja musi być poniżej limitu przydziału , aby wdrożyć nowy model w tym artykule. Jeśli limit przydziału został już osiągnięty, musisz mieć wdrożony model czatu.
• Odpowiednie uprawnienia RBAC do tworzenia zasobów Foundry i zarządzania nimi. Aby uzyskać więcej informacji, zobacz Kontrola dostępu oparta na rolach dla rozwiązania Foundry.

Instalowanie rozszerzenia

Aby użyć funkcji foundry w programie VS Code, zainstaluj rozszerzenie Foundry for 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 programie Visual Studio Code.
4. Po zakończeniu instalacji otwórz program 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 programu 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 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 platformy Azure

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

Uwaga / Notatka

Aby uzyskać pełną listę funkcji dostępnych w rozszerzeniu, użyj palety poleceń. Wybierz F1 , aby otworzyć paletę poleceń i wyszukać plik Foundry. Poniższy zrzut ekranu przedstawia niektóre z dostępnych poleceń.

Zaloguj się do zasobów

Zaloguj się do subskrypcji platformy Azure, aby rozszerzenie może uzyskiwać dostęp do projektów foundry i wdrożonych modeli.

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

2. Wybierz pozycję Zaloguj się do platformy Azure... w widoku Zasoby platformy Azure .

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

4. Wybierz opcję Foundry i kliknij prawym przyciskiem myszy na projekcie.

5. Wybierz 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.

Nawigowanie po interfejsie rozszerzenia

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

Section	Co zawiera	Kiedy go użyć
Zasoby	Wdrożone modele, agenci deklaratywni, agenci hostowani, połączenia i magazyny wektorowe dla projektu Foundry.	Wyświetlanie zasobów projektu i zarządzanie nimi.
Narzędzia	Katalog modeli, obiekt testowy dla modeli, obiekt testowy dla agentów (zdalny i lokalny), lokalny wizualizator i wdróż hostowanych agentów.	Wdrażanie nowych modeli, monitów testowych i interakcja z agentami.
Pomoc i opinie	Dokumentacja, repozytorium GitHub, zasady zachowania poufności informacji firmy Microsoft 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 platformy Azure w polu tekstowym Wprowadź nową grupę zasobów 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 Project deployed successfully (Projekt został 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 projekt Foundry i wybierz opcję Przełącz projekt domyślny w rozszerzeniu platformy Azure .

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 firmy 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 F1 , aby otworzyć paletę poleceń.

2. Enter Foundry: Otwórz katalog modeli i naciśnij Enter.

3. Zostanie otwarta strona Wykaz modeli .

   

4. Filtruj Katalog Modeli według hosta, wydawcy, funkcji lub typu modelu, korzystając z menu rozwijanych w górnej części strony. Wybierz przełącznik Obsługa dostrajania, aby odfiltrować modele wspierające 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: odsyłacz URI do celu, typ uwierzytelniania i klucz.
• Przydatne linki: repozytorium z przykładowym kodem i linki do samouczków do 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ład w Pythonie, który wykonuje synchroniczne wywołanie API odpowiedzi.

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 otwiera się.

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:

Problematyka	Rezolucja
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 platformy Azure ma odpowiednie uprawnienia. Spróbuj wylogować się i zalogować się ponownie z widoku Zasoby platformy Azure .
Wdrażanie modelu nie powiodło się z powodu błędu limitu.	Sprawdź limit przydziału subskrypcji i zażądaj zwiększenia lub usunięcia nieużywanych wdrożeń.

Uprzątnij zasoby

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.

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

Dalsze kroki

• Eksplorowanie modeli odlewni
• Wdrażanie modeli za pomocą rozwiązania Foundry