View a markdown version of this page

Comece a usar o AgentCore Browser - Base da Amazônia AgentCore

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Comece a usar o AgentCore Browser

AgentCore O navegador permite que seus agentes interajam com páginas da web por meio de um navegador Chrome gerenciado. Neste guia, você criará um agente de IA que navega em um site e extrai informações em menos de 5 minutos.

Pré-requisitos

Antes de começar, verifique se você tem:

  • Python 3.10 ou mais recente (python. org/downloads)

  • Boto3 instalado (documentação do Boto3)

  • AWS credenciais configuradas — verifique com:

    aws sts get-caller-identity

    Se esse comando falhar, consulte Configurações e configurações do arquivo de credenciais na documentação da AWS CLI.

  • Acesso ao modelo Anthropic Claude Sonnet 4.0 ativado no console Amazon Bedrock

  • AWS Região onde o Amazon Bedrock AgentCore está disponível (consulte AWS as regiões Compatível AWS Regiões suportadas)

Permissões do IAM

Anexe essa política à sua identidade do IAM. No console do IAM, encontre seu usuário ou função, escolha Adicionar permissões > Criar política embutida, alterne para a visualização JSON e cole:

{ "Version":"2012-10-17", "Statement": [ { "Sid": "BedrockAgentCoreBrowserFullAccess", "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:<Region>:++<account_id>++:browser/*" }, { "Sid": "BedrockModelAccess", "Effect": "Allow", "Action": [ "bedrock:InvokeModel", "bedrock:InvokeModelWithResponseStream" ], "Resource": [ "*" ] } ] }
nota

<Region>Substitua pela sua AWS região real e <account_id> pelo ID AWS da sua conta.

Etapa 1: instalar dependências

pip install bedrock-agentcore strands-agents strands-agents-tools playwright nest-asyncio

Etapa 2: crie seu agente

Crie um arquivo chamadobrowser_agent.py:

nota

<Region>Substitua pela sua AWS região (por exemplo,us-west-2).

from strands import Agent from strands_tools.browser import AgentCoreBrowser # Initialize the Browser tool browser_tool = AgentCoreBrowser(region="<Region>") # Create an agent with the Browser tool agent = Agent(tools=[browser_tool.browser]) # Test the agent with a web search prompt prompt = "what are the services offered by Bedrock AgentCore? Use the documentation link if needed: https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/what-is-bedrock-agentcore.html" print(f"\n\nPrompt: {prompt}\n\n") response = agent(prompt) print("\n\nAgent Response:") print(response.message["content"][0]["text"])

Etapa 3: executar o agente

python browser_agent.py

Você deve ver o agente navegar pelo site e retornar detalhes sobre os AgentCore serviços. Se você encontrar erros, verifique suas permissões do IAM, acesso ao modelo e AWS credenciais.

Etapa 4: veja a sessão do navegador ao vivo

Enquanto seu agente está em execução, você pode assisti-lo em tempo real pelo AWS console:

  1. Abra o console AgentCore do navegador

  2. Navegue até Built-in as ferramentas na navegação à esquerda

  3. Selecione a ferramenta Navegador (por exemploAgentCore Browser Tool, ou seu navegador personalizado)

  4. Na seção Sessões do navegador, encontre sua sessão ativa com o status Pronto

  5. Na coluna Visualização ao vivo/gravação, clique no URL “Exibir sessão ao vivo” fornecido

A exibição ao vivo fornece um fluxo de vídeo em tempo real com controles interativos para assumir ou liberar o controle da automação.

Encontrar seus recursos

Depois de usar o AgentCore Navegador, visualize seus recursos no AWS console:

# Recurso Local

1

Visualização ao vivo

Console do navegador > Nome da ferramenta > Exibir sessão ao vivo

2

Gravações e repetições de sessões

Console do navegador > Nome da ferramenta > Exibir gravação

3

Registros do navegador

CloudWatch> Grupos de registros > /aws/bedrock-agentcore/browser/

4

Arquivos de gravação

S3 > Seu bucket > prefixo browser-recordings/

5

Navegadores personalizados

AgentCore Console > Built-in ferramentas > Seu navegador personalizado

6

Perfis do IAM

IAM > Funções > Pesquise sua função de execução

Próximas etapas

Agora que o AgentCore navegador está funcionando, explore esses recursos avançados: