Visual Studio Code における Foundry Toolkit の入門
プロトタイプは素晴らしく見えるのに、チームの作業が遅いと感じる瞬間をご存知ですか？通常、それはモデルの品質が原因ではありません。ワークスペースの拡散が原因です。モデルの検索は別の場所、プロンプトのテストは別の場所、デプロイメントのチェックはさらに別の場所で行われているような状態です。
この章では、日々の作業が明確で、高速で、そして正直なところもっと楽しくなるように、それらを Visual Studio Code 内の 1 つのフローにまとめます。
分断されたツール間を行き来する必要はもうありません。
この章を終える頃には、Foundry Toolkit のインストールと接続が完了し、実際のモデルやエージェントの作業の準備が整っているでしょう。単にどこをクリックすればいいかが分かるだけでなく、なぜこのセットアップの順序が機能するのか、そしてなぜ次の章がよりスムーズに進められるのかを理解できるようになります。
目標はシンプルです：セットアップの手間を減らし、開発により多くの時間を割くことです。
各セットアップ手順はそれ単体でも有用ですが、真の魔法はそれらが一体となって動作するときに現れます。
学習内容
本題に入る前に、具体的な目標を設定しましょう。これはランダムな機能のツアーではありません。シリーズを通じて信頼できるワークスペースを構築するための実践的なビルドパスです。
この章では、以下の方法を学びます：
- 準備完了したワークスペースのセットアップ: Foundry Toolkit をインストールし、主要なサーフェスが表示されていることを確認します。
- クラウドプロジェクトの接続: Foundry プロジェクトをアタッチし、ローカルでの探索から実際のクラウド資産へ移行できるようにします。
- 再現可能な最初のフローの実行: 将来の貢献者のためにチームが再利用できるシーケンスに従います。
目的地が明確になったところで、他のすべてを腑に落ちさせるための重要なアイデアを 1 つ紹介します。
簡易的なマップを使用すると、詳細に入る前に章の流れを把握しやすくなります。セットアップを進める際の「現在地」を示す看板と考えてください。
図 01: 最初のインストールからモデル準備完了ワークスペースまでの第 1 章の道のり。
問題の定義: なぜ 1 つのワークスペースが学習速度を変えるのか
Foundry Toolkit を考える上で役立つ見方は、単にボタンが多い拡張機能ではなく、フィードバックループのアクセラレータとして捉えることです。検出、プロンプトのテスト、エージェントのセットアップ、デプロイメントのチェックが 1 か所に集約されていると、タブの切り替えに費やす時間が減り、結果の改善により多くの時間を割くことができます。
小さな変化が大きな成果をもたらします。特に、より多くのメンバーがプロジェクトに参加するようになると顕著です。
試してみる
簡単なテストとして、2 つのワークフローを比較してみてください。1 つはポータルとドキュメントの間を行き来するワークフロー、もう 1 つはほとんどのタスクを Visual Studio Code 内で行うワークフローです。2 つ目のフローでは通常、より速いイテレーション、引き継ぎミスの減少、そして複数の人が同じプロジェクトに触れる際の明確な責任の所在が実現されます。
前提条件
何かをインストールする前に、簡単な準備状況の確認を行いましょう。初回実行時の摩擦のほとんどは、製品の複雑さではなく、環境のギャップに起因します。
これらを今検証しておけば、後で面倒な遠回りを避けることができます。
- Visual Studio Code: 拡張機能のインストールとコマンドが期待どおりに動作するように、インストールおよび更新されていること。
- 拡張機能へのアクセス: [拡張機能] ビューを開き、マーケットプレイスの拡張機能をインストールできること。
- クラウド アカウント: クラウドで Foundry リソースを作成する場合の Microsoft アカウントと Azure サブスクリプション。
- GitHub Copilot: オプションですが、ガイド付きプロンプトやセットアップの自動化を行いたい場合には強く推奨されます。
このベースラインが整ったところで、Foundry Toolkit が実際に提供する機能を見ていきましょう。
簡単な自信の確認: 拡張機能を開き、ツールをインストールし、プロンプトが表示されたときにサインインできれば、すでに最も困難な部分はクリアしています。
Foundry Toolkit とは？
Foundry Toolkit は、エディターから離れることなく AI ソリューションの構築、テスト、評価、デプロイを行うための Visual Studio Code 拡張機能です。分断されたツールをつなぎ合わせる代わりに、モデルの検出、プロンプトのイテレーション、エージェントの開発、評価、ファインチューニング、デプロイのための統合された単一のフローを利用できます。
意欲を高めていただくために、この章およびそれ以降で使用する主な機能のリストを簡単にご紹介します。
- モデルの検出: 1 つのカタログから、プロバイダーをまたいでモデルを閲覧できます。
- プロンプトの実験: プレイグラウンド ワークフローでプロンプトをテストし、反復改良します。
- エージェントの開発: ローコードまたはプロコードのアプローチでエージェントを構築します。
- デバッグの可視性: Agent Inspector を使用して、動作や実行パスを検査します。
- 品質測定: 組み込みのメトリックを使用して出力を評価します。
- デプロイメント フロー: 同じ環境からソリューションを本番環境にプッシュし、パフォーマンスを監視します。
これからインストールする拡張機能です。シリーズの大部分を通じて、繰り返し戻ってくることになる中心的な画面です。
図 1: Visual Studio Code 内の Foundry Toolkit 拡張機能
演習 - Foundry Toolkit のインストール
次のステップに進むために、Foundry Toolkit をインストールしましょう。Visual Studio Code マーケットプレイス、または [拡張機能] ビューから直接インストールできます。
-
Visual Studio Code を開き、アクティビティ バーから [拡張機能] ビューを開きます。
-
検索バーで「Foundry Toolkit」を検索します。
-
Foundry Toolkit 拡張機能の [インストール] をクリックします。
これで拡張機能のインストールが完了し、使用準備が整いました。次に、拡張機能のレイアウトと主要なセクションについて確認します。
拡張機能のレイアウト: 表示内容
Foundry Toolkit をインストールしたら、レイアウトや必要なツールのありかを把握しておきましょう。この拡張機能は、「My Resources」、「Developer Tools」、「Feedback」という 3 つの主要なセクションに分かれています。これらのセクションは、チームが実際に開発を行う方法を反映しています。このレイアウトを早い段階で習得しておくと、ツールを探す時間を節約でき、新しいチームメンバーが状況に慣れるまでの時間を大幅に短縮できます。
3 つの主要なセクションとそれらの関係性を示す図を以下に示します。
図 02: Foundry Toolkit の情報アーキテクチャとコア作業領域。
これで、片側にリソース、中央に構築ツール、オンデマンドでサポート経路があるという、すっきりとしたメンタルモデルが構築されたはずです。これが腑に落ちれば、次のステップがずっと軽く感じられるようになります。
My Resources
このセクションには、ローカルおよび接続されたクラウド環境の両方で、すでに使用可能なものが表示されます。インベントリであり、作業を始められる状態にあるかをすばやく確認するためのチェック手段と考えてください。
セットアップが正常に機能したかどうかわからない場合は、まずここを確認してください。[My Resources] をざっと見れば、作業を継続できるか、それとももう 1 つ接続が必要なのかが通常はわかります。
このセクションの表示が正常であれば、順調に進んでいます。
- Recent agents: 最近作成または編集されたエージェントへのクイック アクセス。
- Local resources: マシン上で利用可能なモデル、ツール、およびアセット。
- Foundry resources: Azure バックアップされたプロジェクトから接続されたクラウド リソース。
- Connected resources: 外部プロバイダーおよび統合サービス。
リソースが表示されたら、実際に開発を行うセクションに進みましょう。
図 03: ローカルおよびクラウドのアセットを表示している Foundry Toolkit の [My Resources] セクション。
Developer Tools
ここは、ほとんどの実装作業が行われる場所です。モデルの探索からエージェントの開発、そして検証へと進むために使用します。
プロジェクトの成長に伴い、ここは日々のコントロール センターになります。
ここを自分の実行レーンと考えてください。章ごとの作業のほとんどはここから始まるため、早い段階で慣れておくことで、すぐに効果が現れます。
- Discover: MCP ベースのツール コレクションを含む、モデル カタログとツール カタログ。
- Build: エージェントの作成、Agent Inspector、ホストされたエージェントの管理、およびプレイグラウンド ワークフロー。
- Monitor: トレーシング、期待される動作に対する評価、およびモデルのプロファイリング。
ソリューションの構築とテストを進める中で、改善を続けるためにサポートやフィードバックのチャネルが必要になる場合があります。
図 04: [Discover]、[Build]、[Monitor] の各領域を表示している Foundry Toolkit の [Developer Tools] セクション。
フィードバック
このセクションは、不明な点がある場合や製品エクスペリエンスを向上させたい場合に、ループを閉じる（解決する）のに役立ちます。ドキュメント、サポート、フィードバックをコンテキスト内で見つけやすく保ちます。
すべてが順調に機能しているときは、このセクションを無視しがちです。しかし、トラブルシューティングの時間を短縮し、チーム間の引き継ぎを改善するため、日々のルーティンに含めておくようにしましょう。
- Documentation access: 機能とワークフローに関する公式ガイド。
- Support channels: トラブルシューティングおよび問題解決へのパス。
- Feedback routes: 製品のフィードバックや改善要望を共有するための方法。
初期セットアップの手順を一緒に進めましょう。
簡単な質問
もし今週チームが 1 つだけ改善できるとしたら、モデルの発見速度、プロンプトの反復速度、デプロイメントの一貫性のうち、どこで最大の即時的メリットが得られるでしょうか？
回答
ライフサイクルの初期段階にあるほとんどのチームにとって、プロンプトの反復速度は、日々の出力品質にほぼ即座に影響するため、最も目に見えるリターンを素早くもたらします。すでに安定したプロンプトを作成できているチームの場合、次に直面するボトルネックは多くの場合デプロイメントの一貫性になります。鍵となるのは、現在のフローで最も遅い繰り返しステップを選び、それを最初に最適化することです。
今後の展望
これで、Visual Studio Code 内の Foundry Toolkit で効果的に作業するための基礎が整いました。次は、セットアップから積極的な実験へと移行し、モデルの比較とプロンプトの反復を通じて初めての実世界のエージェントの動作を形作ります。そこから、より緩やかな学習曲線でエージェントの作成、評価、デプロイへと発展させることができます。
次の章では、モデルカタログとプレイグラウンドのワークフローについてさらに詳しく掘り下げ、実践的でシナリオベースのプロンプトを使用してモデルの動作を比較できるようにします。ここからが、品質、速度、コストという本当に楽しいトレードオフの始まりです。
詳細情報
この章の後も学習を続けたい場合、最適な次のステップは、実際のプロジェクトで使用するのと同じ順序でワークフローに従うことです。セットアップとモデルの探索から始め、エージェントの構築とホストされたデプロイへと進みます。以下のリファレンスは、その進行をサポートするように整理されています。
- Foundry Toolkit for VS Code - Visual Studio Marketplace: Foundry Toolkit for VS Code - Visual Studio Marketplace
- Visual Studio Code AI アプリの概要: 製品レベルのコンテキストと機能について理解するために、Visual Studio Code ドキュメントのインテリジェント アプリの概要を確認する。
- Foundry Toolkit クイック スタート: 初回実行時のセットアップのコンテキストについて理解するために、Azure AI Foundry の概要とオンボーディング ガイダンスを確認する。
- モデル カタログとプレイグラウンド: モデルを比較して選択するために、モデル カタログの概要を調べる。
- Agent Builder ワークフロー: エージェントのワークフローを構築およびテストするために、Azure AI エージェントのクイックスタートに従う。
- ホストされたエージェントのライフサイクル: デプロイと運用のコンテキストについて理解するために、Azure AI エージェントの概念とライフサイクルのガイダンスを確認する。