Utiliser et migrer des flux de travail d’agent déclaratifs avec Microsoft Foundry Toolkit

Utilisez Microsoft Foundry Toolkit pour Visual Studio Code pour travailler avec des flux de travail déclaratifs existants et les préparer à la migration. Vous pouvez tester un flux de travail enregistré, modifier son YAML exporté et utiliser GitHub Copilot pour convertir la définition en code agent Framework Microsoft.

Important

Les flux de travail déclaratifs dans Microsoft Foundry sont en préversion et mis hors service le 1er décembre 2026. Utilisez Microsoft Framework d’agent pour le nouveau développement de flux de travail. Cette mise hors service n’affecte pas l’orchestration basée sur le code dans les agents hébergés. Consultez le guide de migration de flux de travail pour connaître les chemins de migration pris en charge.

Prerequisites

Afficher un flux de travail d’agent déclaratif

Recherchez le flux de travail dans la liste des agents consolidés de votre projet.

  1. Dans la vue Foundry Toolkit , sous Mes ressources, confirmez le projet Foundry sélectionné.
  2. Sélectionnez Agents, puis sélectionnez l’onglet Flux de travail .
  3. Sélectionnez le nom du flux de travail pour ouvrir son terrain de jeu.
  4. Utilisez le sélecteur de version pour choisir la version enregistrée que vous souhaitez inspecter.

Le terrain de jeu montre le graphique de flux de travail et une zone de conversation. Le graphique est en lecture seule. Utilisez le yaML exporté ou le portail Foundry pour modifier la définition.

Modifier une définition de flux de travail existante

Exportez la définition avant de la modifier ou de la migrer. Conservez une copie du YAML d’origine afin de pouvoir la comparer à vos modifications.

  1. Ouvrez le flux de travail existant dans le portail Foundry.
  2. Dans le concepteur de flux de travail, basculez vers la vue YAML et copiez ou exportez la définition. Pour plus d’informations, consultez Exporter votre définition de flux de travail.
  3. Enregistrez la définition dans votre espace de travail local sous un nom se terminant par .workflow.yaml, tel que support.workflow.yaml.
  4. Ouvrez le fichier dans Visual Studio Code et modifiez le fichier YAML.
  5. Enregistrez le fichier. Les modifications apportées aux fichiers locaux ne mettent pas à jour le flux de travail dans Foundry.

Enregistrer une nouvelle version du flux de travail existant

Avant la mise hors service, vous pouvez déployer une définition modifiée dans le même flux de travail. Confirmez le nom du projet et du flux de travail pour éviter de créer une autre ressource.

  1. Vérifiez que le projet du flux de travail d’origine est sélectionné dans Foundry Toolkit.
  2. Une fois le .workflow.yaml fichier ouvert, sélectionnez Déployer dans la barre d’outils de l’éditeur.
  3. Dans Entrer le nom du flux de travail, entrez le nom du flux de travail existant.
  4. Attendez la notification de réussite du déploiement.
  5. Rouvrez le flux de travail à partir duflux de travailAgents> et sélectionnez la nouvelle version.

Le déploiement avec un nom de workflow existant crée une nouvelle version. Un autre nom crée un flux de travail distinct ; n’utilisez pas ce chemin pour démarrer le nouveau développement de flux de travail.

Tester un flux de travail dans le terrain de jeu

Testez la version enregistrée que vous envisagez de conserver ou de migrer. Utilisez les mêmes requêtes ultérieurement pour comparer l’implémentation migrée.

  1. Ouvrez le terrain de jeu du flux de travail et sélectionnez la version requise.
  2. Sous l’onglet Terrain de jeu , sélectionnez Nouveau pour démarrer une nouvelle session de terrain de jeu.
  3. Saisissez une requête qui teste le flux de travail et envoyez-la.
  4. Passez en revue la réponse et le graphique d’exécution. Vérifiez que les agents, branches et étapes attendus s’exécutent.
  5. Répétez l’opération avec des requêtes testant différents chemins d’exécution, des entrées manquantes et toutes les étapes d’approbation de votre workflow.

Le playground exécute le workflow Foundry enregistré. Il n'exécute pas de modifications non enregistrées dans votre fichier YAML local ou le code généré par Copilot.

Convertir un flux de travail YAML en code Agent Framework

Utilisez l'action de génération de code du terrain de jeu pour demander GitHub Copilot pour convertir la définition de flux de travail sélectionnée. Le code généré est un point de départ que vous devez examiner et tester.

  1. Dans le terrain de jeu de flux de travail, sélectionnez la version à migrer.
  2. Sélectionnez Générer du code.
  3. Choisissez Python ou C#.
  4. Passez en revue la demande de conversion dans Copilot Chat et suivez ses invites pour générer le code.
  5. Passez en revue le projet généré, les dépendances, les connexions de modèle, les outils et la configuration de l’authentification.
  6. Comparez son orchestration avec le YAML exporté. Vérifiez les branchements, les variables, les appels d’agent et les étapes d’approbation humaine.
  7. Exécutez le code localement et testez-le avec les demandes que vous avez utilisées pour le flux de travail d’origine. Utilisez Agent Inspector pour examiner l’exécution.
  8. Lorsque le code se comporte comme requis, suivez Créer des agents hébergés pour préparer un projet d’agent hébergé pris en charge, le déployer et tester la version déployée.

La conversion de code ne déploie pas d’agent hébergé ni ne garantit un comportement équivalent. Conservez la définition d’origine jusqu’à ce que vous terminez la migration et confirmez que les applications dépendantes utilisent le remplacement.

Utilisez Agent Inspector pour inspecter un flux de travail Agent Framework local pris en charge. Pour collecter des spans à partir de ce code ou examiner un agent hébergé déployé, consultez Traçage dans Foundry Toolkit. Ces étapes d’inspection locales ne remplacent pas le playground distant pour un flux de travail déclaratif.

Pour d’autres options de migration, notamment Agent Framework déclaratif en YAML, Azure Logic Apps et les connexions A2A directes, consultez le guide de migration des workflows.

Contenu connexe

Utilisez ces guides pour choisir et terminer votre migration :

  • Dernière mise à jour :