Przygotowywanie środowiska projektowego

Skonfiguruj środowisko deweloperskie do korzystania z zestawu SDK usługi Microsoft Foundry. Musisz również użyć Azure CLI do uwierzytelniania, aby kod mógł uzyskiwać dostęp do swoich poświadczeń użytkownika.

W tym artykule zainstalujesz środowiska uruchomieniowe języka, Azure CLI, Azure Developer CLI, rozszerzenie Foundry do VS Code oraz Git.

Ważne

W tym artykule opisano tylko ogólne wymagania wstępne , takie jak środowiska uruchomieniowe języka, narzędzia globalne oraz konfiguracja programu VS Code i rozszerzenia.
Nie obejmuje on kroków specyficznych dla scenariusza, takich jak instalacja lub uwierzytelnianie zestawu SDK.
Gdy środowisko jest gotowe, przejdź do szybkiego startu aby wykonać te instrukcje.

Wymagania wstępne

  • Konto Azure z aktywną subskrypcją. Jeśli go nie masz, utwórz konto free Azure, które obejmuje subskrypcję bezpłatnej wersji próbnej.

  • Pobierz, zainstaluj i skonfiguruj Visual Studio Code lub wybrane środowisko IDE. Aby uzyskać więcej informacji, zobacz Pobierz Visual Studio Code.

  • Aby utworzyć zasoby usługi Foundry i zarządzać nimi, należy posiadać jedną z następujących ról kontroli dostępu opartej na rolach Azure.

    • Foundry Project Manager (do zarządzania projektami Foundry)

      Ważne

      Niedawno zmieniono nazwy ról RBAC w usłudze Foundry. Użytkownik Foundry, właściciel Foundry, właściciel konta Foundry i menedżer projektu Foundry były wcześniej nazywane odpowiednio użytkownikiem Azure AI, właścicielem Azure AI, właścicielem konta Azure AI i menedżerem projektu Azure AI. Poprzednie nazwy mogą być nadal widoczne w niektórych miejscach, podczas gdy zmiana nazwy jest wdrażana. Identyfikatory ról i uprawnienia podstawowe są niezmienione przez zmianę nazwy.

    • Właściciel (w przypadku uprawnień na poziomie subskrypcji). Właściciel jest niezbędny do dodatkowego przydzielenia ról wymaganego w innych scenariuszach w Foundry. Aby upewnić się, że wszystkie scenariusze w rozwiązaniu Foundry są dla Ciebie odblokowane, wymagane jest przypisanie roli „Owner”.

  • Aby korzystać z projektu, ale nie tworzyć nowych zasobów, potrzebne są co najmniej następujące elementy:

    • Użytkownik usługi Foundry w projektach używanych (rola z najmniejszymi uprawnieniami do programowania)

    Aby uzyskać szczegółowe informacje na temat uprawnień poszczególnych ról, zobacz Kontrola dostępu oparta na rolach dla Microsoft Foundry.

Instalowanie języka programowania

W Visual Studio Code utwórz nowy folder dla projektu. Otwórz okno terminalu w tym folderze.

Najpierw utwórz nowe środowisko Python. Nie instaluj pakietów w instalacji globalnej Python. Zawsze używaj środowiska wirtualnego lub conda podczas instalowania pakietów Python. W przeciwnym razie możesz przerwać globalną instalację Python.

W razie potrzeby zainstaluj Python

Użyj Python 3.10 lub nowszej, ale wymagana jest co najmniej Python 3.9. Jeśli nie masz zainstalowanej odpowiedniej wersji Python, postępuj zgodnie z instrukcjami w VS Code Python Tutorial aby uzyskać najprostszy sposób instalowania Python w systemie operacyjnym.

Tworzenie środowiska wirtualnego

Jeśli masz już zainstalowany program Python 3.10 lub nowszy, utwórz środowisko wirtualne przy użyciu następujących poleceń:

py -3 -m venv .venv
.venv\scripts\activate

Po aktywowaniu środowiska Python uruchomienie python lub pip z wiersza polecenia używa interpretera Python w folderze .venv aplikacji.

Uwaga

Użyj polecenia deactivate, aby zamknąć środowisko wirtualne Python. Możesz ją ponownie uaktywnić później w razie potrzeby.

Instalowanie rozszerzenia Python dla Visual Studio Code

Rozszerzenie Python dla Visual Studio Code obsługuje Python z funkcją IntelliSense, debugowaniem, formatowaniem, lintingiem, nawigacją kodu, refaktoryzowaniem, eksploratorem zmiennych, eksploratorem testów i zarządzaniem środowiskiem.

Zainstaluj rozszerzenie Python dla Visual Studio Code.

Zainstalować:

  • zestaw Java Development Kit (JDK) 17 lub nowszy

Instalowanie pakietu rozszerzeń Visual Studio Code dla Java

Pakiet rozszerzeń dla Java to kolekcja popularnych rozszerzeń, które mogą ułatwić pisanie, testowanie i debugowanie aplikacji Java w Visual Studio Code.

Zainstaluj pakiet rozszerzeń Visual Studio Code dla Java.

Zainstaluj Node.js (zalecana jest wersja 20 lub nowsza).

Upewnij się, że masz zainstalowane narzędzia niezbędne do programowania .NET.

Instalowanie zestawu SDK .NET

Potrzebujesz zestawu SDK .NET (Software Development Kit) do tworzenia, kompilowania i uruchamiania aplikacji .NET. Zalecamy zainstalowanie najnowszej wersji LTS (długoterminowej pomocy technicznej) lub nowszej, jeśli jest to wymagane przez projekt.

  1. Pobierz pakiet SDK .NET z oficjalnej strony pobierania .NET. Wybierz odpowiedni instalator dla systemu operacyjnego (Windows, Linux lub macOS).

  2. Postępuj zgodnie z instrukcjami instalacji systemu operacyjnego.

  3. Zweryfikuj instalację, otwierając terminal lub wiersz polecenia i uruchamiając polecenie:

    dotnet --version

    Odpowiedź powinna być zainstalowaną wersją zestawu SDK.

Instalowanie zestawu deweloperskiego języka C# dla Visual Studio Code

Aby uzyskać najlepsze środowisko programistyczne języka C# w programie VS Code, zainstaluj oficjalne rozszerzenie zestawu deweloperskiego języka C#:

  1. Otwórz Visual Studio Code.
  2. Przejdź do widoku Rozszerzenia (Ctrl+Shift+X lub Cmd+Shift+X).
  3. Wyszukaj zestaw deweloperski języka C#.
  4. Zainstaluj rozszerzenie opublikowane przez Microsoft. Spowoduje to również zainstalowanie podstawowego rozszerzenia języka C#, jeśli jeszcze go nie masz.

Utwórz nowy projekt .NET

Nowy projekt .NET można utworzyć przy użyciu terminalu zintegrowanego z Visual Studio Code (Terminal > Nowy terminal).

Aby na przykład utworzyć nową aplikację konsolową:

# Navigate to the directory where you want to create your project
# cd path/to/your/projects

# Create a new console application in a subfolder named MyConsoleApp
dotnet new console -o MyConsoleApp

# Navigate into the newly created project folder
cd MyConsoleApp

Teraz możesz otworzyć ten MyConsoleApp folder w programie VS Code (plik > otwórz folder...), aby rozpocząć pracę nad projektem języka C#. Program VS Code z rozszerzeniem C# Dev Kit automatycznie wykryje projekt, włączając funkcje, takie jak IntelliSense, debugowanie i zadania kompilacji.

Instalowanie Azure CLI i logowanie

Zainstalujesz Azure CLI i zalogujesz się z lokalnego środowiska deweloperskiego, aby kod mógł używać poświadczeń użytkownika do wywoływania usług Azure za pośrednictwem rozwiązania Foundry.

W większości przypadków można zainstalować Azure CLI z poziomu terminalu przy użyciu następującego polecenia:

winget install -e --id Microsoft.AzureCLI

Możesz postępować zgodnie z instrukcjami Jak zainstalować Azure CLI jeśli te polecenia nie działają w danym systemie operacyjnym lub w konfiguracji.

Po zainstalowaniu Azure CLI zaloguj się przy użyciu polecenia az login i zaloguj się przy użyciu przeglądarki:

az login

Alternatywnie możesz zalogować się ręcznie za pośrednictwem przeglądarki przy użyciu kodu urządzenia.

az login --use-device-code

Pozostaw ten terminal otwarty, aby uruchamiać skrypty po zalogowaniu.

Zainstaluj Azure Developer CLI

Interfejs wiersza polecenia dewelopera Azure (azd) to narzędzie typu open source, które ułatwia konfigurowanie i wdrażanie zasobów aplikacji na Azure. Udostępnia proste polecenia dla kluczowych etapów rozwoju, niezależnie od tego, czy używasz terminalu, środowiska IDE, czy potoków CI/CD. Zainstaluj interfejs wiersza polecenia dewelopera Azure dla swojej platformy.

Wiele szablonów rozwiązań sztucznej inteligencji obejmuje opcję wdrożenia przy użyciu polecenia azd.

Instalowanie rozszerzenia Foundry VS Code

Rozszerzenie Foundry dla Visual Studio Code umożliwia wdrażanie modeli, tworzenie aplikacji sztucznej inteligencji i pracę z agentami bezpośrednio z interfejsu programu VS Code. Zainstaluj rozszerzenie programu VS Code usługi Foundry.

Instalowanie usługi Git

Usługa Git jest wymagana do klonowania przykładów zestawu SDK usługi Foundry. Jeśli nie masz zainstalowanego narzędzia Git, postępuj zgodnie z instrukcjami dotyczącymi platformy i wybierz system operacyjny.

Rozwiązywanie problemów

Kwestia Rozdzielczość
Nie można odnaleźć polecenia po zainstalowaniu Zamknij i otwórz ponownie terminal lub uruchom ponownie program VS Code, aby zmiany PATH zaczęły obowiązywać.
az login kończy się niepowodzeniem z powodu błędu przeglądarki Uruchom polecenie az login --use-device-code , aby uwierzytelnić się przy użyciu przepływu kodu urządzenia.
nie można odnaleźć Python Użyj python3 zamiast python w systemie macOS/Linux lub zainstaluj obsługiwaną wersję (3.9 lub nowszą).
Odmowa uprawnień podczas instalacji Na macOS/Linux unikaj sudo pip install. Zamiast tego użyj środowiska wirtualnego .

Powiązana zawartość

  • Dokumentacja referencyjna zestawu SDK .NET
  • Dokumentacja referencyjna zestawu SDK Java
  • Last updated on