View a markdown version of this page

Commencez avec AgentCore Browser - Amazon Bedrock AgentCore

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.

Conditions préalables

Avant de commencer, assurez-vous d'avoir :

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 :

  1. Ouvrez la console AgentCore du navigateur

  2. Accédez aux Built-in outils dans la barre de navigation de gauche

  3. Sélectionnez l'outil Navigateur (par exempleAgentCore Browser Tool, ou votre navigateur personnalisé)

  4. Dans la section Sessions du navigateur, trouvez votre session active avec le statut Prêt

  5. 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 > /aws/bedrock-agentcore/browser/

4

Fichiers d'enregistrement

S3 > Votre compartiment > browser-recordings/ préfixe

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 :