Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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:
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:
- Installieren Sie die Azure Developer CLI.
- Installieren Sie alle Foundry-Erweiterungen für
azd:
Informationen zum Installieren einzelner Erweiterungen finden Sie unter Installieren der Azure Developer CLI Foundry-Erweiterungen.azd ext install microsoft.foundry - Installieren Sie die Editor- und Codierungs-Agent-Tools:
- Installieren und einrichten Sie das Microsoft Foundry Toolkit für Visual Studio Code.
- Verwenden Sie Foundry Canvas , um gehostete Agents zu entwerfen und bereitzustellen.
- Verwenden Sie die Microsoft Foundry Skill in Ihrem Codierungsagenten.
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. |