ホスト型エージェントでのブラウザー自動化ツール (プレビュー) の使用を開始する

Important

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

前提条件

  • アクティブなサブスクリプションを持つ Azure アカウント。 Azure サブスクリプションをお持ちでない場合は、開始する前に 無料アカウント を作成してください。
  • Azure アカウントには、リソース グループの所有者ロールまたは共同作成者ロールが必要です。
  • Azure Developer CLI Azure開発者 CLI がない場合は、「Azure Developer CLI のインストール」を参照してください。
    • インストール済みの azd ai agent extension (azd extension install azure.ai.agents)。 拡張機能がインストールされていない場合は、スターターテンプレートを初期化するか、azd ai agent を実行すると、拡張機能が自動的にインストールされます。

手順 1: プレイライト ワークスペースを作成する

ブラウザー自動化ツールを使用するには、まず Playwright ワークスペースを作成する必要があります。 (既存の Playwright ワークスペースがある場合は、この手順をスキップできます)。

  1. ご利用の Azure サブスクリプションの資格情報を使って、Azure portal にサインインします。
  2. ポータルのホーム ページで、劇作家のワークスペースを検索して選択します。
  3. [作成] を選択し、次の情報を入力します。
    • Subscription
    • リソース グループ
    • 名前
    • 場所
  4. [確認と作成] を選択し、[作成] を選択します。 ワークスペースの作成には数分かかります。 ポータル ページが表示されるまで待ってから、デプロイが完了してから次に進みます。

手順 2: ホストされるサンプル エージェントをデプロイする

ホストされているエージェントでブラウザー自動化ツールの使用を開始するには、次のいずれかのサンプルを選択します。

ホストされるエージェントの構築に使用するフレームワークに応じて、これらのいずれかの方法を使用できます。

手順 2.1: ホストされるサンプル エージェント アプリケーションを初期化する

  1. 次のいずれかのコマンドを実行して、新しいディレクトリを開き、サンプルの azure.yaml からエージェント サンプルを初期化します。

    • Microsoft エージェント フレームワーク:
    azd ai agent init -m "https://github.com/microsoft-foundry/foundry-samples/blob/main/samples/python/hosted-agents/agent-framework/responses/14-browser-automation-agent/azure.yaml" --deploy-mode container
    • 独自のフレームワークの持ち込み:
    azd ai agent init -m "https://github.com/microsoft-foundry/foundry-samples/blob/main/samples/python/hosted-agents/bring-your-own/responses/browser-automation/azure.yaml" --deploy-mode container

  2. 対話型フローでは、次の詳細が求められます。

    • アプリ ディレクトリ: アプリケーションを初期化するためのローカル パス。
    • エージェント名: 名前をカスタマイズするか、既定の browser-automation-agent-sample-foundryをそのまま使用します。 名前は 1 ~ 63 文字以内で、先頭と末尾に文字または数字を使用し、文字、数字、および内部ハイフンのみを含める必要があります。
    • Foundry プロジェクト: 既存の Foundry プロジェクトを選択するか、新しいプロジェクトを作成します。 既存の Foundry プロジェクトを使用する場合は、プロジェクト スコープで Foundry Project Manager ロールを持っているか、データ プレーンとロール割り当ての両方のアクセス許可を持つ別のロールが必要です。 完全なロール マトリックスについては、 ホストされるエージェントのアクセス許可のリファレンスを参照してください。
    • モデル: 既定、 gpt-5.4-mini、またはアクセスできる別のモデルを選択します。
    • モデルのバージョン: 既定のオプションを選択します。
    • モデル SKU: Batch (通常は Standard または GlobalStandard) ではない使用可能なクォータを持つオプションを選択します。
    • デプロイ容量: 既定の 10 を選択します。
    • デプロイ名: 既定の gpt-5.4-miniを選択します。

アプリケーションが正常に初期化されると、次のメッセージが表示されます。

AI agent definition added to your azd project successfully!

手順 2.2: Azure リソースをプロビジョニングする

  1. Playwright ワークスペースを指す環境変数を設定する

    • Playwright ワークスペース リソース ID: リソース ID を取得するには、Playwright ワークスペース リソースを開き、[概要] ページに移動し、[JSON ビュー] を選択して、リソース ID をコピーします。
    azd env set PLAYWRIGHT_SERVICE_RESOURCE_ID "/subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.LoadTestService/playwrightWorkspaces/<workspace-name>"
    • Playwright ワークスペース サービス URL: サービス URL を取得するには、Playwright ワークスペース リソースを開き、[概要] ページに移動します。 ブラウザー エンドポイントをコピーします ( wss://で始まります)。
    azd env set PLAYWRIGHT_SERVICE_URL "wss://<region>.api.playwright.microsoft.com/playwrightworkspaces/<workspace-id>/browsers"

  2. azure.yamlで定義されているリソースをプロビジョニングします。

azd provision

この手順には数分かかり、次のリソースが作成されます。 プロビジョニング後、次のメッセージが表示されます。

SUCCESS: Your application was provisioned in Azure in X minute YY seconds.

手順 2.3: Foundry Agent Service にエージェントをデプロイする

エージェント コンテナーをビルドしてデプロイします。

azd deploy

エージェントがデプロイされると、次のメッセージが表示されます。

SUCCESS: Your application was deployed to Azure in X minutes YY seconds.

手順 3: エージェントに Playwright ワークスペースへのアクセスを許可する

Foundry プロジェクトのマネージド ID は、Azure Playwright ワークスペースで次のロールを持っている必要があります。

役割 Purpose
Playwright ワークスペース共同作成者 ブラウザー セッションを作成および管理するためのアクセス権を付与します
  1. Foundry ポータルでエージェントの ID オブジェクト ID を見つけます。 [エージェント] に移動し、エージェントを選択し、[ID] を選択します。
  2. Azure CLIを使用してロールを割り当てます。
PRINCIPAL_ID="<project-managed-identity-object-id>"
PWW_RESOURCE_ID="/subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.LoadTestService/playwrightWorkspaces/<workspace-name>"

az role assignment create --assignee "$PRINCIPAL_ID" --role "Playwright Workspace Contributor" --scope "$PWW_RESOURCE_ID"

手順 4: Foundry Playground でエージェントをテストする

  1. Foundry ポータルを開き、サインインします。
  2. [最近使ったプロジェクト] または [すべてのプロジェクト] からプロジェクトを選択します。
  3. 左側のナビゲーションで、[Build > Agents]\(エージェントのビルド\) を選択します。
  4. エージェントを選択し、[プレイグラウンドで開く] を選択します。
  5. 次のようなプロンプトを入力します。
Go to the website finance.yahoo.com, search for MSFT and report the Microsoft stock price.

手順 4: リソースをクリーンアップする

完了したらリソースを削除して、料金の発生を停止します。

azd down

azd は削除するリソースを一覧表示し、確認を求めます。 クリーンアップには約 2 ~ 5 分かかります。

  • Last updated on