기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

기본 사항

다음 주제에서는 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이 완전히 종료되고 메모리가 삭제되므로 세션 간 데이터 유출 위험이 없습니다.