AWS Bedrock AgentCore
Ejecuta agent-browser en sesiones de navegador en la nube alojadas por AWS Bedrock AgentCore. Todos los comandos estándar de agent-browser funcionan de manera idéntica; la única diferencia es dónde se ejecuta el navegador.
Configuración
Las credenciales se resuelven automáticamente:
- Variables de entorno (
AWS_ACCESS_KEY_ID,AWS_SECRET_ACCESS_KEY, opcionalmenteAWS_SESSION_TOKEN) - Respaldo de la CLI de AWS (
aws configure export-credentials), que admite SSO, roles IAM y perfiles con nombre
No se necesita configuración adicional si el usuario ya tiene credenciales de AWS funcionales.
Flujo de trabajo principal
# Abrir una página en un navegador en la nube de AgentCore
agent-browser -p agentcore open https://example.com
# Todo lo demás es igual que con Chrome local
agent-browser snapshot -i
agent-browser click @e1
agent-browser screenshot page.png
agent-browser close
Variables de entorno
| Variable | Descripción | Valor predeterminado |
|---|---|---|
AGENTCORE_REGION | Región de AWS | us-east-1 |
AGENTCORE_BROWSER_ID | Identificador del navegador | aws.browser.v1 |
AGENTCORE_PROFILE_ID | Perfil de navegador persistente (cookies, localStorage) | (ninguno) |
AGENTCORE_SESSION_TIMEOUT | Tiempo de espera de la sesión en segundos | 3600 |
AWS_PROFILE | Perfil de la CLI de AWS para la resolución de credenciales | default |
Perfiles persistentes
Usa AGENTCORE_PROFILE_ID para persistir el estado del navegador entre sesiones. Esto es útil para mantener sesiones de inicio de sesión:
# Primera ejecución: iniciar sesión
AGENTCORE_PROFILE_ID=my-app agent-browser -p agentcore open https://app.example.com/login
agent-browser snapshot -i
agent-browser fill @e1 "[email protected]"
agent-browser fill @e2 "password"
agent-browser click @e3
agent-browser close
# Ejecuciones futuras: ya autenticado
AGENTCORE_PROFILE_ID=my-app agent-browser -p agentcore open https://app.example.com/dashboard
Vista en vivo
Cuando comienza una sesión, AgentCore imprime una URL de vista en vivo en stderr. Ábrela en un navegador para ver la sesión en tiempo real desde la consola de AWS:
Session: abc123-def456
Live View: https://us-east-1.console.aws.amazon.com/bedrock-agentcore/browser/aws.browser.v1/session/abc123-def456#
Selección de región
# Valor predeterminado: us-east-1
agent-browser -p agentcore open https://example.com
# Región explícita
AGENTCORE_REGION=eu-west-1 agent-browser -p agentcore open https://example.com
Patrones de credenciales
# Credenciales explícitas (CI/CD, scripts)
export AWS_ACCESS_KEY_ID=AKIA...
export AWS_SECRET_ACCESS_KEY=...
agent-browser -p agentcore open https://example.com
# SSO (interactivo)
aws sso login --profile my-profile
AWS_PROFILE=my-profile agent-browser -p agentcore open https://example.com
# Rol IAM / cadena de credenciales predeterminada
agent-browser -p agentcore open https://example.com
Uso con AGENT_BROWSER_PROVIDER
Establece el proveedor a través de una variable de entorno para evitar pasar -p agentcore en cada comando:
export AGENT_BROWSER_PROVIDER=agentcore
export AGENTCORE_REGION=us-east-2
agent-browser open https://example.com
agent-browser snapshot -i
agent-browser click @e1
agent-browser close
Problemas comunes
"Failed to run aws CLI" significa que la CLI de AWS no está instalada o no está en el PATH. Instálala o establece directamente AWS_ACCESS_KEY_ID y AWS_SECRET_ACCESS_KEY.
"AWS CLI failed: ... Run 'aws sso login'" significa que las credenciales SSO han caducado. Ejecuta aws sso login para renovarlas.
Tiempo de espera de la sesión: El valor predeterminado es 3600 segundos (1 hora). Para tareas más largas, aumenta con AGENTCORE_SESSION_TIMEOUT=7200.