宣言型エージェント ワークフローでは、明示的なプログラミング ロジックではなく、構成を使用して、エージェントのアクションの定義済みシーケンスを定義します。 この記事では、 Foundry Agent ワークフロー をエージェントに追加し、 Microsoft Foundry for Visual Studio Code (VS Code) 拡張機能を使用してテストします。
ポータル で Foundry Agent Service でエージェントをビルド した後、ワークフローを追加して、複雑な自動化シナリオに対して定義済みのアクション シーケンスに複数のエージェントを調整できます。
Important
この記事で "(プレビュー)" と付記されている項目は、現在、パブリック プレビュー段階です。 このプレビュー版はサービス レベル アグリーメントなしで提供されています。運用環境のワークロードに使用することはお勧めできません。 詳細については、「 Microsoft Azure プレビューの追加使用条件」を参照してください。
[前提条件]
- 少なくとも 1 つのエージェントがデプロイされた Foundry プロジェクト。 Foundry ポータルで作成するには、「 クイック スタート: エージェントとのチャット」を参照してください。
- Foundry ポータルで作成された少なくとも 1 つのワークフロー。 ワークフローの詳細については、「 Foundry Agent ワークフロー」を参照してください。
- Microsoft Foundry for Visual Studio Code 拡張機能がインストールされています。
- GitHub Copilot サブスクリプション (YAML ワークフローを Agent Framework コードに変換するために必要)。
宣言型エージェント ワークフローを表示する
WEB 用 VS Code で宣言型エージェント ワークフローを表示および編集するには、まず Foundry ポータルでワークフローに移動します。
- Foundry ポータルで、ワークフローを含むプロジェクトを開きます。
- 左側のメニューから [ ワークフロー ] タブを選択します。
- 開くワークフローを選択します。
次に、次のいずれかのオプションを選択して、WEB 用 VS Code でワークフローを開きます。
VS Code for the Web で YAML ワークフローを開く
- [ ビルド ] タブを選択し、右側にある YAML ボタンを選択します。
- [ Web 用 VS Code で開く ] ボタンを選択します。 ワークフロー YAML ファイルが WEB エディターの VS Code で開き、左側に YAML 定義が表示され、右側にビジュアル ワークフロー グラフが表示されます。
- 必要に応じて YAML を編集してワークフローを変更します。 変更はビジュアル エディターに反映されます。
- 完了したら、右上隅の省略記号メニュー (...) から [デプロイ] を選択して、変更を Foundry に保存し直します。
Foundry ポータルからワークフロー コードを開く
- [ ビルド ] タブを選択し、右側にある [ コード ] ボタンを選択します。
- [Web 用に VS Code で開く ] ボタンを選択します。 ワークフロー コード ファイルが WEB エディターの VS Code で開き、左側にコード定義が表示され、右側にビジュアル ワークフロー グラフが表示されます。
- 必要に応じてコードを編集してワークフローを変更します。 変更はビジュアル エディターに反映されます。
- 完了したら、右上隅の省略記号メニュー (...) から [デプロイ] を選択して、変更を Foundry に保存し直します。
プレイグラウンドでワークフローをテストする
VS Code 拡張機能でリモート エージェントプレイグラウンドを使用して、宣言型エージェントワークフローをテストします。
- VS Code 拡張機能の [ マイ リソース ] セクションで、Foundry プロジェクトを見つけて選択します。
- 宣言型エージェント を選択します。
- テストするワークフローのバージョンを選択します。
- [リモート エージェントプレイグラウンド] ウィンドウが開き、エージェントとの会話が開始されます。
- [リモート エージェントプレイグラウンド] ウィンドウの下部にある入力ボックスにメッセージを入力し、Enter キーを押します。
- エージェントの応答を確認します。 応答がワークフローの定義されたアクションに対して想定される動作と一致することを確認します。
ヒント
[ツール] サブセクションからリモート エージェント プレイグラウンドを開き、ドロップダウン リストからエージェントを選択することもできます。
YAML ワークフローを Agent Framework コードに変換する
YAML ベースのワークフローをカスタマイズするには、GitHub Copilot を使用してそれらを Agent Framework コードに変換します。
- VS Code でワークフロー YAML ファイルを開きます。
- YAML エディターの右上にある [ コードの生成 ] ボタンを選択します。
- コードを生成するプログラミング言語 (Python または C#) を選択します。 GitHub Copilot によって、選択した言語のコード生成プロンプトが表示されたウィンドウが開き、YAML 定義に基づいて Agent Framework コードが生成されます。
- GitHub Copilot から生成されたコードをローカルで実行するかどうかを確認するメッセージが表示されたら、[ はい ] を選択してローカル ビジュアライザーを開きます。 エージェントの実行時に各ステップを確認できます。
- 要件に合わせて、生成されたコードを必要に応じて確認して変更します。
- 生成されたコード ファイルを右クリックし、[ Foundry に配置 ] を選択して、コードを Foundry プロジェクトにデプロイします。
- Foundry ポータルで、プロジェクトに移動し、コードが [エージェント] セクションに表示されることを確認します。