AWS Bedrock AgentCore
Execute o agent-browser em sessões de navegador em nuvem hospedadas pelo AWS Bedrock AgentCore. Todos os comandos padrão do agent-browser funcionam de forma idêntica; a única diferença é onde o navegador é executado.
Configuração
As credenciais são resolvidas automaticamente:
- Variáveis de ambiente (
AWS_ACCESS_KEY_ID,AWS_SECRET_ACCESS_KEY, opcionalmenteAWS_SESSION_TOKEN) - Fallback para AWS CLI (
aws configure export-credentials), que suporta SSO, funções IAM e perfis nomeados
Nenhuma configuração adicional é necessária se o usuário já tiver credenciais AWS funcionais.
Fluxo de Trabalho Principal
# Abrir uma página em um navegador em nuvem AgentCore
agent-browser -p agentcore open https://exemplo.com
# Todo o resto é igual ao Chrome local
agent-browser snapshot -i
agent-browser click @e1
agent-browser screenshot pagina.png
agent-browser close
Variáveis de Ambiente
| Variável | Descrição | Padrão |
|---|---|---|
AGENTCORE_REGION | Região AWS | us-east-1 |
AGENTCORE_BROWSER_ID | Identificador do navegador | aws.browser.v1 |
AGENTCORE_PROFILE_ID | Perfil de navegador persistente (cookies, localStorage) | (nenhum) |
AGENTCORE_SESSION_TIMEOUT | Tempo limite da sessão em segundos | 3600 |
AWS_PROFILE | Perfil AWS CLI para resolução de credenciais | default |
Perfis Persistentes
Use AGENTCORE_PROFILE_ID para persistir o estado do navegador entre sessões. Isso é útil para manter sessões de login:
# Primeira execução: faça login
AGENTCORE_PROFILE_ID=meu-app agent-browser -p agentcore open https://app.exemplo.com/login
agent-browser snapshot -i
agent-browser fill @e1 "[email protected]"
agent-browser fill @e2 "senha"
agent-browser click @e3
agent-browser close
# Execuções futuras: já autenticado
AGENTCORE_PROFILE_ID=meu-app agent-browser -p agentcore open https://app.exemplo.com/dashboard
Visualização ao Vivo
Quando uma sessão inicia, o AgentCore imprime uma URL de Visualização ao Vivo no stderr. Abra-a em um navegador para assistir à sessão em tempo real pelo Console AWS:
Sessão: abc123-def456
Visualização ao Vivo: https://us-east-1.console.aws.amazon.com/bedrock-agentcore/browser/aws.browser.v1/session/abc123-def456#
Seleção de Região
# Padrão: us-east-1
agent-browser -p agentcore open https://exemplo.com
# Região explícita
AGENTCORE_REGION=eu-west-1 agent-browser -p agentcore open https://exemplo.com
Padrões de Credenciais
# Credenciais explícitas (CI/CD, scripts)
export AWS_ACCESS_KEY_ID=AKIA...
export AWS_SECRET_ACCESS_KEY=...
agent-browser -p agentcore open https://exemplo.com
# SSO (interativo)
aws sso login --profile meu-perfil
AWS_PROFILE=meu-perfil agent-browser -p agentcore open https://exemplo.com
# Função IAM / cadeia de credenciais padrão
agent-browser -p agentcore open https://exemplo.com
Usando com AGENT_BROWSER_PROVIDER
Defina o provedor via variável de ambiente para evitar passar -p agentcore em cada comando:
export AGENT_BROWSER_PROVIDER=agentcore
export AGENTCORE_REGION=us-east-2
agent-browser open https://exemplo.com
agent-browser snapshot -i
agent-browser click @e1
agent-browser close
Problemas Comuns
"Falha ao executar AWS CLI" significa que a AWS CLI não está instalada ou não está no PATH. Instale-a ou defina AWS_ACCESS_KEY_ID e AWS_SECRET_ACCESS_KEY diretamente.
"AWS CLI falhou: ... Execute 'aws sso login'" significa que as credenciais SSO expiraram. Execute aws sso login para renová-las.
Tempo limite da sessão: O padrão é 3600 segundos (1 hora). Para tarefas mais longas, aumente com AGENTCORE_SESSION_TIMEOUT=7200.