省略可能: Foundry を組み込む

← 前のレッスン: GitHub Copilot の作業を反復して改善する

必須の VS Code コースは演習 6 で完了です。この省略可能な拡張演習では、VS Code の GitHub Copilot Chat と Microsoft Foundry Toolkit を使って Tailspin のカタログを Backer Concierge に活用し、ホスト型エージェントとしてデプロイして、ローカルプロキシ経由でサイトに接続します。

シナリオ

支援者からは、フィルターでは答えられない質問が寄せられます。git の言葉遊びが好きな人に合うゲームはどれか、あるパズルゲームが別のゲームより自分に向いている理由は何か、といった質問です。Tailspin Toys には、カタログに実在するタイトルを勧め、必要に応じて確認の質問をし、資金調達額などの情報がないときはそのことを率直に伝えて信頼を得るコンシェルジュが必要です。

モジュール

各モジュールは、動作を確認できるチェックポイントで終わります。3 つのモジュールを通して、同じ受講者用リポジトリ、機能ブランチ、Foundry プロジェクトを使います。モジュールの間でプロジェクトを作り直すことはありません。

モジュール	完了時のチェックポイント
1. プロジェクトとモデルを準備する	カタログをエクスポートし、デプロイ済みモデルが根拠に基づいて回答するためのルールに従うことを検証済み
2. エージェントを構築してデプロイする	ローカルエージェントをデバッグし、ホスト型エージェントをテスト済み
3. エージェントをサイトに接続する	ローカルプロキシとアクセシビリティに対応したウィジェットをエンドツーエンドでテスト済み

Microsoft Foundry Toolkit とホスト型エージェントはパブリックプレビューです。これらのモジュールでは、モデルのデプロイやホスト型エージェントなど、課金対象の Azure リソースを作成します。サブスクリプションの権限、リージョンでの提供状況、クォータ、費用によっては参加が制限される場合があります。

始める前に

この拡張演習では、ワークショップのドキュメント用リポジトリではなく、自分の Tailspin Toys リポジトリを使います。

省略可能な機能に着手する前に、必須演習の作業を保存、コミット、プッシュ済みであることを確認します。
プロジェクトとモデルを準備するから始めます。再開する場合は、Tailspin Toys リポジトリを foundry-agent-vscode ブランチで開き直し、Foundry Toolkit > My Resources に tailspin-toys プロジェクトとそのモデルデプロイが残っていることを確認します。
どのモジュールで終了する場合も、次のモジュール用に意図的にリソースを残し、継続的な費用を受け入れるのでなければ、リソースをクリーンアップするの手順に従います。

リソースをクリーンアップする

どのチェックポイントであっても、試すのを終えたら、不要な費用が発生しないように Azure リソースを削除します。クリーンアップでは後続のモジュールで必要なリソースも削除されるため、その後に続ける場合は作り直しが必要です。

rg-tailspin-toys を削除するのは、このリソースグループがこの演習専用で、残しておきたいリソースが含まれていない場合だけにしてください。共有リソースグループを削除すると、無関係なリソースも削除されます。

モジュール 1 で別のリソースグループ名を承認した場合は、以下のすべてのコマンドで rg-tailspin-toys をその名前に置き換えてください。

起動した Agent Inspector のデバッグセッション、Azure Functions ホスト、Astro 開発サーバーを、それぞれのターミナルで停止します。
モジュール 2 でホスト型エージェントをデプロイした場合は、azure.yaml がある生成済みエージェントディレクトリでターミナルを開き、同じ azd 環境を選択してから次のコマンドを実行します。
Terminal window
```
azd down --purge
```
選択されているサブスクリプションと、ワークショップのリソースグループがまだ存在するかどうかを確認します。
Terminal window
```
az account show --output table
az group exists --name rg-tailspin-toys
```
コマンドが false を返した場合、クリーンアップは完了です。true を返した場合は、グループ内のリソースを調べます。
Terminal window
```
az resource list --resource-group rg-tailspin-toys --output table
```
残っているリソースがすべてこの演習のものであることを確認します。モジュール 1 で終了した場合は、azd サービスをデプロイしていなくても、Foundry プロジェクトとモデルのクリーンアップが必要です。
ワークショップ専用のリソースグループがまだ存在し、削除する予定のリソースだけが含まれている場合は、次のコマンドを実行します。
Terminal window
```
az group delete --name rg-tailspin-toys --yes --no-wait
```
--no-wait は削除の完了前に制御を返すため、次のコマンドが false を返すまで繰り返し実行します。
Terminal window
```
az group exists --name rg-tailspin-toys
```

リソース

次のモジュール: プロジェクトとモデルを準備する →