View a markdown version of this page

Comece a usar o AgentCore Browser - Amazon Bedrock AgentCore

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:

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 em linha, 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, acesso ao modelo e AWS credenciais do IAM.

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

Enquanto seu agente está funcionando, você pode assisti-lo em tempo real por meio do 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 uma transmissão 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 replay da sessão

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 você tem o AgentCore navegador funcionando, explore esses recursos avançados: