AgentCore Browser の使用を開始する
AgentCore Browser を使用すると、エージェントはマネージド Chrome ブラウザを介してウェブページを操作できます。このガイドでは、5 分以内にウェブサイトをナビゲートし、情報を抽出する AI エージェントを作成します。
トピック
前提条件
開始する前に、以下を確認してください。
-
Python 3.10 以降 (python.org/downloads
) -
Boto3 のインストール ( Boto3 ドキュメント
) -
AWS 認証情報の設定 — 以下を使用して検証します。
aws sts get-caller-identityこのコマンドが失敗した場合は、CLI AWS ドキュメントの「設定と認証情報ファイルの設定」を参照してください。
-
Amazon Bedrock コンソールで Anthropic Claude Sonnet 4.0 モデルアクセスが有効になっている
-
AWS Amazon Bedrock AgentCore が利用可能なリージョン (「サポートされている AWS リージョン」を参照)
IAM アクセス許可
このポリシーを IAM ID にアタッチします。IAM コンソールで、ユーザーまたはロールを検索し、アクセス許可の追加 > インラインポリシーの作成 を選択し、JSON ビューに切り替えて貼り付けます。
{ "Version":"2012-10-17", "Statement": [ { "Sid": "BedrockAgentCoreBrowserFullAccess", "Effect": "Allow", "Action": [ "bedrock-agentcore:CreateBrowser", "bedrock-agentcore:ListBrowsers", "bedrock-agentcore:GetBrowser", "bedrock-agentcore:DeleteBrowser", "bedrock-agentcore:StartBrowserSession", "bedrock-agentcore:ListBrowserSessions", "bedrock-agentcore:GetBrowserSession", "bedrock-agentcore:StopBrowserSession", "bedrock-agentcore:UpdateBrowserStream", "bedrock-agentcore:ConnectBrowserAutomationStream", "bedrock-agentcore:ConnectBrowserLiveViewStream" ], "Resource": "arn:aws:bedrock-agentcore:<Region>:++<account_id>++:browser/*" }, { "Sid": "BedrockModelAccess", "Effect": "Allow", "Action": [ "bedrock:InvokeModel", "bedrock:InvokeModelWithResponseStream" ], "Resource": [ "*" ] } ] }
注記
を実際の AWS リージョン<Region>に、 を AWS アカウント ID <account_id> に置き換えます。
ステップ 1: 依存関係をインストールする
pip install bedrock-agentcore strands-agents strands-agents-tools playwright nest-asyncio
ステップ 2: エージェントを作成する
という名前browser_agent.pyのファイルを作成します。
注記
を自分の AWS リージョン ( など) us-west-2 <Region>に置き換えます。
from strands import Agent from strands_tools.browser import AgentCoreBrowser # Initialize the Browser tool browser_tool = AgentCoreBrowser(region="<Region>") # Create an agent with the Browser tool agent = Agent(tools=[browser_tool.browser]) # Test the agent with a web search prompt prompt = "what are the services offered by Bedrock AgentCore? Use the documentation link if needed: https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/what-is-bedrock-agentcore.html" print(f"\n\nPrompt: {prompt}\n\n") response = agent(prompt) print("\n\nAgent Response:") print(response.message["content"][0]["text"])
ステップ 3: エージェントを実行する
python browser_agent.py
エージェントはウェブサイトをナビゲートし、AgentCore サービスの詳細を返します。エラーが発生した場合は、IAM アクセス許可、モデルアクセス、 AWS 認証情報を確認します。
ステップ 4: ブラウザセッションをライブで表示する
エージェントの実行中は、 AWS コンソールからリアルタイムで監視できます。
-
左側のナビゲーションで組み込みツールに移動します。
-
ブラウザツール ( やカスタムブラウザなど)
AgentCore Browser Toolを選択する -
ブラウザセッションセクションで、ステータスが準備完了のアクティブなセッションを検索します。
-
ライブビュー/録画列で、指定された「ライブセッションを表示」 URL をクリックします。
ライブビューは、オートメーションからコントロールを引き継いだり解放したりするためのインタラクティブなコントロールを備えたリアルタイムのビデオストリームを提供します。
リソースの検索
AgentCore Browser を使用したら、 AWS コンソールでリソースを表示します。
| # | [リソース] | ロケーション |
|---|---|---|
|
1 |
ライブビュー |
ブラウザコンソール > ツール名 > ライブセッションの表示 |
|
2 |
セッションの録画と再生 |
ブラウザコンソール > ツール名 > 録画の表示 |
|
3 |
ブラウザログ |
CloudWatch > ロググループ > |
|
4 |
ファイルの記録 |
S3 > バケット > |
|
5 |
カスタムブラウザ |
AgentCore コンソール > 組み込みツール > カスタムブラウザ |
|
6 |
IAM ロール |
IAM > ロール > 実行ロールを検索する |
次の手順
AgentCore Browser が動作したので、次の高度な機能について説明します。
-
セッションの記録と再生 - デバッグ用のセッションの記録と再生
-
Nova Act での AgentCore ブラウザの使用と Playwright での AgentCore ブラウザの使用 - Nova Act や Playwright などの他のフレームワークの使用
-
基礎 - API オペレーションとカスタムブラウザについて説明します。