Declaratieve agentwerkstromen gebruiken en migreren met Microsoft Foundry Toolkit

Gebruik Microsoft Foundry Toolkit voor Visual Studio Code om te werken met bestaande declaratieve werkstromen en deze voor te bereiden op migratie. U kunt een opgeslagen werkstroom testen, de geëxporteerde YAML bewerken en GitHub Copilot gebruiken om de definitie te converteren naar Microsoft Agent Framework-code.

Belangrijk

Declaratieve werkstromen in Microsoft Foundry zijn beschikbaar als preview en worden op 1 december 2026 buiten gebruik gesteld. Gebruik Microsoft Agent Framework voor nieuwe werkstroomontwikkeling. Deze uitfasering heeft geen invloed op codegestuurde orkestratie in gehoste agents. Zie de handleiding voor werkstroommigratie voor ondersteunde migratiepaden.

Prerequisites

Een werkstroom voor een declaratieve agent weergeven

Zoek de werkstroom in de lijst met geconsolideerde agents van uw project.

  1. Bevestig in de weergave Foundry Toolkit onder Mijn resources het geselecteerde Foundry-project.
  2. Selecteer Agents en selecteer vervolgens het tabblad Werkstroom .
  3. Selecteer de naam van de workflow om de playground te openen.
  4. Gebruik de versieselector om de opgeslagen versie te kiezen die u wilt controleren.

De speeltuin toont de werkstroomgrafiek en een gespreksgebied. De grafiek heeft het kenmerk Alleen-lezen. Gebruik de geëxporteerde YAML of de Foundry-portal om de definitie te bewerken.

Een bestaande werkstroomdefinitie bewerken

Exporteer de definitie voordat u deze bewerkt of migreert. Bewaar een kopie van de oorspronkelijke YAML, zodat u deze kunt vergelijken met uw wijzigingen.

  1. Open de bestaande werkstroom in de Foundry-portal.
  2. Schakel in de werkstroomontwerper over naar de YAML-weergave en kopieer of exporteer de definitie. Zie Uw werkstroomdefinitie exporteren voor meer informatie.
  3. Sla de definitie op in uw lokale werkruimte met een naam die eindigt op .workflow.yaml, zoals support.workflow.yaml.
  4. Open het bestand in Visual Studio Code en bewerk de YAML.
  5. Sla het bestand op. Wijzigingen in het lokale bestand werken de werkstroom niet bij in Foundry.

Een nieuwe versie van de bestaande werkstroom opslaan

Voordat deze buiten gebruik wordt gesteld, kunt u een bewerkte definitie naar dezelfde workflow implementeren. Bevestig de naam van het project en de werkstroom om te voorkomen dat er een andere resource wordt gemaakt.

  1. Controleer of het project van de oorspronkelijke werkstroom is geselecteerd in Foundry Toolkit.
  2. Wanneer het .workflow.yaml bestand is geopend, selecteert u Implementeren in de werkbalk van de editor.
  3. Voer in De naam van de werkstroom invoeren de naam van de bestaande werkstroom in.
  4. Wacht op de melding dat de implementatie is geslaagd.
  5. Open de werkstroom opnieuw vanuit Agents>Workflow en selecteer de nieuwe versie.

Als u implementeert met een bestaande werkstroomnaam, wordt er een nieuwe versie gemaakt. Een andere naam maakt een afzonderlijke werkstroom; gebruik dit pad niet om nieuwe werkstroomontwikkeling te starten.

Een werkstroom testen in de speeltuin

Test de opgeslagen versie die u wilt onderhouden of migreren. Gebruik dezelfde aanvragen later om de gemigreerde implementatie te vergelijken.

  1. Open de playground van de workflow en selecteer de gewenste versie.
  2. Selecteer Nieuw op het tabblad Speeltuin om een nieuwe speeltuinsessie te starten.
  3. Voer een verzoek in waarmee de werkstroom wordt doorlopen en verzend het.
  4. Controleer het antwoord en de uitvoeringsgrafiek. Controleer of de verwachte agents, branches en stappen worden uitgevoerd.
  5. Herhaal dit met verzoeken waarbij verschillende paden, ontbrekende invoergegevens en eventuele goedkeuringsstappen in uw workflow worden doorlopen.

De playground voert de opgeslagen Foundry-workflow uit. Er worden geen niet-opgeslagen wijzigingen uitgevoerd in uw lokale YAML-bestand of de code die Copilot gegenereerd.

Een YAML-werkstroom converteren naar Agent Framework-code

Gebruik de codegeneratie-actie van de playground om GitHub Copilot te vragen de geselecteerde workflowdefinitie om te zetten. Gegenereerde code is een startpunt dat u moet controleren en testen.

  1. Selecteer in de workflow-omgeving de versie die u wilt migreren.
  2. Selecteer Code genereren.
  3. Kies Python of C#.
  4. Controleer de conversieaanvraag in Copilot Chat en volg de aanwijzingen om de code te genereren.
  5. Controleer het gegenereerde project, afhankelijkheden, modelverbindingen, hulpprogramma's en verificatieconfiguratie.
  6. Vergelijk de orchestratie met de geëxporteerde YAML. Controleer vertakkingen, variabelen, agentaanroepen en stappen voor menselijke goedkeuring.
  7. Voer de code lokaal uit en test deze met de aanvragen die u hebt gebruikt voor de oorspronkelijke werkstroom. Gebruik Agent Inspector om de uitvoering te inspecteren.
  8. Wanneer de code zich gedraagt zoals vereist, volgt u Gehoste agents maken om een ondersteund gehost agentproject voor te bereiden, deze te implementeren en de geïmplementeerde versie te testen.

Codeconversie implementeert geen gehoste agent of garandeert gelijkwaardig gedrag. Behoud de oorspronkelijke definitie totdat u de migratie voltooit en controleer of afhankelijke toepassingen gebruikmaken van de vervanging.

Zie de migratiehandleiding voor werkstromen voor andere migratieopties, waaronder declaratieve YAML van Agent Framework, Azure Logic Apps en directe A2A-verbindingen.

Verwante onderwerpen

Gebruik deze handleidingen om uw migratie te kiezen en te voltooien:

  • Last updated on