View a markdown version of this page

AgentCore Browser の使用を開始する - Amazon Bedrock AgentCore

AgentCore Browser の使用を開始する

AgentCore Browser を使用すると、エージェントはマネージド Chrome ブラウザを介してウェブページを操作できます。このガイドでは、5 分以内にウェブサイトをナビゲートし、情報を抽出する AI エージェントを作成します。

前提条件

開始する前に、以下を確認してください。

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 コンソールからリアルタイムで監視できます。

  1. AgentCore ブラウザコンソールを開く

  2. 左側のナビゲーションで組み込みツールに移動します。

  3. ブラウザツール ( やカスタムブラウザなど) AgentCore Browser Tool を選択する

  4. ブラウザセッションセクションで、ステータスが準備完了のアクティブなセッションを検索します。

  5. ライブビュー/録画列で、指定された「ライブセッションを表示」 URL をクリックします。

ライブビューは、オートメーションからコントロールを引き継いだり解放したりするためのインタラクティブなコントロールを備えたリアルタイムのビデオストリームを提供します。

リソースの検索

AgentCore Browser を使用したら、 AWS コンソールでリソースを表示します。

# [リソース] ロケーション

1

ライブビュー

ブラウザコンソール > ツール名 > ライブセッションの表示

2

セッションの録画と再生

ブラウザコンソール > ツール名 > 録画の表示

3

ブラウザログ

CloudWatch > ロググループ > /aws/bedrock-agentcore/browser/

4

ファイルの記録

S3 > バケット > browser-recordings/ プレフィックス

5

カスタムブラウザ

AgentCore コンソール > 組み込みツール > カスタムブラウザ

6

IAM ロール

IAM > ロール > 実行ロールを検索する

次の手順

AgentCore Browser が動作したので、次の高度な機能について説明します。