Przygotowywanie środowiska projektowego

Przygotuj środowisko deweloperskie do kompilacji przy użyciu Microsoft Foundry. Potrzebujesz obsługiwanego języka programowania, usługi Git i narzędzi deweloperskich foundry pasujących do przepływu pracy.

Wskazówka

Foundry DevPack jest zalecanym sposobem na zainstalowanie narzędzi deweloperskich za pomocą jednego polecenia. Można również zainstalować każde narzędzie oddzielnie.

Ważne

W tym artykule opisano ogólne wymagania wstępne i narzędzia deweloperskie. Nie obejmuje pakietów zestawu SDK specyficznych dla scenariusza ani kodu uwierzytelniania. Gdy środowisko jest gotowe, przejdź do przewodnika Szybki start.

Wymagania wstępne

Instalowanie pakietu DevPack w usłudze Foundry

Narzędzie Foundry DevPack instaluje narzędzia deweloperskie Foundry dla terminalu, edytora i agenta kodowania. Wybierz swój system operacyjny.

winget install Microsoft.FoundryDevPack

Pakiet DevPack instaluje swoje główne narzędzia i dodaje rozszerzenia dla hosta tylko wtedy, gdy obecne są odpowiednie aplikacje:

Narzędzie Co możesz zrobić
azd i azd ai Tworzenie szkieletu, wdrażanie, ocenianie i automatyzowanie z poziomu terminalu.
Umiejętność Microsoft Foundry Zapewnij agentom programistycznym wytyczne wielokrotnego użytku dotyczące przepływów pracy w Foundry.
Microsoft Foundry Toolkit for Visual Studio Code Instalowane tylko wtedy, gdy program Visual Studio Code jest zainstalowany. Kompilowanie, testowanie, ocenianie i wdrażanie z poziomu edytora.
Foundry Canvas (wersja zapoznawcza) Instalowane tylko wtedy, gdy zainstalowana jest aplikacja GitHub Copilot. Projektuj i wdrażaj agenty hostowane na kanwie z przewodnikiem.

Pakiet DevPack nie instaluje Visual Studio Code ani aplikacji GitHub Copilot.

Kontynuuj pracę z poniższymi sekcjami, aby skonfigurować język programowania i zainstalować usługę Git.

Praca z językiem programowania

Użyj języka wymaganego przez aplikację. Wybierz kartę, aby zainstalować jego środowisko uruchomieniowe lub rozszerzenie Visual Studio Code.

Zainstaluj Python 3.10 lub nowszą. Python 3.9 jest minimalną obsługiwaną wersją. Utwórz środowisko wirtualne dla projektu zamiast instalować pakiety globalnie.

Windows

py -3 -m venv .venv
.\.venv\Scripts\Activate.ps1

macOS i Linux

python3 -m venv .venv
source .venv/bin/activate

Aby uzyskać obsługę edytora, zainstaluj rozszerzenie Python dla Visual Studio Code.

Instalowanie usługi Git

Aby sklonować przykłady zestawu SDK usługi Foundry, potrzebujesz narzędzia Git. Jeśli nie masz zainstalowanego narzędzia Git, pobierz go i zainstaluj z witryny internetowej Git.

Oddzielnie zainstaluj narzędzia deweloperskie

Jeśli nie używasz biblioteki Foundry DevPack, wybierz kartę, aby zainstalować tylko potrzebne narzędzia.

  1. Zainstaluj interfejs wiersza polecenia dewelopera Azure.

  2. Zainstaluj rozszerzenia Foundry:

    azd ext install microsoft.foundry
    

Aby zainstalować poszczególne rozszerzenia zamiast pełnego pakietu, zobacz Instalowanie rozszerzeń Foundry dla Azure Developer CLI.

Aby uzyskać bezpośrednie, szczegółowe zarządzanie poszczególnymi zasobami Azure, użyj Azure CLI (az). Zobacz Azure Developer CLI a Azure CLI.

Rozwiązywanie problemów

Kwestia Rozdzielczość
Nie można odnaleźć polecenia po instalacji Zamknij i otwórz ponownie terminal. Jeśli używasz Visual Studio Code, uruchom go ponownie, aby zmiany PATH zaczęły obowiązywać.
Python nie można odnaleźć Użyj python3 zamiast python w systemie macOS lub Linux lub zainstaluj Python 3.9 lub nowszą.
Odmowa uprawnień podczas instalacji pakietu Python W systemie macOS lub Linux nie używaj polecenia sudo pip install. Zamiast tego użyj środowiska wirtualnego.