Przygotowywanie środowiska projektowego

Przygotuj środowisko deweloperskie do kompilacji przy użyciu Microsoft Foundry. Potrzebujesz obsługiwanego języka programowania, Azure CLI do uwierzytelniania, narzędzi deweloperskich Git i Foundry.

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, narzędzia globalne i konfigurację Visual Studio Code. Nie obejmuje pakietów zestawu SDK specyficznych dla scenariusza ani kodu uwierzytelniania. Gdy środowisko jest gotowe, przejdź do przewodnika Szybki start.

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 użyj wybranego środowiska IDE.

  • Aby tworzyć zasoby Foundry i zarządzać nimi, użyj jednej z tych ról Azure RBAC:

    • 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 dla uprawnień na poziomie subskrypcji i przypisań ról wymaganych w niektórych scenariuszach.

  • Aby użyć istniejącego projektu bez tworzenia zasobów, musisz mieć co najmniej użytkownika aplikacji Foundry w projekcie.

Aby uzyskać szczegółowe informacje o każdej roli, zobacz Kontrola dostępu oparta na rolach dla Microsoft Foundry.

Instalowanie pakietu DevPack w usłudze Foundry

Narzędzie Foundry DevPack instaluje narzędzia deweloperskie Foundry dla edytora, terminala i agenta kodowania. Uruchom polecenie dla systemu operacyjnego.

Windows

winget install Microsoft.FoundryDevPack

macOS

brew install --cask microsoft/foundry/devpack && foundry-devpack install

Linux

curl -fsSL https://aka.ms/foundry-devpack-install.sh | bash

Pakiet DevPack instaluje następujące narzędzia:

Narzędzie Co możesz zrobić
Microsoft Foundry Toolkit for Visual Studio Code Kompiluj, testuj, oceniaj i wdrażaj z Visual Studio Code.
azd i azd ai Tworzenie szkieletu, wdrażanie, ocenianie i automatyzowanie z poziomu terminalu.
Foundry Canvas (wersja zapoznawcza) Projektowanie i wdrażanie hostowanych agentów przy użyciu kanwy Copilot z przewodnikiem.
Umiejętność Microsoft Foundry Zapewnij agentom programistycznym wytyczne wielokrotnego użytku dotyczące przepływów pracy w Foundry.

Kontynuuj pracę z poniższymi sekcjami, aby skonfigurować język programowania, zalogować się przy użyciu Azure CLI i zainstalować usługę Git.

Praca z językiem programowania

Użyj języka wymaganego przez aplikację. Rozwiń sekcję, jeśli musisz zainstalować jego środowisko uruchomieniowe lub rozszerzenie Visual Studio Code.

Pyton

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.

Java

Zainstaluj zestaw JDK 17 lub nowszy. Microsoft Build of OpenJDK to bezpłatna dystrybucja z długoterminowym wsparciem. Aby uzyskać obsługę edytora, zainstaluj pakiet rozszerzeń Visual Studio Code dla Java.

JavaScript/TypeScript

Zainstalowanie środowiska Node.js. Zalecana jest wersja 20 lub nowsza.

C#

Zainstaluj najnowszą wersję .NET SDK z długoterminowym wsparciem. Aby uzyskać obsługę edytora, zainstaluj zestaw deweloperski języka C# dla Visual Studio Code.

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.

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.

Indywidualne instalowanie narzędzi deweloperskich

Jeśli nie używasz biblioteki Foundry DevPack, zainstaluj każde narzędzie deweloperskie oddzielnie:

  1. Zainstaluj interfejs wiersza polecenia dewelopera Azure.
  2. Zainstaluj wszystkie rozszerzenia Foundry dla azd: 
    azd ext install microsoft.foundry
    Aby zamiast tego zainstalować poszczególne rozszerzenia, zobacz Instalowanie rozszerzeń interfejsu wiersza polecenia dewelopera Azure Developer Foundry.
  3. Zainstaluj edytor i narzędzia agenta kodowania:

Wiele szablonów rozwiązań sztucznej inteligencji obsługuje wdrażanie przy użyciu azd.

Rozwiązywanie problemów

Kwestia Rozdzielczość
Nie można odnaleźć polecenia po instalacji Zamknij i otwórz ponownie terminal lub uruchom ponownie Visual Studio 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 kodu urządzenia.
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.

Powiązana zawartość

  • Last updated on