Commencez avec AgentCore Browser
AgentCore Le navigateur permet à vos agents d'interagir avec les pages Web via un navigateur Chrome géré. Dans ce guide, vous allez créer un agent d'intelligence artificielle qui navigue sur un site Web et extrait des informations, en moins de 5 minutes.
Rubriques
Conditions préalables
Avant de commencer, assurez-vous d'avoir :
-
Python 3.10 ou version ultérieure (python. org/downloads
) -
Boto3 installé (documentation Boto3
) -
AWS informations d'identification configurées — vérifiez avec :
aws sts get-caller-identitySi cette commande échoue, consultez la section Configuration et paramètres du fichier d'identification dans la documentation de la AWS CLI.
-
Accès au modèle Anthropic Claude Sonnet 4.0 activé dans la console Amazon Bedrock
-
AWS Région dans laquelle Amazon Bedrock AgentCore est disponible (voir AWS Régions prises en charge)
Autorisations IAM
Associez cette politique à votre identité IAM. Dans la console IAM, recherchez votre utilisateur ou votre rôle, choisissez Ajouter des autorisations > Créer une politique intégrée, passez à la vue JSON et collez :
{ "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": [ "*" ] } ] }
Note
Remplacez <Region> par votre AWS région actuelle et <account_id> par votre numéro de AWS compte.
Étape 1 : installer les dépendances
pip install bedrock-agentcore strands-agents strands-agents-tools playwright nest-asyncio
Étape 2 : Créez votre agent
Créez un fichier nommé browser_agent.py :
Note
Remplacez <Region> par votre AWS région (par exemple,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"])
Étape 3 : Exécuter l'agent
python browser_agent.py
Vous devriez voir l'agent naviguer sur le site Web et renvoyer des informations sur les AgentCore services. Si vous rencontrez des erreurs, vérifiez vos autorisations IAM, votre accès au modèle et vos AWS informations d'identification.
Étape 4 : Afficher la session du navigateur en direct
Pendant que votre agent est actif, vous pouvez le suivre en temps réel via la AWS console :
-
Ouvrez la console AgentCore du navigateur
-
Accédez aux Built-in outils dans la barre de navigation de gauche
-
Sélectionnez l'outil Navigateur (par exemple
AgentCore Browser Tool, ou votre navigateur personnalisé) -
Dans la section Sessions du navigateur, trouvez votre session active avec le statut Prêt
-
Dans la colonne Affichage en direct/enregistrement, cliquez sur l'URL « Afficher la session en direct » fournie
La vue en direct fournit un flux vidéo en temps réel avec des commandes interactives permettant de prendre le relais ou de libérer le contrôle de l'automatisation.
Identifiez vos ressources
Après avoir utilisé AgentCore le navigateur, consultez vos ressources dans la AWS console :
| # | Ressource | Location |
|---|---|---|
|
1 |
Vue en direct |
Console du navigateur > Nom de l'outil > Afficher la session en direct |
|
2 |
Enregistrements et rediffusion de sessions |
Console du navigateur > Nom de l'outil > Afficher l'enregistrement |
|
3 |
Journaux du navigateur |
CloudWatch> Groupes de logs > |
|
4 |
Fichiers d'enregistrement |
S3 > Votre compartiment > |
|
5 |
Navigateurs personnalisés |
AgentCore Console > Built-in Outils > Votre navigateur personnalisé |
|
6 |
Rôles IAM |
IAM > Rôles > Recherchez votre rôle d'exécution |
Étapes suivantes
Maintenant que le AgentCore navigateur fonctionne, explorez ces fonctionnalités avancées :
-
Enregistrement et relecture de sessions - Enregistrez et rejouez des sessions à des fins de débogage
-
Utilisation AgentCore du navigateur avec Nova Act et utilisation AgentCore du navigateur avec Playwright - Utilisez d'autres frameworks tels que Nova Act ou Playwright
-
Principes de base - En savoir plus sur les opérations d'API et les navigateurs personnalisés