基礎

以下のトピックでは、Amazon Bedrock AgentCore Browser の仕組みと、リソースの作成とセッションの管理方法について説明します。

ブラウザツールの作成とセッションの開始

アクセス許可

Amazon Bedrock AgentCore ブラウザを使用するには、IAM ポリシーで次のアクセス許可が必要です。

{
"Version":"2012-10-17",
    "Statement": [
        {
            "Sid": "BedrockAgentCoreInBuiltToolsFullAccess",
            "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:us-east-1:111122223333:browser/*"
        }
    ]
}

S3 でセッション録画を使用している場合、ブラウザの作成時に指定する実行ロールには、次のアクセス許可が必要です。

{
    "Sid": "BedrockAgentCoreBuiltInToolsS3Policy",
    "Effect": "Allow",
    "Action": [
        "s3:PutObject",
        "s3:ListMultipartUploadParts",
        "s3:AbortMultipartUpload"
    ],
    "Resource": "arn:aws:s3:::example-s3-bucket/example-prefix/*",
    "Condition": {
        "StringEquals": {
            "aws:ResourceAccount": "{{accountId}}"
        }
    }
}

また、次の信頼ポリシーを実行ロールに追加する必要があります。

{
"Version":"2012-10-17",
    "Statement": [{
        "Sid": "BedrockAgentCoreBuiltInTools",
        "Effect": "Allow",
        "Principal": {
            "Service": "bedrock-agentcore.amazonaws.com"
        },
        "Action": "sts:AssumeRole",
        "Condition": {
            "StringEquals": {
                "aws:SourceAccount": "111122223333"
            },
            "ArnLike": {
                "aws:SourceArn": "arn:aws:bedrock-agentcore:us-east-1:111122223333:*"
            }
        }
    }]
}

API オペレーションのブラウザ設定

以下のコマンドを実行して、すべてのコントロールプレーンおよびデータプレーン API オペレーションに共通のブラウザツールを設定します。

import boto3
import uuid

REGION = "<Region>"
CP_ENDPOINT_URL = f"https://bedrock-agentcore-control.{REGION}.amazonaws.com"
DP_ENDPOINT_URL = f"https://bedrock-agentcore.{REGION}.amazonaws.com"

cp_client = boto3.client(
    'bedrock-agentcore-control',
    region_name=REGION,
    endpoint_url=CP_ENDPOINT_URL
)

dp_client = boto3.client(
    'bedrock-agentcore',
    region_name=REGION,
    endpoint_url=DP_ENDPOINT_URL
)

リソース管理

AgentCore Browser には 2 種類のリソースがあります。

ネットワーク設定

AgentCore Browser は、パブリックネットワークモードをサポートしています。このモードでは、ツールはパブリックインターネットリソースにアクセスできます。このオプションを使用すると、外部 APIsおよびサービスとの統合が可能になります。

セッション管理

AgentCore Browser セッションには次の特性があります。

分離されたセッションの使用

AgentCore Tools を使用すると、各ユーザーセッションを分離して、複数のツール呼び出しでコンテキストを安全かつ一貫して再利用できます。セッション分離は、動的および複数ステップの実行パターンのため、AI エージェントワークロードにとって特に重要です。

各ツールセッションは、CPU、メモリ、ファイルシステムリソースが分離された専用のmicroVM で実行されます。このアーキテクチャは、あるユーザーのツール呼び出しが別のユーザーのセッションのデータにアクセスできないことを保証します。セッションが完了すると、microVM が完全に終了し、メモリがサニタイズされるため、セッション間のデータ漏洩のリスクがなくなります。