オプション: Foundry を組み込む

このオプションの学習では、GitHub Copilot app の Microsoft Foundry Canvas を使い、Tailspin Toys に Backer Concierge を追加します。カタログに基づくモデルの実験から始め、ホステッドエージェントの構築、ローカル Web サイトへの統合へと進みます。

学習の流れ

各モジュールの最後にはチェックポイントがあり、安全に中断できます。学習全体を通じて、同じ Tailspin Toys リポジトリ、worktree ブランチ、Issue にリンクされたセッション、Foundry プロジェクト、モデルデプロイを使用します。

プロジェクトとモデルを準備するでは、カタログで扱える情報の範囲を定め、プロジェクトとモデルデプロイを作成し、Canvas で確認します。
エージェントを構築してデプロイするでは、Backer Concierge のひな形を作成してローカルでテストし、ホステッドエージェントをデプロイして再テストします。
エージェントをサイトに接続するでは、資格情報を保護するローカルプロキシ、アクセシビリティに配慮したチャットウィジェット、エンドツーエンドテストを追加します。

Microsoft Foundry Canvas とホステッドエージェントはパブリックプレビュー段階です。

この学習では、モデルデプロイや、モジュール 2 以降のホステッドエージェントなど、課金対象の Azure リソースを作成します。リソースを作成する前に、サブスクリプション、リージョン、クォータ、推定コストの承認が必要です。プロジェクトとモデルの作成だけで中断する場合も、クリーンアップが必要です。

プロジェクトとモデルを準備するから始めます。作業は、このワークショップのコンテンツリポジトリではなく、Tailspin Toys リポジトリで進めてください。
コアワークショップを完了する場合は、レビューと次のステップに進んでください。

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

どのチェックポイントで実験を終える場合も、不要なコストを避けるために Azure リソースを削除します。クリーンアップすると後続のモジュールに必要なリソースも削除されるため、後で続行するには再作成が必要です。

rg-tailspin-toys がこの演習専用で、保持する必要があるリソースを含んでいない場合にのみ削除してください。共有リソースグループを削除すると、関係のないリソースも削除されます。

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

起動したローカルの Agent Inspector、Azure Function、Astro 開発サーバーを、それぞれのターミナルで停止します。
モジュール 2 または 3 でホステッドエージェントをデプロイした場合は、同じ Tailspin Toys worktree でターミナルを開き、同じ 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
```

リソース

Microsoft のドキュメントで、Canvas、ホステッドエージェントのデプロイ、およびそれらのアクセス許可について説明されています。