Použití a migrace deklarativních pracovních postupů agentů pomocí sady Microsoft Foundry Toolkit

Pomocí sady Microsoft Foundry Toolkit pro Visual Studio Code můžete pracovat s existujícími deklarativními pracovními postupy a připravit je na migraci. Uložený pracovní postup můžete otestovat, upravit exportovaný YAML a použít GitHub Copilot k převodu definice na kód Microsoft Agent Framework.

Důležité

Deklarativní pracovní postupy v Microsoft Foundry jsou v předběžném náhledu a budou vyřazeny 1. prosince 2026. Pro vývoj nových pracovních postupů použijte Microsoft Agent Framework. Toto vyřazení nemá vliv na orchestraci založenou na kódu v hostovaných agentech. Podporované cesty migrace najdete v průvodci migrací pracovních postupů .

Předpoklady

Zobrazení deklarativního pracovního postupu agenta

Najděte pracovní postup v konsolidovaném seznamu agentů projektu.

  1. V zobrazení Foundry Toolkit v části Moje zdroje potvrďte vybraný projekt Foundry.
  2. Vyberte Agenti a pak vyberte kartu Pracovní postup .
  3. Výběrem názvu pracovního postupu otevřete jeho hřiště.
  4. Pomocí selektoru verzí zvolte uloženou verzi, kterou chcete zkontrolovat.

Dětské hřiště zobrazuje graf pracovního postupu a oblast konverzace. Graf je jen pro čtení. K úpravě definice použijte exportovaný YAML nebo portál Foundry.

Úprava existující definice pracovního postupu

Před úpravou nebo migrací definice exportujte. Uchovávejte kopii původního YAML, abyste ji mohli porovnat se změnami.

  1. Otevřete existující pracovní postup na portálu Foundry.
  2. V návrháři pracovního postupu přepněte do zobrazení YAML a zkopírujte nebo exportujte definici. Podrobnosti najdete v tématu Export definice pracovního postupu.
  3. Uložte definici do místního pracovního prostoru s názvem končícím .workflow.yamlnapříklad support.workflow.yaml.
  4. Otevřete soubor v Visual Studio Code a upravte YAML.
  5. Uložte soubor. Změny místního souboru neaktualizují pracovní postup v Foundry.

Uložení nové verze existujícího pracovního postupu

Před vyřazením můžete nasadit upravenou definici do stejného pracovního postupu. Potvrďte název projektu a pracovního postupu, abyste se vyhnuli vytvoření jiného zdroje.

  1. Ověřte, že je ve Foundry Toolkitu vybraný projekt původního pracovního postupu.
  2. .workflow.yaml Otevřete soubor a na panelu nástrojů editoru vyberte Nasadit.
  3. Do pole Zadejte název pracovního postupu zadejte název existujícího pracovního postupu.
  4. Počkejte na oznámení o úspěšném nasazení.
  5. Znovu otevřete pracovní postup z Agents> a vyberte novou verzi.

Nasazení s existujícím názvem pracovního postupu vytvoří novou verzi. Jiný název vytvoří samostatný pracovní postup; tuto cestu nepoužívejte ke spuštění vývoje nových pracovních postupů.

Testování pracovního postupu v dětském hřišti

Otestujte uloženou verzi, kterou plánujete udržovat nebo migrovat. Stejné požadavky použijte později k porovnání migrované implementace.

  1. Otevřete hřiště pracovního postupu a vyberte požadovanou verzi.
  2. Na kartě Playground vyberte Nový a zahajte novou relaci Playground.
  3. Zadejte požadavek, který pracovní postup procvičí, a odešle ho.
  4. Zkontrolujte odpověď a graf spuštění. Ověřte, že probíhají očekávaní agenti, větve a kroky.
  5. Opakujte to s požadavky, které pokrývají různé větve, chybějící vstupy a případné kroky schvalování ve vašem pracovním postupu.

Dětské hřiště spouští uložený pracovní postup Foundry. Nespouští neuložené změny v místním souboru YAML ani kód, který Copilot vygeneruje.

Převod pracovního postupu YAML na kód agenta Framework

Pomocí funkce pro generování kódu v testovacím prostředí požádejte GitHub Copilot, aby převedl vybranou definici pracovního postupu. Vygenerovaný kód je výchozí bod, který musíte zkontrolovat a otestovat.

  1. V pracovním prostředí vyberte verzi, která se má migrovat.
  2. Vyberte Generovat kód.
  3. Zvolte Python nebo C#.
  4. Zkontrolujte požadavek na převod v Copilot Chat a podle pokynů vygenerujte kód.
  5. Zkontrolujte vygenerovaný projekt, závislosti, připojení modelu, nástroje a konfiguraci ověřování.
  6. Porovnejte orchestraci s exportovaným YAML. Zkontrolujte větvení, proměnné, volání agenta a kroky vyžadující lidské schválení.
  7. Spusťte kód místně a otestujte ho s požadavky, které jste použili pro původní pracovní postup. Ke kontrole provádění použijte agenta Inspector.
  8. Když se kód chová podle potřeby, postupujte podle pokynů k vytvoření hostovaných agentů a připravte podporovaný projekt hostovaného agenta, nasaďte ho a otestujte nasazenou verzi.

Převod kódu nenasazuje hostovaného agenta ani nezaručuje ekvivalentní chování. Ponechte původní definici, dokud dokončíte migraci, a potvrďte, že závislé aplikace používají nahrazení.

Další volby migrace, včetně deklarativního YAML rozhraní Agent Framework, Azure Logic Apps a přímých připojení A2A, najdete v průvodci migrací pracovních postupů.

Související obsah

K výběru a dokončení migrace použijte tyto příručky:

  • Last updated on