Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

基础知识

以下主题展示了 Amazon Bedrock AgentCore 浏览器的工作原理以及如何创建资源和管理会话。

创建浏览器工具并启动会话

Permissions

要使用亚马逊 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 浏览器提供两种类型的资源：

网络设置

AgentCore 浏览器支持公共网络模式。此模式允许该工具访问公共互联网资源。此选项允许与外部 API 和服务集成。

会话管理

AgentCore 浏览器会话具有以下特征：

使用隔离会话

AgentCore 工具可以隔离每个用户会话，以确保在多个工具调用中安全一致地重用上下文。由于其动态和多步执行模式，会话隔离对于 AI 代理工作负载尤其重要。

每个工具会话都在具有独立的 CPU、内存和文件系统资源的专用 microVM 中运行。这种架构保证一个用户的工具调用无法访问另一个用户会话中的数据。会话完成后，microVM 将完全终止并对其内存进行消毒，从而消除了跨会话数据泄露的任何风险。