次の方法で共有

Visual Studio Code での Foundry クラシック エージェントの作成と管理 (プレビュー) (クラシック)

注

このドキュメントでは、 Microsoft Foundry (クラシック) ポータルを参照します。

🔍 新しいポータルの詳細については、Microsoft Foundry (新しい) ドキュメント を参照してください。

注

このドキュメントでは、エージェント API のクラシック バージョンを参照します。

Foundry Agent Service を使用すると、Visual Studio Code (VS Code) を離れることなく、エージェントをビルド、構成、デプロイできます。 この記事では、デザイナーを使用してエージェントを作成し、ツールを追加し、プレイグラウンドでエージェントをテストし、サンプル コードを生成し、完了したらリソースをクリーンアップします。

Important

この記事で "(プレビュー)" と付記されている項目は、現在、パブリック プレビュー段階です。 このプレビューはサービス レベル アグリーメントなしで提供されており、運用環境ではお勧めしません。 特定の機能はサポート対象ではなく、機能が制限されることがあります。 詳細については、「 Microsoft Azure プレビューの追加使用条件」を参照してください。

[前提条件]

デザイナーでエージェントを作成する

デザイナーには、エージェントの名前、モデル、命令、およびツールを構成するためのビジュアル インターフェイスが用意されています。

  1. Azure リソースにサインインします。

  2. 既定のプロジェクトを設定します。

  3. Foundry 拡張機能ビューで、[リソース] セクションのクラシック サブセクションを見つけます。

  4. [+] サブセクションの横にあるプラス () アイコンを選択して、新しいエージェントを作成します。

デザイナーでエージェントを構成する

保存場所を選択すると、エージェントの .yaml ファイルとデザイナー ビューが開きます。 次の設定を構成します。

  1. プロンプトで、エージェントの名前を入力します。

  2. ドロップダウン リストで、モデル デプロイの名前を選択します。 デプロイ名は、既存のモデルをデプロイしたときに選択した名前です。

  3. 拡張機能によって ID 値が生成されます。 次のフィールドを構成します。

    • エージェントの説明を追加します。
    • システム命令を設定します。
    • エージェント用のツールを構成します。

  4. .yaml ファイルを保存するには、VS Code メニュー バーの [ファイル>保存 ] を選択します。

エージェントの YAML 定義を確認する

デザイナーと共に .yaml ファイルが開き、エージェントの構成の詳細が含まれます。 形式は次の例のようになります。

# yaml-language-server: $schema=https://aka.ms/ai-foundry-vsc/agent/1.0.0
version: 1.0.0
name: my-agent
description: Description of the agent
id: ''
metadata:
  authors:
    - author1
    - author2
  tags:
    - tag1
    - tag2
model:
  id: 'gpt-4o-1'
  options:
    temperature: 1
    top_p: 1
instructions: Instructions for the agent
tools: []

エージェントにツールを追加する

エージェント サービスには、エージェントの機能を拡張し、データ ソースに接続するための次のツールが用意されています。

MCP ツールの使用の詳細については、「 Visual Studio Code でのエージェント サービスおよび MCP サーバー ツールの操作 (プレビュー)」を参照してください。

エージェントにツールを追加する

  1. デザイナーで、[ ツール ] セクションの右上隅にある [ ツールの追加] を選択します。 ドロップダウン リストで、追加するツールを選択します。

    エージェント デザイナーの [ツールの追加] ドロップダウンと、使用可能なツールの種類の一覧を示すスクリーンショット。

  2. デザイナーには、次の図に示すように、ツールを構成するための適切なウィンドウが表示されます。

    • Bing検索による基盤確立

      「Bing 検索ツールによるグラウンディング」ペインのスクリーンショット。

    • ファイル検索:

      ファイルのアップロード オプションを含む [ファイル検索ツールの構成] ウィンドウを示すスクリーンショット。

    • コード インタープリター:

      コード インタープリター ツールのペインのスクリーンショット。

    • OpenAPI 3.0 で指定されたツール:

      OpenAPI 3.0 で指定されたツールのペインのスクリーンショット。

  3. 必要な情報を入力したら、[ 作成と接続]、[ アップロードと保存]、または [ツールの作成] を選択します。 ボタン ラベルはツールの種類によって異なります。

    ツールが作成されると、デザイナーの TOOL セクションに表示されます。

ツールを追加するときに、必要な新しいアセットを追加することもできます。 たとえば、ファイル検索ツールを追加する場合は、既存のベクター ストア アセットを使用するか、新しいアセットを作成してアップロードしたファイルをホストできます。

エージェントを Foundry にデプロイする

エージェントの構成が完了したら、クラウドで実行されるように Foundry にデプロイします。

  1. デザイナーで、[ Microsoft Foundry でのエージェントの作成 ] ボタンを選択します。

  2. VS Code で、[ リソース ] ビューを更新します。 デプロイされたエージェントは、[ クラシック エージェント ] サブセクションに表示されます。

デプロイされたエージェントの詳細を表示する

デプロイされたエージェントを選択して、表示専用モードで [エージェントの基本設定] ウィンドウを開きます。 このウィンドウから、次の作業を実行できます。

  • [ エージェントの編集] を選択して、エージェント デザイナーと .yaml 定義を開いて編集します。
  • [ コードの表示] を選択して、エージェントを使用するサンプル コード ファイルを生成します。
  • [ プレイグラウンドを開く ] を選択して、リモート エージェントのプレイグラウンドを開きます。

デプロイされたエージェントを更新する

デプロイされたエージェントの構成を変更し、その変更を Foundry に同期できます。

  1. [ エージェントの基本設定 ] ウィンドウで、[ エージェントの編集] を選択します。 エージェント デザイナーが開き、エージェントの .yaml ファイルが表示されます。

  2. モデル、ツール、手順など、エージェントの構成を編集します。

  3. Microsoft Foundry の [エージェントの更新] ボタンを選択して、変更を保存します。 更新された構成はすぐに有効になります。

サンプル コード ファイルを生成する

この拡張機能は、デプロイされたエージェントとプログラムで対話するための定型コードを生成します。

  1. デプロイしたエージェントを右クリックし、[ コードの表示] を選択します。 または、[ エージェントの基本設定 ] ウィンドウで、[コードの 表示 ] ボタンを選択します。

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

  3. [ 言語の選択 ] ドロップダウン リストで、言語を選択します。

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

拡張機能は、選択した言語でコード ファイルを生成し、エディターで開きます。

サンプル コード ファイルを確認する

生成されたコード ファイルは、Foundry Projects API を介してエージェントと対話するための基本的な呼び出しを示しています。 次のスクリーンショットは、Python の例を示しています。

インポート、クライアント初期化、エージェントの対話呼び出しを含む生成された Python コード ファイルを示すスクリーンショット。

プレイグラウンドでエージェントをテストする

プレイグラウンドを使用して、デプロイされたエージェントにメッセージを送信し、その動作を確認します。

  1. デプロイしたエージェントを右クリックし、[ プレイグラウンドを開く] を選択します。

    または、[ツール] サブセクションで [リモート エージェント プレイグラウンド] リンクを選択し、エージェントの種類を選択し、ドロップダウン リストからエージェントを選択します。

    [リモート エージェントプレイグラウンド] ウィンドウが開き、エージェントとのスレッドが開始されます。

  2. プロンプトを入力し、出力を表示します。

    この例では 、Bing Grounding を 使用して、Web 検索の情報を示します。 エージェントは、エージェント デザイナーで構成したモデルとツールを使用します。 情報のソースは、エージェント注釈のセクションに表示されます。

    エージェントの [プレイグラウンド] ウィンドウに Bing Grounding 応答が表示され、エージェントの注釈がソースを強調表示しているスクリーンショット。

エージェント スレッドの表示

[スレッド] サブセクションには、エージェントとの実行中に作成された会話スレッドが表示されます。 [リソース] ビューの [クラシック] セクションで、[スレッド] サブセクションを展開して一覧を表示します。

会話スレッドの一覧を含むクラシック セクション ビューの [スレッド] サブセクションを示すスクリーンショット。

注

スレッドは、エージェントとユーザーの間の会話セッションです。 スレッドはメッセージを格納し、コンテンツをモデルのコンテキストに合わせて切り捨てを自動的に処理します。 メッセージは、テキスト、画像、およびその他のファイルを含めることができる 1 つの操作です。 実行は、複数のスレッドとメッセージにまたがるエージェントの 1 回の実行です。

スレッドの詳細を表示する

[スレッドの詳細] ウィンドウを表示するには、一覧からスレッドを選択します。

実行の詳細を表示する

実行情報を表示するには、[スレッドの詳細] ウィンドウの [実行情報の表示] ボタンを選択します。 .json ファイルが開き、エージェントの構成、メッセージ、ツール呼び出しなど、実行の詳細が表示されます。

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

作成したリソースが不要な場合は、Azure サブスクリプションへの継続的な課金を回避するために、リソースを削除します。

エージェントを削除する

ヒント

Microsoft Foundry ポータルで 左側のウィンドウをカスタマイズ できるため、次の手順とは異なる項目が表示される場合があります。 探しているものが表示されない場合は、左側のペインの下部にある… もっと見るを選択してください。

  1. VS Code で、[Azure リソース] ビューを更新します。
  2. [ エージェント ] サブセクションを展開して、デプロイされたエージェントの一覧を表示します。
  3. 削除するエージェントを右クリックし、[削除] を選択 します。

モデルを削除する

  1. VS Code で、[ リソース ] ビューを更新します。 [ モデル ] サブセクションを展開して、デプロイされたモデルの一覧を表示します。

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

接続されているツールを削除する

  1. Azure Portalを開きます。

  2. ツール リソースを含むリソース グループに移動します。

  3. リソースを選択し、[削除] を選択 します。

関連するコンテンツ

  • Last updated on