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.
Important
Die in diesem Artikel markierten Elemente (Vorschau) sind aktuell als öffentliche Vorschau verfügbar. Diese Vorschauversion wird ohne Vereinbarung zum Servicelevel bereitgestellt und sollte nicht für Produktionsworkloads verwendet werden. Manche Features werden möglicherweise nicht unterstützt oder sind nur eingeschränkt verwendbar. Weitere Informationen finden Sie unter Supplementale Nutzungsbedingungen für Microsoft Azure Previews.
Mit den Azure Developer CLI(azd)ai-Erweiterungen können Sie KI-Agents auf Microsoft Foundry von Ihrem Terminal aus erstellen, bereitstellen, auswerten und betreiben. In diesem Artikel installieren Sie die Erweiterungen, überprüfen die Installation und authentifizieren sich bei Azure.
Voraussetzungen
- Ein Azure-Abonnement. Erstellen Sie ein kostenloses Konto.
- Azure Developer CLI (
azd) Version 1.25.2 oder höher. Installieren Sie azd. - Python 3.10 oder höher oder .NET 8 oder höher, je nachdem, welches Agentframework Sie verwenden möchten.
Azure-Berechtigungen
Sie benötigen die folgenden Rollen für Ihr Azure-Abonnement.
| Role | Purpose |
|---|---|
| Mitwirkender | Bereitstellen und Verwalten von Azure Ressourcen. |
| Gießereibesitzer | Nur erforderlich, wenn Sie neue Foundry-Projekte erstellen. |
Important
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.
Verstehen, wie die Erweiterungen verpackt werden
Der azd ai Namespace besteht aus mehreren unabhängigen azd Erweiterungen. Jeder fügt unter azd ai eine Befehlsgruppe der obersten Ebene hinzu.
| Erweiterungs-ID | Befehlsgruppe | Was es bewirkt |
|---|---|---|
microsoft.foundry |
Metapaket | Bündelt alle Foundry-Erweiterungen für eine einzelne Installation. |
azure.ai.agents |
azd ai agent |
Stellen Sie Agenten mit Foundry direkt von Ihrem Terminal aus bereit. |
azure.ai.connections |
azd ai connection |
Verwalten von Foundry-Projektverbindungen. |
azure.ai.inspector |
azd ai inspector |
Browserbasierte Inspektor-UI für lokal ausgeführte Agents. |
azure.ai.projects |
azd ai project |
Foundry-Projektkontext verwalten (set, unset, show). |
azure.ai.routines |
azd ai routine |
Verwalten von Foundry-Routinen (Zeitgeber, Zeitpläne, Ereignistrigger). |
azure.ai.skills |
azd ai skill |
Foundry-Skills verwalten (wiederverwendbare Verhaltensrichtlinien für Agenten) |
azure.ai.toolboxes |
azd ai toolbox |
Verwalten von Foundry-Toolboxen (versionsierte Toolsammlungen). |
Das microsoft.foundry Paket ist ein dünnes Metapaket, das nicht zu eigenen Befehlen beiträgt. Bei der Installation werden alle einzelnen Erweiterungen mitinstalliert, was der empfohlene Einstieg ist. Die eigenständige Installation von azure.ai.agents ruft automatisch auch azure.ai.inspector ab, da die Agent-Erweiterung davon abhängt.
Installieren des vollständigen Bundles
Installieren Sie jede Foundry-Erweiterung in einem Schritt durch das Metapaket:
azd ext install microsoft.foundry
So aktualisieren Sie später:
azd ext upgrade microsoft.foundry
Installieren oder Aktualisieren einer einzelnen Erweiterung
Sie können jede Erweiterung auch eigenständig verwalten:
# Just the agent surface
azd ext install azure.ai.agents
# Just the routine surface
azd ext install azure.ai.routines
# Upgrade one extension without touching the others
azd ext upgrade azure.ai.connections
Die einzelnen Erweiterungen werden unabhängig voneinander versioniert, sodass Sie jede einzeln auf eine bestimmte Version festlegen oder aktualisieren können.
Überprüfen der Installation
Listen Sie die installierten Erweiterungen auf:
azd ext list
Sie sollten microsoft.foundry sowie jede einzelne Erweiterung sehen. Jede Erweiterung macht auch einen version Unterbefehl verfügbar:
azd ai agent version
azd ai connection version
azd ai inspector version
azd ai project version
azd ai routine version
azd ai skill version
azd ai toolbox version
Authenticate
Melden Sie sich bei Azure an, damit die CLI Ressourcen in Ihrem Auftrag bereitstellen und verwalten kann:
azd auth login
Mit diesem Befehl wird ein Browserfenster für die interaktive Authentifizierung geöffnet. Nachdem Sie sich angemeldet haben, speichert die CLI Ihre Anmeldeinformationen lokal für nachfolgende Befehle zwischen.