Microsoft-Foundry-Erweiterung für Azure Developer CLI erreicht Version 1.0

Agentenkonfiguration bleibt beim Anwendungscode

Azure Developer CLI, auch als azd bezeichnet, stellt Azure-Ressourcen bereit und deployt Anwendungscode. Die Microsoft-Foundry-Erweiterung ergänzt Werkzeuge zum Einrichten von Agenten und für lokale Tests. Die Konfiguration von Agenten und Deployments bleibt dabei in azure.yaml.

Dadurch können Entwickler Änderungen an Agenten und Deployments gemeinsam im selben Pull Request prüfen. Teams können außerdem lokal und in CI/CD dieselbe Deployment-Definition verwenden. Jede azd-Umgebung liefert dabei ihr Zielabonnement, ihre Region und ihre Ressourceneinstellungen.

Die Erweiterung unterstützt gehostete Agenten, deren Code auf verwalteter Rechenleistung in Foundry ausgeführt wird. Entwickler wählen Framework und Orchestrierungslogik, während Foundry die Laufzeit verwaltet. Für das dokumentierte Setup sind Azure Developer CLI 1.37.0 oder höher, eine aktuelle uv-Version und für das Beispiel Python 3.13 oder höher erforderlich. Außerdem werden ein Azure-Abonnement, Foundry-Berechtigungen und ein Modellkontingent in der ausgewählten Region benötigt. Für bereitgestellte Ressourcen und die Modellnutzung fallen Azure-Gebühren an.

Vom lokalen Test zum gehosteten Deployment

Die Anleitung beginnt mit azd ai agent init. Der Befehl initialisiert in einem leeren Verzeichnis ein Beispiel für das Python Agent Framework und lässt Entwickler ein neues oder bestehendes Foundry-Projekt auswählen. Die daraus entstehende azure.yaml beschreibt den Agenten, seine Quelle und Laufzeit, die Rechenleistungszuweisung, das Modell-Deployment und die Abhängigkeit vom Foundry-Projekt.

Mit azd provision können Entwickler die deklarierten Ressourcen erstellen, einschließlich fehlender Modell-Deployments in einem wiederverwendeten Projekt. Der Befehl zeigt Optionen für die Modellkonfiguration wie Global Standard und Data Zone Standard an. Welche Optionen und Kontingente verfügbar sind, hängt jedoch vom Abonnement und der Region ab.

Für lokale Tests installiert azd ai agent run die Abhängigkeiten und öffnet Agent Inspector. Modellaufrufe verwenden weiterhin das Azure-Deployment, während Entwickler den lokalen Agenten von einem zweiten Terminal aus aufrufen können. Sobald der Agent bereit ist, lädt azd deploy den Quellcode für einen Remote-Build zu Foundry hoch. Ein lokaler Container-Build ist daher nicht erforderlich. Der Workflow umfasst außerdem Befehle zur Vorschau von Änderungen an gehosteten Agenten, zum Streamen von Logs und zur Diagnose von Setup- oder Berechtigungsproblemen.

Unterstützung für Evaluierungen und CI/CD

Die Erweiterung kann mit der Evaluations-Erweiterung kombiniert werden, um Testdaten und ein Bewertungsraster für einen bereitgestellten Agenten zu erstellen. Entwickler können den Evaluierungsdatensatz, das Bewertungsraster und die Konfiguration gemeinsam mit ihrem Code verwalten, Änderungen vergleichen und Prüfungen in CI/CD wiederverwenden. Laut Microsoft kann azd ai agent optimize eine konfigurierte Evaluierung als Grundlage verwenden. Kandidaten werden dabei geprüft, bevor einer ausdrücklich bereitgestellt wird.

Für die Automatisierung bündelt, provisioniert und deployt azd up das Projekt. Der Befehl azd pipeline config richtet die Authentifizierung, Repository-Einstellungen und einen Workflow für GitHub Actions oder Azure DevOps ein. Microsoft empfiehlt, der Pipeline-Identität die erforderlichen Azure-Berechtigungen zu erteilen, pro Phase eine separate azd-Umgebung zu verwenden und Laufzeit-Zugangsdaten in Pipeline-Secrets zu hinterlegen.

Der Microsoft Foundry Skill unterstützt außerdem Coding-Agenten wie GitHub Copilot und Claude Code mit Foundry-spezifischen Workflows für die Projekte Einrichtung und lokale Tests. Zusammengenommen bieten diese Funktionen Entwicklern einen Weg vom Gerüstbau und der lokalen Prüfung über das gehostete Deployment und die Evaluierung bis zur wiederholbaren Bereitstellung. Konfiguration und Testressourcen bleiben dabei zusammen mit dem Anwendungscode erhalten.