기본 사항

다음 주제에서는 Amazon Bedrock AgentCore 브라우저의 작동 방식과 리소스를 생성하고 세션을 관리하는 방법을 보여줍니다.

브라우저 도구 생성 및 세션 시작

권한

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 브라우저는 두 가지 유형의 리소스를 제공합니다.

네트워크 설정

AgentCore 브라우저는 퍼블릭 네트워크 모드를 지원합니다. 이 모드를 사용하면 도구가 퍼블릭 인터넷 리소스에 액세스할 수 있습니다. 이 옵션을 사용하면 외부 APIs.

세션 관리

AgentCore 브라우저 세션의 특성은 다음과 같습니다.

격리된 세션 사용

AgentCore 도구를 사용하면 각 사용자 세션을 격리하여 여러 도구 호출에서 컨텍스트를 안전하고 일관되게 재사용할 수 있습니다. 세션 격리는 동적 및 다단계 실행 패턴으로 인해 AI 에이전트 워크로드에 특히 중요합니다.

각 도구 세션은 격리된 CPU, 메모리 및 파일 시스템 리소스가 있는 전용 microVM에서 실행됩니다. 이 아키텍처는 한 사용자의 도구 호출이 다른 사용자의 세션에서 데이터에 액세스할 수 없도록 보장합니다. 세션이 완료되면 microVM이 완전히 종료되고 메모리가 삭제되므로 세션 간 데이터 유출 위험이 없습니다.