Conceitos básicos

Os tópicos a seguir mostram como o Amazon Bedrock AgentCore Browser funciona e como você pode criar os recursos e gerenciar sessões.

Criando uma ferramenta de navegador e iniciando uma sessão

Permissões

Para usar o AgentCore navegador Amazon Bedrock, você precisa das seguintes permissões em sua política do 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/*"
        }
    ]
}

Se você estiver usando a gravação de sessão com o S3, a função de execução fornecida ao criar um navegador precisará das seguintes permissões:

{
    "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}}"
        }
    }
}

Você também deve adicionar a seguinte política de confiança à função de execução:

{
"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:*"
            }
        }
    }]
}

Configuração do navegador para operações de API

Execute os comandos a seguir para configurar sua ferramenta de navegador, que é comum a todas as operações de API do plano de controle e do plano de dados.

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
)

Gerenciamento de recursos

O AgentCore navegador fornece dois tipos de recursos:

Configurações de rede

O AgentCore navegador suporta o modo de rede pública. Esse modo permite que a ferramenta acesse recursos públicos da Internet. Essa opção permite a integração com APIs e serviços externos.

Gerenciamento de sessões

As sessões AgentCore do navegador têm as seguintes características:

Usando sessões isoladas

AgentCore As ferramentas permitem o isolamento de cada sessão do usuário para garantir a reutilização segura e consistente do contexto em várias invocações de ferramentas. O isolamento da sessão é especialmente importante para cargas de trabalho de agentes de IA devido aos seus padrões de execução dinâmicos e em várias etapas.

Cada sessão da ferramenta é executada em uma microVM dedicada com recursos isolados de CPU, memória e sistema de arquivos. Essa arquitetura garante que a invocação da ferramenta de um usuário não possa acessar dados da sessão de outro usuário. Após a conclusão da sessão, a microVM é totalmente encerrada e sua memória é higienizada, eliminando assim qualquer risco de vazamento de dados entre sessões.