Usare ed eseguire la migrazione di flussi di lavoro dell'agente dichiarativo con Microsoft Foundry Toolkit

Usare Microsoft Foundry Toolkit per Visual Studio Code per lavorare con flussi di lavoro dichiarativi esistenti e prepararli per la migrazione. È possibile testare un flusso di lavoro salvato, modificarne il file YAML esportato e usare GitHub Copilot per convertire la definizione in codice Microsoft Agent Framework.

Importante

I flussi di lavoro dichiarativi in Microsoft Foundry sono in anteprima e vengono ritirati il 1° dicembre 2026. Usare Microsoft Agent Framework per lo sviluppo di nuovi flussi di lavoro. Questo ritiro non influisce sull'orchestrazione basata su codice negli agenti ospitati. Vedere la guida alla migrazione del flusso di lavoro per i percorsi di migrazione supportati.

Prerequisiti

Visualizzare un flusso di lavoro dell'agente dichiarativo

Trovare il flusso di lavoro nell'elenco degli agenti consolidati del progetto.

  1. Nella visualizzazione Foundry Toolkit , in Risorse personali, confermare il progetto Foundry selezionato.
  2. Selezionare Agenti e quindi selezionare la scheda Flusso di lavoro .
  3. Seleziona il nome del workflow per aprirne il playground.
  4. Usare il selettore di versione per scegliere la versione salvata da controllare.

Il playground mostra il grafico del flusso di lavoro e un'area di conversazione. Il grafico è di sola lettura. Usare il file YAML esportato o il portale foundry per modificare la definizione.

Modificare una definizione del flusso di lavoro esistente

Esportare la definizione prima di modificarla o eseguirne la migrazione. Conservare una copia del file YAML originale in modo da poterlo confrontare con le modifiche.

  1. Apri il flusso di lavoro esistente nel portale Foundry.
  2. Nella finestra di progettazione del flusso di lavoro passare alla visualizzazione YAML e copiare o esportare la definizione. Per informazioni dettagliate, vedere Esportare la definizione del flusso di lavoro.
  3. Salvare la definizione nell'area di lavoro locale con un nome che termina in .workflow.yaml, ad esempio support.workflow.yaml.
  4. Aprire il file in Visual Studio Code e modificare il file YAML.
  5. Salva il file. Le modifiche ai file locali non aggiornano il flusso di lavoro in Foundry.

Salvare una nuova versione del flusso di lavoro esistente

Prima del ritiro, è possibile distribuire una definizione modificata nello stesso flusso di lavoro. Confermare il nome del progetto e del flusso di lavoro per evitare di creare una risorsa diversa.

  1. Verificare che il progetto del flusso di lavoro originale sia selezionato in Foundry Toolkit.
  2. Con il .workflow.yaml file aperto, selezionare Distribuisci sulla barra degli strumenti dell'editor.
  3. In Immettere il nome del flusso di lavoro immettere il nome del flusso di lavoro esistente.
  4. Attendere la notifica di esito positivo della distribuzione.
  5. Riapri il workflow da Agents> e seleziona la nuova versione.

La distribuzione con un nome di flusso di lavoro esistente crea una nuova versione. Un nome diverso crea un flusso di lavoro separato; non usare questo percorso per avviare il nuovo sviluppo del flusso di lavoro.

Testare un flusso di lavoro nel playground

Testare la versione salvata che si prevede di gestire o eseguire la migrazione. Usare le stesse richieste in un secondo momento per confrontare l'implementazione migrata.

  1. Apri l'ambiente di test del flusso di lavoro e seleziona la versione richiesta.
  2. Nella scheda Playground selezionare Nuovo per avviare una nuova sessione del playground.
  3. Immettere una richiesta che esercita il flusso di lavoro e inviarla.
  4. Esaminare la risposta e il grafico di esecuzione. Verificare che gli agenti, i rami e i passaggi previsti vengano eseguiti.
  5. Ripeti con richieste che coprono percorsi diversi, dati di input mancanti ed eventuali passaggi di approvazione del tuo flusso di lavoro.

Il playground esegue il flusso di lavoro Foundry salvato. Non esegue modifiche non salvate nel file YAML locale o nel codice generato Copilot.

Convertire un flusso di lavoro YAML nel codice di Agent Framework

Usare l'azione di generazione del codice del playground per chiedere GitHub Copilot di convertire la definizione del flusso di lavoro selezionata. Il codice generato è un punto di partenza che è necessario esaminare e testare.

  1. Nell'ambiente di prova del flusso di lavoro, seleziona la versione da migrare.
  2. Selezionare Genera codice.
  3. Scegliere Python o C#.
  4. Esaminare la richiesta di conversione in Copilot Chat e seguire le istruzioni per generare il codice.
  5. Esaminare il progetto generato, le dipendenze, le connessioni al modello, gli strumenti e la configurazione di autenticazione.
  6. Confrontare l'orchestrazione con il file YAML esportato. Controlla le ramificazioni, le variabili, le chiamate dell'agente e i passaggi di approvazione umana.
  7. Eseguire il codice in locale e testarlo con le richieste usate per il flusso di lavoro originale. Utilizza Agent Inspector per ispezionare l'esecuzione.
  8. Quando il codice si comporta come richiesto, seguire Creare agenti ospitati per preparare un progetto di agente ospitato supportato, distribuirlo e testare la versione distribuita.

La conversione del codice non distribuisce un agente ospitato o garantisce un comportamento equivalente. Mantenere la definizione originale fino a quando non si completa la migrazione e si conferma che le applicazioni dipendenti usano la sostituzione.

Per altre opzioni di migrazione, tra cui YAML dichiarativo di Agent Framework, App per la logica di Azure e connessioni A2A dirette, vedere la guida alla migrazione del flusso di lavoro.

Contenuti correlati

Usare queste guide per scegliere e completare la migrazione:

  • Last updated on