Verwenden und Migrieren von deklarativen Agent-Workflows mit Microsoft Foundry Toolkit

Verwenden Sie Microsoft Foundry Toolkit für Visual Studio Code, um mit vorhandenen deklarativen Workflows zu arbeiten und sie für die Migration vorzubereiten. Sie können einen gespeicherten Workflow testen, dessen exportierten YAML bearbeiten und GitHub Copilot verwenden, um die Definition in Microsoft Agent Framework-Code zu konvertieren.

Von Bedeutung

Deklarative Workflows in Microsoft Foundry sind als Vorschau verfügbar und werden am 1. Dezember 2026 eingestellt. Verwenden Sie Microsoft Agent Framework für die neue Workflowentwicklung. Diese Außerbetriebnahme wirkt sich nicht auf die codebasierte Orchestrierung in gehosteten Agenten aus. Weitere Informationen zu unterstützten Migrationspfaden finden Sie im Workflowmigrationshandbuch .

Voraussetzungen

Anzeigen eines deklarativen Agent-Workflows

Suchen Sie den Workflow in der konsolidierten Agentliste Ihres Projekts.

  1. Bestätigen Sie in der Ansicht "Foundry Toolkit " unter "Meine Ressourcen" das ausgewählte Foundry-Projekt.
  2. Wählen Sie "Agents" und dann die Registerkarte "Workflow " aus.
  3. Wählen Sie den Workflownamen aus, um den zugehörigen Playground zu öffnen.
  4. Verwenden Sie die Versionsauswahl, um die gespeicherte Version auszuwählen, die Sie überprüfen möchten.

Der Playground zeigt das Workflowdiagramm und einen Unterhaltungsbereich an. Das Diagramm ist schreibgeschützt. Verwenden Sie das exportierte YAML oder das Foundry-Portal, um die Definition zu bearbeiten.

Bearbeiten einer vorhandenen Workflowdefinition

Exportieren Sie die Definition, bevor Sie sie bearbeiten oder migrieren. Bewahren Sie eine Kopie des ursprünglichen YAML auf, damit Sie sie mit Ihren Änderungen vergleichen können.

  1. Öffnen Sie den vorhandenen Workflow im Foundry-Portal.
  2. Wechseln Sie im Workflow-Designer zur YAML-Ansicht , und kopieren oder exportieren Sie die Definition. Ausführliche Informationen finden Sie unter Exportieren der Workflowdefinition.
  3. Speichern Sie die Definition in Ihrem lokalen Arbeitsbereich unter einem Namen, der auf .workflow.yaml endet, z. B. support.workflow.yaml.
  4. Öffnen Sie die Datei in Visual Studio Code, und bearbeiten Sie das YAML.
  5. Speichern Sie die Datei. Lokale Dateiänderungen aktualisieren den Workflow in Foundry nicht.

Speichern einer neuen Version des vorhandenen Workflows

Vor der Außerbetriebnahme können Sie eine bearbeitete Definition in denselben Workflow bereitstellen. Bestätigen Sie den Projekt- und Workflownamen, um das Erstellen einer anderen Ressource zu vermeiden.

  1. Vergewissern Sie sich, dass das Projekt des ursprünglichen Workflows im Foundry Toolkit ausgewählt ist.
  2. Wählen Sie bei geöffneter .workflow.yaml Datei die Option "Bereitstellen" in der Editorsymbolleiste aus.
  3. Geben Sie in "Workflownamen eingeben" den Namen des vorhandenen Workflows ein.
  4. Warten Sie auf die Erfolgsbenachrichtigung für die Bereitstellung.
  5. Öffnen Sie den Workflow aus demAgents-Workflow> erneut, und wählen Sie die neue Version aus.

Durch die Bereitstellung mit einem vorhandenen Workflownamen wird eine neue Version erstellt. Ein anderer Name erstellt einen separaten Workflow; verwenden Sie diesen Pfad nicht, um die neue Workflowentwicklung zu starten.

Testen eines Workflows im Spielplatz

Testen Sie die gespeicherte Version, die Sie verwalten oder migrieren möchten. Verwenden Sie die gleichen Anforderungen später, um die migrierte Implementierung zu vergleichen.

  1. Öffnen Sie den Workflow-Playground, und wählen Sie die erforderliche Version aus.
  2. Wählen Sie auf der Registerkarte " Playground " die Option "Neu " aus, um eine neue Spielplatzsitzung zu starten.
  3. Geben Sie eine Anforderung ein, mit der der Workflow ausgeführt und gesendet wird.
  4. Überprüfen Sie die Antwort und das Ausführungsdiagramm. Vergewissern Sie sich, dass die erwarteten Agenten, Branches und Schritte ausgeführt werden.
  5. Wiederholen Sie dies mit Anfragen, die unterschiedliche Pfade abdecken, fehlende Eingaben berücksichtigen und etwaige Genehmigungsschritte in Ihrem Workflow einbeziehen.

Der Playground führt den gespeicherten Foundry-Workflow aus. Nicht gespeicherte Änderungen in Ihrer lokalen YAML-Datei oder von Copilot generierter Code werden nicht ausgeführt.

Konvertieren eines YAML-Workflows in Agent Framework-Code

Verwenden Sie die Codegenerierungsaktion des Playgrounds, um GitHub Copilot zum Konvertieren der ausgewählten Workflowdefinition aufzufordern. Generierter Code ist ein Ausgangspunkt, den Sie überprüfen und testen müssen.

  1. Wählen Sie im Workflow-Playground die zu migrierende Version aus.
  2. Wählen Sie "Code generieren" aus.
  3. Wählen Sie Python oder C# aus.
  4. Überprüfen Sie die Konvertierungsanforderung in Copilot Chat, und folgen Sie den Anweisungen, um den Code zu generieren.
  5. Überprüfen Sie die generierten Projekte, Abhängigkeiten, Modellverbindungen, Tools und Authentifizierungskonfigurationen.
  6. Vergleichen Sie die Orchestrierung mit dem exportierten YAML. Überprüfen Sie Verzweigungen, Variablen, Agentenaufrufe und Schritte zur menschlichen Genehmigung.
  7. Führen Sie den Code lokal aus, und testen Sie ihn mit den Anforderungen, die Sie für den ursprünglichen Workflow verwendet haben. Verwenden Sie agent Inspector, um die Ausführung zu prüfen.
  8. Wenn sich der Code wie erforderlich verhält, befolgen Sie Gehostete Agenten erstellen, um ein unterstütztes Projekt für gehostete Agenten vorzubereiten, bereitzustellen und die bereitgestellte Version zu testen.

Die Codekonvertierung stellt keinen gehosteten Agent bereit oder garantiert kein gleichwertiges Verhalten. Behalten Sie die ursprüngliche Definition bei, bis Sie die Migration abgeschlossen haben, und vergewissern Sie sich, dass abhängige Anwendungen den Ersatz verwenden.

Weitere Migrationsoptionen, einschließlich des deklarativen YAMLs für Agent Framework, Azure Logic Apps und direkter A2A-Verbindungen, finden Sie im Leitfaden zur Workflowmigration.

Verwandte Inhalte

Verwenden Sie diese Leitfäden, um Ihre Migration auszuwählen und abzuschließen:

  • Last updated on