Använda och migrera deklarativa agentarbetsflöden med Microsoft Foundry Toolkit

Använd Microsoft Foundry Toolkit för Visual Studio Code för att arbeta med befintliga deklarativa arbetsflöden och förbereda dem för migrering. Du kan testa ett sparat arbetsflöde, redigera dess exporterade YAML och använda GitHub Copilot för att konvertera definitionen till Microsoft Agent Framework-kod.

Important

Deklarativa arbetsflöden i Microsoft Foundry är i förhandsversion och går i pension den 1 december 2026. Använd Microsoft Agent Framework för ny arbetsflödesutveckling. Den här tillbakadragningen påverkar inte kodbaserad orkestrering i värdbaserade agenter. Se arbetsflödesmigreringsguiden för migreringsvägar som stöds.

Förutsättningar

Visa ett deklarativt agentarbetsflöde

Hitta arbetsflödet i projektets konsoliderade agentlista.

  1. I vyn Foundry Toolkit under Mina resurser bekräftar du det valda Foundry-projektet.
  2. Välj Agenter och välj sedan fliken Arbetsflöde .
  3. Välj arbetsflödets namn för att öppna dess testmiljö.
  4. Använd versionsväljaren för att välja den sparade version som du vill inspektera.

Lekplatsen visar arbetsflödesdiagrammet och ett konversationsområde. Diagrammet är skrivskyddat. Använd den exporterade YAML- eller Foundry-portalen för att redigera definitionen.

Redigera en befintlig arbetsflödesdefinition

Exportera definitionen innan du redigerar eller migrerar den. Behåll en kopia av den ursprungliga YAML-filen så att du kan jämföra den med dina ändringar.

  1. Öppna det befintliga arbetsflödet i Foundry-portalen.
  2. I arbetsflödesdesignern växlar du till YAML-vyn och kopierar eller exporterar definitionen. Mer information finns i Exportera arbetsflödesdefinitionen.
  3. Spara definitionen på din lokala arbetsyta med ett namn som slutar med .workflow.yaml, till exempel support.workflow.yaml.
  4. Öppna filen i Visual Studio Code och redigera YAML.
  5. Spara filen. Lokala filändringar uppdaterar inte arbetsflödet i Foundry.

Spara en ny version av det befintliga arbetsflödet

Innan du går i pension kan du distribuera en redigerad definition till samma arbetsflöde. Bekräfta namnet på projektet och arbetsflödet för att undvika att skapa en annan resurs.

  1. Bekräfta att det ursprungliga arbetsflödets projekt har valts i Foundry Toolkit.
  2. När filen är .workflow.yaml öppen väljer du Distribuera i redigeringsprogrammets verktygsfält.
  3. I Ange arbetsflödesnamn anger du namnet på det befintliga arbetsflödet.
  4. Vänta på meddelandet om att driftsättningen har lyckats.
  5. Öppna arbetsflödet från agentarbetsflödet> igen och välj den nya versionen.

När du distribuerar med ett befintligt arbetsflödesnamn skapas en ny version. Ett annat namn skapar ett separat arbetsflöde. använd inte den här sökvägen för att starta ny arbetsflödesutveckling.

Testa ett arbetsflöde på lekplatsen

Testa den sparade versionen som du planerar att underhålla eller migrera. Använd samma begäranden senare för att jämföra den migrerade implementeringen.

  1. Öppna arbetsflödets testmiljö och välj den version som krävs.
  2. På fliken Playground väljer du Ny för att starta en ny lekplatssession.
  3. Ange en begäran som använder arbetsflödet och skickar den.
  4. Granska svaret och körningsdiagrammet. Kontrollera att agenterna, grenarna och stegen körs som förväntat.
  5. Upprepa med begäranden som testar olika grenar, fall med saknade indata och eventuella steg för godkännande i arbetsflödet.

Lekplatsen kör det sparade Foundry-arbetsflödet. Den kör inte ändringar som inte har sparats i din lokala YAML-fil eller koden som Copilot genererar.

Konvertera ett YAML-arbetsflöde till Agent Framework-kod

Använd lekplatsens kodgenereringsåtgärd för att be GitHub Copilot att konvertera den valda arbetsflödesdefinitionen. Genererad kod är en startpunkt som du måste granska och testa.

  1. I arbetsflödets lekplats väljer du den version som ska migreras.
  2. Välj Generera kod.
  3. Välj Python eller C#.
  4. Granska konverteringsbegäran i Copilot Chat och följ dess uppmaningar för att generera koden.
  5. Granska det genererade projektet, beroenden, modellanslutningar, verktyg och autentiseringskonfiguration.
  6. Jämför orkestreringen med den exporterade YAML. Kontrollera förgreningar, variabler, agentanrop och steg för mänskligt godkännande.
  7. Kör koden lokalt och testa den med de begäranden som du använde för det ursprungliga arbetsflödet. Använd Agent inspector för att inspektera körningen.
  8. När koden fungerar efter behov följer du Skapa värdbaserade agenter för att förbereda ett värdbaserat agentprojekt som stöds, distribuera det och testa den distribuerade versionen.

Kodkonvertering distribuerar inte en värdbaserad agent eller garanterar motsvarande beteende. Behåll den ursprungliga definitionen tills du slutför migreringen och bekräfta att beroende program använder ersättningen.

Andra migreringsalternativ, inklusive Agent Framework-deklarativ YAML, Azure Logic Apps och direkta A2A-anslutningar, finns i arbetsflödesmigreringsguiden.

Relaterat innehåll

Använd dessa guider för att välja och slutföra migreringen:

  • Last updated on