# 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.
**Topics**
+ [Pré-requisitos](#browser-prerequisites)
+ [Etapa 1: instalar dependências](#browser-strands-install)
+ [Etapa 2: Crie seu agente](#browser-strands-create)
+ [Etapa 3: Executar o agente](#browser-strands-run)
+ [Etapa 4: ver a sessão do navegador ao vivo](#browser-strands-live-view)
+ [Encontrar seus recursos](#browser-find-resources)
+ [Próximas etapas](#browser-next-steps)
+ [Usando o AgentCore navegador com o Nova Act](browser-quickstart-nova-act.md)
+ [Usando o AgentCore navegador com o Playwright](browser-quickstart-playwright.md)
## Pré-requisitos
Antes de começar, verifique se você tem:
+ [Python 3.10 ou mais recente (python. org/downloads](https://www.python.org/downloads/))
+ Boto3 instalado (documentação do [Boto3](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html))
+ AWS credenciais configuradas — verifique com:
```
aws sts get-caller-identity
```
Se esse comando falhar, consulte [Configurações e configurações do arquivo de credenciais](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html) na documentação da AWS CLI.
+ Acesso antrópico ao modelo Claude Sonnet 4.0 [ativado](https://docs.aws.amazon.com/bedrock/latest/userguide/model-access-modify.html) no console Amazon Bedrock
+ AWS Região em que o Amazon Bedrock AgentCore está disponível (consulte [AWS Regiões suportadas](agentcore-regions.md))
**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::++++:browser/*"
},
{
"Sid": "BedrockModelAccess",
"Effect": "Allow",
"Action": [
"bedrock:InvokeModel",
"bedrock:InvokeModelWithResponseStream"
],
"Resource": [
"*"
]
}
]
}
```
**nota**
``Substitua pela sua AWS região real e `` 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 chamado`browser_agent.py`:
**nota**
``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="")
# 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](https://us-west-2.console.aws.amazon.com/bedrock-agentcore/builtInTools)
1. Navegue até **Built-in as ferramentas** na navegação à esquerda
1. Selecione a ferramenta Navegador (por exemplo`AgentCore Browser Tool`, ou seu navegador personalizado)
1. Na seção **Sessões do navegador**, encontre sua sessão ativa com o status **Pronto**
1. 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:
+ [Gravação e repetição de sessões](browser-session-recording.md) - Grave e reproduza sessões para depuração
+ [Usando o AgentCore navegador com o Nova Act](browser-quickstart-nova-act.md) e [usando o AgentCore navegador com o Playwright](browser-quickstart-playwright.md) - Use outras estruturas como o Nova Act ou o Playwright
+ [Fundamentos](browser-resource-session-management.md) - Saiba mais sobre operações de API e navegadores personalizados