Vorbereiten der Entwicklungsumgebung

Richten Sie Ihre Entwicklungsumgebung ein, um das Microsoft Foundry SDK zu verwenden. Sie benötigen auch Azure CLI für die Authentifizierung, damit Ihr Code auf Ihre Benutzeranmeldeinformationen zugreifen kann.

In diesem Artikel installieren Sie Sprachlaufzeiten, Azure CLI, Azure Developer CLI, die Foundry VS Code-Erweiterung und Git.

Wichtig

In diesem Artikel werden nur allgemeine Voraussetzungen behandelt, z. B. Sprachlaufzeiten, globale Tools und VS Code und Erweiterungssetup.
Es werden keine szenariospezifischen Schritte wie die SDK-Installation oder Authentifizierung behandelt.
Wenn Ihre Umgebung bereit ist, fahren Sie mit der Schnellstartanleitung fort, um die Anweisungen auszuführen.

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 oder die IDE Ihrer Wahl herunter, installieren und konfigurieren Sie sie. Weitere Informationen finden Sie unter Download Visual Studio Code.

  • Für das Erstellen und Verwalten von Foundry-Ressourcen muss eine der folgenden Azure RBAC-Rollen verwendet werden.

    • Azure AI Project Manager (für die Verwaltung von Foundry-Projekten)
    • Besitzer (für Berechtigungen auf Abonnementebene). Der Besitzer wird für zusätzliche Rollenzuweisungen benötigt, die für andere Szenarien in Foundry notwendig sind. Um sicherzustellen, dass Sie für alle Szenarien in Foundry entsperrt sind, ist ‘Owner’ die erforderliche Rollenzuweisung.

  • Um Projekt zu verwenden, aber keine neuen Ressourcen zu erstellen, benötigen Sie mindestens Folgendes:

    • Azure AI User für die Projekte, die Sie verwenden (Rolle mit den geringsten Rechten für die Entwicklung)

    Ausführliche Informationen zu den Berechtigungen der einzelnen Rollen finden Sie unter Role-basierte Zugriffssteuerung für Microsoft Foundry.

Installieren der Programmiersprache

Erstellen Sie in Visual Studio Code einen neuen Ordner für Ihr Projekt. Öffnen Sie ein Terminalfenster in diesem Ordner.

Erstellen Sie zunächst eine neue Python Umgebung. Installieren Sie keine Pakete in Ihrer globalen Python Installation. Verwenden Sie beim Installieren von Python Paketen immer eine virtuelle oder conda-Umgebung. Andernfalls können Sie die globale Installation von Python unterbrechen.

Installieren Sie bei Bedarf Python

Verwenden Sie Python 3.10 oder höher, aber mindestens Python 3.9 ist erforderlich. Wenn Sie keine geeignete Version von Python installiert haben, befolgen Sie die Anweisungen im VS Code Python Tutorial für die einfachste Möglichkeit zum Installieren von Python auf Ihrem Betriebssystem.

Erstellen einer virtuellen Umgebung

Wenn Sie bereits Python 3.10 oder höher installiert haben, erstellen Sie mithilfe der folgenden Befehle eine virtuelle Umgebung:

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

Wenn Sie die Python Umgebung aktivieren, verwendet das Ausführen von python oder pip über die Befehlszeile den Python Interpreter im Ordner .venv Ihrer Anwendung.

Hinweis

Verwenden Sie den Befehl deactivate, um die Python virtuelle Umgebung zu beenden. Sie können sie später bei Bedarf reaktivieren.

Installieren der Python-Erweiterung für Visual Studio Code

Die Python-Erweiterung für Visual Studio Code unterstützt Python mit IntelliSense, Debuggen, Formatierung, Linting, Codenavigation, Umgestaltung, Variablen-Explorer, Test-Explorer und Umgebungsverwaltung.

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

Installieren:

  • Java Development Kit (JDK) 17 oder höher

Installieren des Visual Studio Code Erweiterungspakets für Java

Das Extension Pack für Java ist eine Sammlung beliebter Erweiterungen, die Ihnen beim Schreiben, Testen und Debuggen von Java Anwendungen in Visual Studio Code helfen können.

Installieren Sie das Visual Studio Code Extension Pack für Java.

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

Stellen Sie sicher, dass die erforderlichen Tools für die .NET Entwicklung installiert sind.

Installieren des .NET SDK

Sie benötigen das .NET SDK (Software Development Kit), um .NET Anwendungen zu erstellen, zu erstellen und auszuführen. Es wird empfohlen, die neueste LTS-Version (Long Term Support) oder eine höhere Version zu installieren, falls für Ihr Projekt erforderlich.

  1. Laden Sie das .NET SDK aus der downloadseite official .NET herunter. Wählen Sie das entsprechende Installationsprogramm für Ihr Betriebssystem (Windows, Linux oder macOS) aus.

  2. Befolgen Sie die Installationsanweisungen für Ihr Betriebssystem.

  3. Überprüfen Sie die Installation, indem Sie ein Terminal oder eine Eingabeaufforderung öffnen und folgendes ausführen:

    dotnet --version

    Die Antwort sollte die installierte SDK-Version sein.

Installieren des C#Dev Kit für Visual Studio Code

Um die beste C#-Entwicklungserfahrung in VS Code zu erzielen, installieren Sie die offizielle C#Dev Kit-Erweiterung:

  1. Öffnen Sie Visual Studio Code.
  2. Wechseln Sie zur Ansicht "Erweiterungen" (STRG+UMSCHALT+X oder CMD+UMSCHALT+X).
  3. Suchen Sie nach C# Dev Kit.
  4. Installieren Sie die von Microsoft veröffentlichte Erweiterung. Dadurch wird auch die C#-Basiserweiterung installiert, wenn Sie sie noch nicht haben.

Erstellen eines neuen .NET-Projekts

Mit dem in Visual Studio Code integrierten Terminal (Terminal > Neues Terminal) können Sie ein neues .NET Projekt erstellen.

So erstellen Sie beispielsweise eine neue Konsolenanwendung:

# 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

Sie können diesen MyConsoleApp Ordner jetzt in VS Code (File > Open Folder...) öffnen, um mit der Arbeit an Ihrem C#-Projekt zu beginnen. VS Code, mit der C#Dev Kit-Erweiterung, erkennt das Projekt automatisch und aktiviert Features wie IntelliSense, Debugging und Buildaufgaben.

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 Sie die Azure Developer CLI

Die Azure Developer CLI (azd) ist ein Open-Source-Tool, mit dem Sie App-Ressourcen auf Azure einrichten und bereitstellen können. Es bietet einfache Befehle für wichtige Entwicklungsphasen, unabhängig davon, ob Sie ein Terminal, eine IDE oder CI/CD-Pipeline verwenden. Installieren Sie die Azure Developer CLI für Ihre Plattform.

Viele der KI-Lösungsvorlagen enthalten eine Bereitstellungsoption mithilfe von azd.

Installieren der Erweiterung "Foundry VS Code"

Mit der Foundry-Erweiterung für Visual Studio Code können Sie Modelle bereitstellen, KI-Apps erstellen und direkt über die VS Code-Schnittstelle mit Agents arbeiten. Installieren Sie die Erweiterung Foundry VS Code.

Installieren von Git

Git ist erforderlich, um Foundry SDK-Beispiele zu klonen. Wenn Sie Git nicht installiert haben, befolgen Sie die Anweisungen für Ihre Plattform , und wählen Sie Ihr Betriebssystem aus.

Problembehandlung

Angelegenheit Auflösung
Befehl nach der Installation nicht gefunden Schließen Sie das Terminal, und öffnen Sie es erneut, oder starten Sie VS Code neu, sodass PATH-Änderungen wirksam werden.
az login schlägt mit einem Browserfehler fehl Führen Sie stattdessen az login --use-device-code aus, um die Authentifizierung über einen Gerätecodefluss vorzunehmen.
Python nicht gefunden Verwenden Sie python3 anstelle von python auf macOS/Linux, oder installieren Sie eine unterstützte Version (3.9 oder höher).
Berechtigung verweigert während der Installation Vermeiden Sie sudo pip installauf macOS/Linux . Verwenden Sie stattdessen eine virtuelle Umgebung .

Verwandte Inhalte

  • Last updated on