Vorbereiten der Entwicklungsumgebung

Bereiten Sie Ihre Entwicklungsumgebung auf die Erstellung mit dem Microsoft Foundry vor. Sie benötigen eine unterstützte Programmiersprache, die Azure CLI für die Authentifizierung, Git und Foundry-Entwicklertools.

Tip

Foundry DevPack ist die empfohlene Methode zum Installieren der Entwicklertools in einem Einzigen Befehl. Sie können jedes Tool auch separat installieren.

Wichtig

In diesem Artikel werden allgemeine Voraussetzungen, globale Tools und Visual Studio Code Setup behandelt. Es deckt keine szenariospezifischen SDK-Pakete oder Authentifizierungscode ab. Wenn Ihre Umgebung bereit ist, fahren Sie mit dem Schnellstart fort.

Voraussetzungen

  • Ein Azure Konto mit einem aktiven Abonnement. Wenn Sie kein Konto haben, erstellen Sie ein free Azure Konto, das ein kostenloses Testabonnement enthält.

  • Laden Sie Visual Studio Code herunter, installieren Und konfigurieren Sie sie, oder verwenden Sie die IDE Ihrer Wahl.

  • Verwenden Sie zum Erstellen und Verwalten von Foundry-Ressourcen eine der folgenden Azure RBAC-Rollen:

    • Foundry Project Manager zum Verwalten von Foundry-Projekten.

    Wichtig

    Die Foundry-RBAC-Rollen wurden kürzlich umbenannt. Foundry User, Foundry Owner, Foundry Account Owner und Foundry Project Manager wurden zuvor Azure KI-Benutzer, Azure KI-Besitzer, Azure KI-Kontobesitzer und Azure AI Project Manager benannt. Möglicherweise werden die vorherigen Namen an einigen Stellen weiterhin angezeigt, während der Umbenennungsrollout ausgeführt wird. Die Rollen-IDs und Kernberechtigungen bleiben durch die Umbenennung unverändert.

    • Besitzer für Berechtigungen und Rollenzuweisungen auf Abonnementebene, die für einige Szenarien erforderlich sind.
  • Um ein vorhandenes Projekt zu verwenden, ohne Ressourcen zu erstellen, benötigen Sie mindestens den Foundry User für das Projekt.

Ausführliche Informationen zu den einzelnen Rollen finden Sie unter Rollenbasierte Zugriffssteuerung für Microsoft Foundry.

Installieren von Foundry DevPack

Foundry DevPack installiert die Foundry-Entwicklertools für Ihren Editor, Terminal und Codierungs-Agent. Führen Sie den Befehl für Ihr Betriebssystem aus.

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

DevPack installiert die folgenden Tools:

Werkzeug Mögliche Aktionen
Microsoft Foundry Toolkit für Visual Studio Code Erstellen, testen, bewerten und bereitstellen – in Visual Studio Code.
azd und azd ai Gerüst, Bereitstellen, Auswerten und Automatisieren über das Terminal.
Foundry Canvas (Vorschau) Entwerfen und implementieren Sie gehostete Agenten mithilfe eines geführten Copilot-Designbereichs.
Microsoft Foundry Skill Geben Sie Codierungs-Agents wiederverwendbare Anleitungen für Foundry-Workflows.

Fahren Sie mit den folgenden Abschnitten fort, um Ihre Programmiersprache einzurichten, melden Sie sich mit dem Azure CLI an, und installieren Sie Git.

Arbeiten mit einer Programmiersprache

Verwenden Sie die sprache, die Ihre Anwendung benötigt. Erweitern Sie einen Abschnitt, wenn Sie dessen Laufzeitumgebung oder Visual-Studio-Code-Erweiterung installieren müssen.

Python

Installieren Sie Python 3.10 oder höher. Python 3.9 ist die mindest unterstützte Version. Erstellen Sie eine virtuelle Umgebung für Ihr Projekt, anstatt Pakete global zu installieren.

Windows

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

macOS und Linux

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

Installieren Sie für die Editorunterstützung die Python-Erweiterung für Visual Studio Code.

Java

Installieren Sie JDK 17 oder höher. Die Microsoft-Build von OpenJDK ist eine kostenlose LTS-Distribution. Installieren Sie für die Editorunterstützung das Visual Studio Code Extension Pack für Java.

JavaScript/TypeScript

Installieren Sie Node.js. Version 20 oder höher wird empfohlen.

C#

Installieren Sie die neueste Long-Term Supportversion des .NET SDK. Installieren Sie für die Editorunterstützung C# Dev Kit für Visual Studio Code.

Installieren des Azure CLI und Anmelden

Sie installieren die Azure CLI und melden sich in Ihrer lokalen Entwicklungsumgebung an, damit Ihr Code Ihre Benutzeranmeldeinformationen verwenden kann, um Azure Dienste über Foundry aufzurufen.

In den meisten Fällen können Sie Azure CLI über den folgenden Befehl über Ihr Terminal installieren:

winget install -e --id Microsoft.AzureCLI

Sie können den Anweisungen unter How to install the Azure CLI folgen, wenn diese Befehle auf Ihrem speziellen Betriebssystem oder Ihrer Konfiguration nicht funktionieren.

Melden Sie sich nach der Installation des Azure CLI mit dem Befehl az login an, und melden Sie sich mit dem Browser an:

az login

Alternativ können Sie sich manuell über den Browser mit einem Gerätecode anmelden.

az login --use-device-code

Lassen Sie dieses Terminal geöffnet, um Skripts nach der Anmeldung auszuführen.

Installieren von Git

Zum Klonen von Foundry SDK-Beispielen benötigen Sie Git. Wenn Sie Git nicht installiert haben, laden Sie es von der Git-Website herunter, und installieren Sie es.

Installieren von Entwicklertools einzeln

Wenn Sie Foundry DevPack nicht verwenden, installieren Sie jedes Entwicklertool separat:

  1. Installieren Sie die Azure Developer CLI.
  2. Installieren Sie alle Foundry-Erweiterungen für azd:
    azd ext install microsoft.foundry
    
    Informationen zum Installieren einzelner Erweiterungen finden Sie unter Installieren der Azure Developer CLI Foundry-Erweiterungen.
  3. Installieren Sie die Editor- und Codierungs-Agent-Tools:

Viele KI-Lösungsvorlagen unterstützen die Bereitstellung mit azd.

Problembehandlung

Angelegenheit Auflösung
Befehl nach der Installation nicht gefunden Schließen Sie das Terminal, und öffnen Sie es erneut, oder starten Sie Visual Studio Code neu, damit PATH-Änderungen wirksam werden.
az login schlägt mit einem Browserfehler fehl Führen Sie diese Ausführung az login --use-device-code aus, um sich mit einem Gerätecode zu authentifizieren.
Python wurde nicht gefunden. Verwenden Sie python anstelle von python3 unter macOS oder Linux, oder installieren Sie Python 3.9 oder höher.
Berechtigung verweigert bei der Installation von Python-Paketen Verwenden Sie unter macOS oder Linux sudo pip install nicht. Verwenden Sie stattdessen eine virtuelle Umgebung.