Deklaratív ügynök munkafolyamatainak használata és migrálása Microsoft Foundry Toolkittel

A Microsoft Foundry Toolkit segítségével Visual Studio Code használhatja a meglévő deklaratív munkafolyamatokat, és előkészíti őket a migrálásra. Tesztelhet egy mentett munkafolyamatot, szerkesztheti az exportált YAML-et, és a GitHub Copilot segítségével átalakíthatja a definíciót Microsoft Agent Framework-kódra.

Important

Az Microsoft Foundry deklaratív munkafolyamatai előzetes verzióban érhetők el, és 2026. december 1-jén megszűnnek. Az Microsoft Agent Framework használata új munkafolyamat-fejlesztéshez. Ez a kivonás nem befolyásolja a kódalapú vezénylést az üzemeltetett ügynökökben. A támogatott migrálási útvonalakat a munkafolyamat migrálási útmutatójában találja.

Prerequisites

Deklaratív ügynök munkafolyamatának megtekintése

Keresse meg a munkafolyamatot a projekt konszolidált ügynöklistájában.

  1. A Foundry Toolkit nézetben, a Saját erőforrások területen erősítse meg a kiválasztott Foundry-projektet.
  2. Válassza az Ügynökök lehetőséget, majd a Munkafolyamat lapot.
  3. Válassza ki a munkafolyamat nevét a játszótér megnyitásához.
  4. A verzióválasztóval válassza ki a megvizsgálni kívánt mentett verziót.

A játszótéren a munkafolyamat-diagram és a beszélgetési terület látható. A gráf írásvédett. A definíció szerkesztéséhez használja az exportált YAML-t vagy az Foundry portált.

Meglévő munkafolyamat-definíció szerkesztése

A definíció szerkesztése vagy migrálása előtt exportálja a definíciót. Őrizze meg az eredeti YAML másolatát, hogy összehasonlíthassa a módosításokkal.

  1. Nyissa meg a meglévő munkafolyamatot az Foundry portálon.
  2. A munkafolyamat-tervezőben váltson a YAML nézetre, és másolja vagy exportálja a definíciót. További részletekért lásd : Munkafolyamat-definíció exportálása.
  3. Mentse a definíciót a helyi munkaterületére olyan néven, amelynek a vége support.workflow.yaml, például .workflow.yaml.
  4. Nyissa meg a fájlt a Visual Studio Code-ban, és szerkessze a YAML-fájlt.
  5. Mentse a fájlt. A helyi fájlmódosítások nem frissítik a munkafolyamatot a Foundryben.

A meglévő munkafolyamat új verziójának mentése

A kivonás előtt üzembe helyezhet egy szerkesztett definíciót ugyanabban a munkafolyamatban. Erősítse meg a projekt és a munkafolyamat nevét, hogy ne hozzon létre másik erőforrást.

  1. Győződjön meg arról, hogy az eredeti munkafolyamat projektje ki van jelölve az Foundry Toolkitben.
  2. Ha meg van nyitva a .workflow.yaml fájl, válassza az Üzembe helyezés lehetőséget a szerkesztő eszköztárán.
  3. Írja be a munkafolyamat nevét az Enter munkafolyamatnév mezőbe.
  4. Várja meg az üzembe helyezés sikerességét jelző értesítést.
  5. Nyissa meg újra a munkafolyamatot az Ügynökök>munkafolyamatából , és válassza ki az új verziót.

A meglévő munkafolyamat nevével történő üzembe helyezés új verziót hoz létre. Egy másik név külön munkafolyamatot hoz létre; ne használja ezt az elérési utat új munkafolyamat-fejlesztés indításához.

Munkafolyamat tesztelése a játszótéren

Tesztelje a karbantartani vagy migrálni kívánt mentett verziót. Később ugyanazokat a kéréseket használva hasonlítsa össze a migrált implementációt.

  1. Nyissa meg a munkafolyamat játszóterét, és válassza ki a szükséges verziót.
  2. A Játszótér lapon válassza az Új lehetőséget egy új játszótéri munkamenet elindításához.
  3. Adjon meg egy kérést, amely teszteli a folyamatot, majd küldje el.
  4. Tekintse át a választ és a végrehajtási gráfot. Győződjön meg róla, hogy az elvárt ügynökök, ágak és lépések futnak.
  5. Ismételje meg ezt olyan kérésekkel, amelyek különböző ágakat, hiányzó bemeneteket és a munkafolyamat jóváhagyási lépéseit fedik le.

A játszótér futtatja a mentett Foundry-munkafolyamatot. Nem futtat nem mentett módosításokat a helyi YAML-fájlban vagy a Copilot által generált kódban.

YAML-munkafolyamat átalakítása Ügynök-keretrendszerkóddá

A Playground kódgenerálási műveletét használva kérje meg a GitHub Copilotot, hogy alakítsa át a kijelölt munkafolyamat-definíciót. A létrehozott kód egy kiindulási pont, amelyet felül kell vizsgálnia és tesztelnie kell.

  1. A munkafolyamat-játszótéren válassza ki a migrálni kívánt verziót.
  2. Válassza a Kód létrehozása lehetőséget.
  3. Válassza a Python vagy a C# lehetőséget.
  4. Tekintse át a konvertálási kérelmet Copilot Chat, és kövesse az utasításokat a kód létrehozásához.
  5. Tekintse át a létrehozott projektet, függőségeket, modellkapcsolatokat, eszközöket és hitelesítési konfigurációt.
  6. Hasonlítsa össze annak orchesztrációját az exportált YAML-lel. Ellenőrizze az elágaztatást, a változókat, az ügynökhívásokat és az emberi jóváhagyást igénylő lépéseket.
  7. Futtassa helyileg a kódot, és tesztelje az eredeti munkafolyamathoz használt kérésekkel. A végrehajtás ellenőrzéséhez használja az Ügynökfelügyelőt.
  8. Ha a kód szükség szerint viselkedik, kövesse az üzemeltetett ügynökök létrehozását egy támogatott üzemeltetett ügynök projekt előkészítéséhez, üzembe helyezéséhez és az üzembe helyezett verzió teszteléséhez.

A kódkonvertálás nem helyez üzembe üzemeltetett ügynököt, és nem garantálja az ezzel egyenértékű viselkedést. Az áttelepítés befejezéséig tartsa meg az eredeti definíciót, és győződjön meg arról, hogy a függő alkalmazások használják a cserét.

Az Agent Inspector-ral megvizsgálhat egy támogatott helyi Agent Framework-munkafolyamatot. A kódból származó spanok gyűjtéséhez vagy egy üzembe helyezett hosztolt ügynök vizsgálatához tekintse meg a Nyomkövetés a Foundry Toolkitben című témakört. Ezek a helyi ellenőrzési lépések nem helyettesítik a távoli tesztkörnyezetet egy deklaratív munkafolyamathoz.

Egyéb migrálási lehetőségek, például az Agent Framework deklaratív YAML-jei, Azure Logic Apps és közvetlen A2A-kapcsolatok esetén lásd a munkafolyamat migrálási útmutatóját.

Kapcsolódó tartalom

Az alábbi útmutatók segítségével választhatja ki és fejezheti be a migrálást:

  • Utolsó frissítés időpontja: