Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
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 Paramètres du fichier de configuration et d'identification dans la documentation de l' AWS interface de ligne de commande.
-
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 Pris en charge 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 en ligne, passez en mode 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
<Region>Remplacez-la 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 en cours d'exécution, 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, recherchez 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, visualisez vos ressources dans la AWS console :
| # | Ressource | Location |
|---|---|---|
|
1 |
Affichage en direct |
Console du navigateur > Nom de l'outil > Afficher la session en direct |
|
2 |
Enregistrements et rediffusion des sessions |
Console du navigateur > Nom de l'outil > Afficher l'enregistrement |
|
3 |
Journaux du navigateur |
CloudWatch> Groupes de journaux > |
|
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 session : enregistrement et rediffusion de 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 fondamentaux - En savoir plus sur les opérations d'API et les navigateurs personnalisés