Microsoft Foundry Toolkit を使用した宣言型エージェント ワークフローの使用と移行

Microsoft Foundry Toolkit for Visual Studio Codeを使用して、既存の宣言型ワークフローを操作し、移行用に準備します。 保存されたワークフローをテストし、エクスポートした YAML を編集し、GitHub Copilotを使用して、定義を Agent Framework コードMicrosoft変換できます。

Important

Microsoft Foundry の宣言型ワークフローはプレビュー段階であり、2026 年 12 月 1 日に廃止されます。 新しいワークフロー開発には、Microsoft Agent Framework を使用します。 この廃止は、ホストされているエージェントのコード ベースのオーケストレーションには影響しません。 サポートされている移行パスについては、 ワークフロー移行ガイド を参照してください。

前提条件

宣言型エージェント ワークフローを表示する

プロジェクトの統合エージェントの一覧でワークフローを見つけます。

  1. Foundry Toolkit ビューの [マイ リソース] で、選択した Foundry プロジェクトを確認します。
  2. [エージェント] を選択し、[ワークフロー] タブを選択します。
  3. ワークフロー名を選択して、そのプレイグラウンドを開きます。
  4. バージョン セレクターを使用して、検査する保存済みのバージョンを選択します。

プレイグラウンドには、ワークフロー グラフと会話領域が表示されます。 グラフは読み取り専用です。 エクスポートした YAML または Foundry ポータルを使用して定義を編集します。

既存のワークフロー定義を編集する

編集または移行する前に、定義をエクスポートします。 変更と比較できるように、元の YAML のコピーを保持します。

  1. Foundry ポータルで既存のワークフローを開きます。
  2. ワークフロー デザイナーで 、YAML ビューに切り替えて、定義をコピーまたはエクスポートします。 詳細については、「 ワークフロー定義をエクスポートする」を参照してください。
  3. support.workflow.yamlなど、.workflow.yamlで終わる名前で定義をローカル ワークスペースに保存します。
  4. Visual Studio Codeでファイルを開き、YAML を編集します。
  5. ファイルを保存します。 ローカル ファイルの変更では、Foundry のワークフローは更新されません。

既存のワークフローの新しいバージョンを保存する

提供終了の前に、編集した定義を同じワークフローにデプロイできます。 別のリソースが作成されないように、プロジェクトとワークフローの名前を確認します。

  1. Foundry Toolkit で元のワークフローのプロジェクトが選択されていることを確認します。
  2. .workflow.yaml ファイルを開いた状態で、エディター ツール バーの [配置] を選択します。
  3. [ ワークフロー名の入力] に、既存のワークフローの名前を入力します。
  4. デプロイの成功通知を待ちます。
  5. Agents>Workflow からワークフローを再度開き、新しいバージョンを選択します。

既存のワークフロー名を使用してデプロイすると、新しいバージョンが作成されます。 別の名前を指定すると、別のワークフローが作成されます。このパスを使用して新しいワークフロー開発を開始しないでください。

プレイグラウンドでワークフローをテストする

保守または移行する予定の保存済みバージョンをテストします。 後で同じ要求を使用して、移行された実装を比較します。

  1. ワークフローのプレイグラウンドを開き、必要なバージョンを選択します。
  2. [ プレイグラウンド ] タブで、[ 新規 ] を選択して新しいプレイグラウンド セッションを開始します。
  3. ワークフローを実行する要求を入力して送信します。
  4. 応答と実行グラフを確認します。 想定されるエージェント、ブランチ、およびステップが実行されることを確認します。
  5. 異なる分岐、不足している入力、およびワークフロー内の承認手順を実行する要求を繰り返します。

プレイグラウンドは、保存された Foundry ワークフローを実行します。 ローカル YAML ファイルや、Copilot生成されるコードでは、未保存の変更は実行されません。

YAML ワークフローを Agent Framework コードに変換する

プレイグラウンドのコード生成アクションを使用して、選択したワークフロー定義を変換するようにGitHub Copilotに依頼します。 生成されたコードは、確認してテストする必要がある開始点です。

  1. ワークフロープレイグラウンドで、移行するバージョンを選択します。
  2. [ コードの生成] を選択します。
  3. Pythonまたは C# を選択します。
  4. Copilot Chatで変換要求を確認し、プロンプトに従ってコードを生成します。
  5. 生成されたプロジェクト、依存関係、モデル接続、ツール、認証構成を確認します。
  6. そのオーケストレーションとエクスポートされた YAML を比較します。 分岐、変数、エージェント呼び出し、および人間による承認の手順を確認します。
  7. コードをローカルで実行し、元のワークフローに使用した要求でテストします。 Agent Inspector を使用して実行を検査します。
  8. コードが必要に応じて動作する場合は、「 ホストされたエージェントを作成 する」に従って、サポートされている hosted-agent プロジェクトを準備し、デプロイし、デプロイされたバージョンをテストします。

コード変換では、ホストされたエージェントがデプロイされたり、同等の動作が保証されたりすることはありません。 移行が完了するまで元の定義を保持し、依存アプリケーションで置換が使用されていることを確認します。

Agent Framework 宣言型 YAML、Azure Logic Apps、直接 A2A 接続など、その他の移行の選択肢については、ワークフロー移行ガイドを参照してください。

関連するコンテンツ

移行を選択して完了するには、次のガイドを使用します。

  • Last updated on