Übersicht über Microsoft Foundry Agent-Erweiterung

Die Microsoft Foundry-Agenterweiterung für die Azure Developer CLI (azd) erstellt das Grundgerüst, provisioniert und deployt Agents in Microsoft Foundry über Ihr Terminal oder Ihren Editor. Es kombiniert Foundry-Agent-Funktionen mit azd Lebenszyklusbefehlen für einen konsistenten Local-to-Cloud-Workflow. Sie können von einem Beispiel-Agent zu einem bereitgestellten, aufrufbaren Endpunkt mit einigen Befehlen wechseln.

In diesem Artikel wird die Erweiterung vorgestellt. Eine vollständige schrittweise Anleitung finden Sie in der Dokumentation Microsoft Foundry Hosted Agents.

Wichtigste Funktionen

Funktion Description
Projektgerüst Richtet vollständige Agentprojekte ein, einschließlich Infrastruktur als Codevorlagen, Agentdefinitionen und Konfiguration, sodass Sie sofort mit der Iterierung beginnen können.
Deklarative Konfiguration Definiert Dienste, Ressourcen und Modellbereitstellungen in einer azure.yaml Datei für konsistente Umgebungen.
Einheitliche Provisionierung und Bereitstellung Führt azd up aus, um Container zu erstellen, Images zu pushen, Ressourcen zu erstellen, Modelle bereitzustellen und den Agent in einem Schritt zu veröffentlichen.
Verwaltung von Agent-Definitionen Importiert Agentdefinitionen aus Katalogen, GitHub oder lokalen Pfaden und ordnet erforderliche Parameter Umgebungsvariablen zu.
Standardmäßig sicher Richtet verwaltete Identitäten und grundlegende Sicherheit automatisch ein, ohne Anmeldeinformationen manuell zu verarbeiten.
Skalierbare Modellbereitstellung Gibt Modellnamen, Versionen und Kapazität an und stellt sie in allen Umgebungen einheitlich bereit.

Erkunden des Workflows

Die Erweiterung folgt einem bekannten azd Lebenszyklus vom Grundgerüst bis hin zu einem aktiven Agenten:

  1. Scaffold: Initialisiert ein Beispiel-Agent-Projekt, einschließlich Infrastructure as Code, einer Agentdefinition und Konfiguration.
  2. Bereitstellen und Bereitstellen: Erstellen Sie das Foundry-Konto und -Projekt, stellen Sie Modelle bereit, erstellen und pushen Sie den Agent-Container, und veröffentlichen Sie den Agent.
  3. Lokal ausführen: Entwickeln Sie den Agenten auf Ihrem lokalen Computer weiter, während Sie mit Remote-Azure-Ressourcen verbunden sind.
  4. Aufrufen und Überwachen: Senden Sie Aufforderungen an den bereitgestellten Agent und streamen Sie Liveprotokolle.
  5. Abbauen: Entfernen Sie alle bereitgestellten Ressourcen, wenn Sie damit fertig sind.

Ausprobieren

Versuchen Sie, einen Beispiel-Agent mit dem minimalen Workflow bereitzustellen. In diesem Beispiel wird das grundlegende Agent Framework-Beispiel aus der Microsoft Foundry-Dokumentation verwendet.

  1. Erstellen Sie in einem leeren Ordner ein Gerüst für ein Beispiel-Agent-Projekt:

    azd ai agent init -m https://github.com/microsoft-foundry/foundry-samples/blob/main/samples/python/hosted-agents/agent-framework/responses/01-basic/azure.yaml

  2. Bereitstellen von Ressourcen und Bereitstellen des Agents in einem Schritt:

    azd up

    Tip

    Sie können diesen Schritt auch in azd provision und azd deploy aufteilen, um mehr Kontrolle über die einzelnen Phasen zu erhalten.

  3. Entfernen Sie alle bereitgestellten Ressourcen, wenn Sie fertig sind:

    azd down

    Warnung

    azd down Löscht alle Ressourcen in der Ressourcengruppe endgültig. Verwenden Sie es mit Bedacht in gemeinsam genutzten oder Produktionsumgebungen.

Voraussetzungen, Modellauswahl, lokale Tests und Problembehandlung finden Sie in der Schnellstartanleitung: Bereitstellen Ihres ersten gehosteten Agents.

Wann die Agent-Erweiterung verwendet werden soll

Microsoft Foundry unterstützt verschiedene Möglichkeiten zum Erstellen und Bereitstellen gehosteter Agents, einschließlich des Python SDK, Visual Studio Code und des Portals. Die azd Agent-Erweiterung ist am besten geeignet, wenn Sie möchten:

  • Arbeiten Sie in erster Linie vom Terminal oder Editor mit einem skriptfähigen, wiederholbaren Workflow.
  • Verwalten Sie Infrastruktur und Agents zusammen, indem Sie deklarative azure.yaml und Bicep Dateien unter Quellcodeverwaltung verwenden.
  • Wechseln Sie konsistent von lokal in die Cloud, indem Sie die gleichen azd Lebenszyklusbefehle (azd init, , azd up) verwenden, azd downdie Sie bereits für andere Azure-Apps verwenden.
  • Standardisieren Sie Bereitstellungen in Umgebungen (Entwicklungs-, Test- und Produktionsumgebungen), und automatisieren Sie sie in CI/CD.

Für eine geführte Portalerfahrung oder zum Erstellen von Agents mit dem Python SDK beginnen Sie stattdessen mit der Dokumentation Microsoft Foundry Hosted Agents.

Weitere Ressourcen

  • Last updated on