AWS Bedrock AgentCore
Exécute agent-browser sur des sessions de navigateur cloud hébergées par AWS Bedrock AgentCore. Toutes les commandes standard d'agent-browser fonctionnent de manière identique ; la seule différence est l'emplacement où le navigateur s'exécute.
Configuration
Les identifiants sont résolus automatiquement :
- Variables d'environnement (
AWS_ACCESS_KEY_ID,AWS_SECRET_ACCESS_KEY, éventuellementAWS_SESSION_TOKEN) - Secours via l'interface en ligne de commande AWS (
aws configure export-credentials), qui prend en charge SSO, les rôles IAM et les profils nommés
Aucune configuration supplémentaire n'est nécessaire si l'utilisateur possède déjà des identifiants AWS fonctionnels.
Flux de travail principal
# Ouvrir une page sur un navigateur cloud AgentCore
agent-browser -p agentcore open https://exemple.com
# Tout le reste est identique à Chrome local
agent-browser snapshot -i
agent-browser click @e1
agent-browser screenshot page.png
agent-browser close
Variables d'environnement
| Variable | Description | Valeur par défaut |
|---|---|---|
AGENTCORE_REGION | Région AWS | us-east-1 |
AGENTCORE_BROWSER_ID | Identifiant du navigateur | aws.browser.v1 |
AGENTCORE_PROFILE_ID | Profil navigateur persistant (cookies, localStorage) | (aucun) |
AGENTCORE_SESSION_TIMEOUT | Délai d'expiration de session en secondes | 3600 |
AWS_PROFILE | Profil AWS CLI pour la résolution des identifiants | default |
Profils persistants
Utilisez AGENTCORE_PROFILE_ID pour conserver l'état du navigateur entre les sessions. Cela est utile pour maintenir les sessions de connexion :
# Première exécution : connexion
AGENTCORE_PROFILE_ID=mon-app agent-browser -p agentcore open https://app.exemple.com/connexion
agent-browser snapshot -i
agent-browser fill @e1 "[email protected]"
agent-browser fill @e2 "motdepasse"
agent-browser click @e3
agent-browser close
# Exécutions ultérieures : déjà authentifié
AGENTCORE_PROFILE_ID=mon-app agent-browser -p agentcore open https://app.exemple.com/tableau-de-bord
Vue en direct
Lorsqu'une session démarre, AgentCore imprime une URL de vue en direct sur stderr. Ouvrez-la dans un navigateur pour regarder la session en temps réel depuis la console AWS :
Session : abc123-def456
Vue en direct : https://us-east-1.console.aws.amazon.com/bedrock-agentcore/browser/aws.browser.v1/session/abc123-def456#
Sélection de région
# Par défaut : us-east-1
agent-browser -p agentcore open https://exemple.com
# Région explicite
AGENTCORE_REGION=eu-west-1 agent-browser -p agentcore open https://exemple.com
Modes d'identification
# Identifiants explicites (CI/CD, scripts)
export AWS_ACCESS_KEY_ID=AKIA...
export AWS_SECRET_ACCESS_KEY=...
agent-browser -p agentcore open https://exemple.com
# SSO (interactif)
aws sso login --profile mon-profil
AWS_PROFILE=mon-profil agent-browser -p agentcore open https://exemple.com
# Rôle IAM / chaîne d'identification par défaut
agent-browser -p agentcore open https://exemple.com
Utilisation avec AGENT_BROWSER_PROVIDER
Définissez le fournisseur via une variable d'environnement pour éviter de passer -p agentcore à chaque commande :
export AGENT_BROWSER_PROVIDER=agentcore
export AGENTCORE_REGION=us-east-2
agent-browser open https://exemple.com
agent-browser snapshot -i
agent-browser click @e1
agent-browser close
Problèmes courants
« Échec de l'exécution d'aws CLI » signifie que l'interface en ligne de commande AWS n'est pas installée ou n'est pas dans le PATH. Installez-la ou définissez directement AWS_ACCESS_KEY_ID et AWS_SECRET_ACCESS_KEY.
« Échec d'aws CLI : ... Exécutez 'aws sso login' » signifie que les identifiants SSO ont expiré. Exécutez aws sso login pour les rafraîchir.
Expiration de session : La valeur par défaut est de 3600 secondes (1 heure). Pour les tâches plus longues, augmentez-la avec AGENTCORE_SESSION_TIMEOUT=7200.