Microsoft Foundry for Visual Studio Code 拡張機能を使用する

この記事では、Visual Studio Code 拡張機能の Microsoft Foundry をインストールして使用する方法について説明します。 プロジェクトを作成し、Foundry モデル カタログからモデルをデプロイし、VS Code 内からモデルプレイグラウンドと対話します。

[前提条件]

• Azure サブスクリプション。 無料で作成。
• Visual Studio Code がインストールされています。
• この記事の新しいモデルをデプロイするには、サブスクリプションがクォータ制限を下回る必要があります。 既にクォータ制限に達している場合は、 チャット モデルをデプロイする必要があります。
• Foundry リソースを作成および管理するための適切な RBAC アクセス許可。 詳細については、Foundry のロールベースのアクセス制御を参照してください。

拡張機能をインストールする

VS Code で Foundry 機能を使用するには、Foundry for Visual Studio Code 拡張機能をインストールします。 Visual Studio Code Marketplace から、または VS Code 内から直接インストールします。

Visual Studio Code Marketplace からインストールする

最初に VS Code を開かずに拡張機能をインストールするには、マーケットプレースを使用します。

1. Foundry for Visual Studio Code 拡張機能ページを開きます。
2. [インストール] ボタンを選択します。
3. プロンプトに従って、Visual Studio Code に拡張機能をインストールします。
4. インストール後、Visual Studio Code を開き、ステータス メッセージから拡張機能が正常にインストールされていることを確認します。
5. FOUNDry アイコンは、VS Code の左側にあるプライマリ ナビゲーション バーに表示されます。

Visual Studio Code 内からインストールする

または、VS Code 拡張機能ビューから直接拡張機能を検索します。

1. VS Code を開きます。

2. 左側のウィンドウから [拡張機能 ] を選択します。

3. 拡張機能ウィンドウの右上にある [設定] アイコンを選択します。

4. Foundry を検索して選択します。

5. インストールを選択します。

6. インストールが完了すると、拡張機能がインストールされていることを確認するステータス メッセージが表示されます。 Foundry アイコンが左側のナビゲーション バーに表示されます。

Azure リソースに接続する

拡張機能をインストールしたら、Azure サブスクリプションにサインインし、Foundry projectを開いて、モデル、エージェント、プレイグラウンドの操作を開始します。

リソースにサインインする

拡張機能が Foundry プロジェクトとデプロイされたモデルをaccessできるように、Azure サブスクリプションにサインインします。

1. VS Code ナビゲーション バーのAzure アイコンを選択します。

2. Azureにサインイン...をAzure Resourcesビューで選択します。

3. Resources セクションで、Azureサブスクリプションとリソース グループを選択します。

4. Foundry を選択し、プロジェクトを右クリックします。

5. [Foundry Extension で開く] を選択します。

   Foundry project リソースが拡張機能ビューに表示され、FOUNDry アイコンが VS Code ナビゲーション バーに表示されます。

拡張機能インターフェイス内を移動する

Foundry 拡張機能は、ワークスペースを 3 つの主要なセクションに整理します。

projectを作成する

新しい Foundry projectを拡張機能から直接作成して、モデルとリソースを整理します。

1. Foundry 拡張機能ビューの [リソース] セクションの [リソース] の横にあるプラス アイコンを選択します。

   新しいリソース グループを作成するか、既存のリソース グループを選択できます。

2. 新しいリソース グループを作成するには:

   1. [ 新しいリソース グループの作成 ] を選択し、Enter キーを押します。

   2. Enter new resource group ボックスにAzureリソース グループ名を入力し、Enter キーを押します。

   3. 使用可能な場所の一覧から使用する場所を選択し、Enter キーを押します。

3. 既存のリソース グループを使用するには:

   • 使用可能なリソース グループの一覧から使用するリソース グループを選択し、Enter キーを押します。

4. Enter project name ボックスに Foundry project名を入力し、Enter キーを押します。

デプロイproject後、メッセージ Projectが正常にデプロイと共にポップアップが表示されます。

新しく作成したprojectにモデルをデプロイするには、ポップアップで Deploy a model ボタンを選択します。 このアクションにより、[ モデル カタログ ] ページが開き、 デプロイする目的のモデルを選択できます。

既定のprojectを切り替える

Foundry 拡張機能でprojectを開くと、そのprojectが既定のprojectとして設定されます。 既定のprojectを切り替えるには:

1. Foundryプロジェクトを右クリックし、Azure拡張機能でデフォルトプロジェクトを切り替えるオプションを選択します。

2. 使用可能なプロジェクトの一覧から使用する Foundry projectを選択し、Enter キーを押します。

選択したprojectに、project名の後に Default が表示されるようになりました。

モデルを操作する

Foundry 拡張機能を使用すると、 Foundry モデル カタログ のモデルを VS Code で直接検出、デプロイ、および操作できます。

モデル カタログを参照する

モデル カタログは、Microsoft、OpenAI、Meta、DeepSeek、およびその他のプロバイダーのモデルにaccessを提供します。 モデル カタログは、いくつかの方法で開くことができます。

• コマンド パレットから Foundry: Open Model Catalog コマンドを実行します。
• Foundry 拡張機能ビューの [リソース] セクションの [モデル] の横にあるプラス アイコンを選択します。
• Foundry 拡張機能ビューの [ツール] セクションで [モデル カタログ] リンクを選択します。

コマンド パレットからモデル カタログを開く

拡張ビューを移動せずにモデル カタログを開くには、コマンド パレットを使用します。

1. F1 キーを押してコマンド パレットを開きます。

2. Foundry と入力します。モデル カタログを開き、Enter キーを押します。

3. [ モデル カタログ] ページが開きます。

   

4. ページの上部にあるドロップダウンを使用して、Model Catalog を Hosted by、Publisher、Feature、または モデルタイプ によってフィルターします。 Fine-Tuning サポートトグルを選択して、微調整が可能なモデルを絞り込みます。

5. ページの上部中央にある検索バーを使用して、特定のモデルを検索します。

[リソース] セクションからモデル カタログを開く

Foundry 拡張機能ビューで、[モデル] の横にあるプラス アイコンを選択して、モデル カタログを開きます。

[ツール] セクションからモデル カタログを開く

Foundry 拡張機能ビューの [ ツール ] セクションで、[ モデル カタログ ] リンクをダブルクリックします。

モデル カタログからモデルをデプロイする

カタログ内でモデルを見つけたら、Foundry projectにデプロイして、アプリケーションで使用できるようにします。

1. 選択したモデル名の横にある [ デプロイ ] ボタンを選択します。

2. [ モデルのデプロイ] ページが開きます。

3. [デプロイ名の入力] ボックスにモデル のデプロイ名を入力 し、Enter キーを押します。

4. [デプロイの種類] ドロップダウンで デプロイの種類 を選択します。

5. [モデル バージョン] ドロップダウンで モデル バージョン を選択します。

6. (省略可能)[Tokens per minute]\(1 分あたりのトークン\) スライダーを使用して 、1 分あたりのトークンを 調整します。

7. 左下隅 にある [Foundry でデプロイ ] ボタンを選択します。

8. 確認ダイアログで、[デプロイ] を選択 します。

9. デプロイが完了すると、projectの Models セクションの下にデプロイ名でモデルが表示されます。

デプロイされたモデルの表示と管理

Foundry 拡張機能ビューの Models セクションを展開して、projectにデプロイされているすべてのモデルを表示します。

モデル カード情報の表示

デプロイされたモデルを選択して、次の詳細を含むパネルを開きます。

• デプロイ情報: 名前、プロビジョニング状態、デプロイの種類、レート制限、バージョン情報、モデル名、モデル バージョン。
• エンドポイント情報: ターゲット URI リンク、認証の種類、およびキー。
• 便利なリンク: コード サンプル リポジトリと AI アプリケーション開発のチュートリアル リンク。

モデルのデプロイ設定を更新する

レート制限などの展開設定を更新するには:

1. モデル カードの右上にある [編集] ボタンを選択します。
2. 編集可能なフィールドを更新します。
3. [保存] ボタンを選択して変更を適用します。

モデルのサンプル コードを生成する

デプロイされたモデルのスターター コード ファイルを生成して、アプリケーション開発を高速化します。

1. デプロイしたモデルを右クリックし、[ コード ファイルを開く] を選択します。

2. [Choose preferred SDK]\(優先 SDK の選択\) ドロップダウンで 、任意の SDK を選択 します。

3. [言語の選択] ドロップダウンで目的の 言語を選択 します。

4. [認証方法の選択] ドロップダウンで、優先 する認証方法を選択 します。

5. VS Code の新しいタブにサンプル コード ファイルが開きます。

次のスクリーンショットは、応答 API への同期呼び出しを行う生成された Python サンプルを示しています。

プレイグラウンドでモデルを操作する

モデルプレイグラウンドを使用して、デプロイされたモデルと対話形式でチャットし、設定を調整し、システム命令を変更します。

プレイグラウンドを開くには、Foundry 拡張機能ビューの [ツール] セクションにある [モデル プレイグラウンド] リンクをダブルクリックします。 または、デプロイしたモデルを右クリックし、[ プレイグラウンドで開く] を選択します。

1. プレイグラウンド ページが開きます。

2. プロンプトを入力し、出力を確認します。

3. 右上隅にある View code を選択して、プログラムでモデルのデプロイをaccessする方法を確認します。

4. プレイグラウンドの左上にある [履歴 ] リンクを選択して、チャット履歴を表示します。

一般的な問題のトラブルシューティング

Foundry 拡張機能の使用中に問題が発生した場合は、次の一般的な問題を確認してください。

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

この記事で作成したAzure リソースは、Azure サブスクリプションに課金されます。 今後これらのリソースが必要になるとは思わない場合は、削除して、より多くの料金が発生しないようにします。

モデルを削除する

1. VS Code ナビゲーション バーで、Foundry 拡張機能を更新します。 [ リソース ] セクションで、[ モデル ] サブセクションを展開します。

2. 削除するデプロイ済みモデルを右クリックし、[削除] を選択 します。

Azure リソースを削除する

リソース グループとその中のすべてのリソースを削除するには、次のようにします。

1. Azure portalを開きます。
2. Foundry projectが含まれているリソース グループに移動します。
3. [リソース グループの削除] を選択し、削除を確認します。

次のステップ

• Foundry モデルを調べる
• Foundry を使用してモデルをデプロイする