Erste Schritte mit AgentCore Browser
AgentCore Mit dem Browser können Ihre Agenten über einen verwalteten Chrome-Browser mit Webseiten interagieren. In diesem Handbuch erstellen Sie einen KI-Agenten, der auf einer Website navigiert und Informationen extrahiert — in weniger als 5 Minuten.
Themen
Voraussetzungen
Bevor Sie beginnen, stellen Sie sicher, dass Sie über Folgendes verfügen:
-
Python 3.10 oder neuer (Python. org/downloads
) -
Boto3 installiert (Boto3-Dokumentation
) -
AWS Anmeldeinformationen konfiguriert — überprüfen Sie mit:
aws sts get-caller-identityWenn dieser Befehl fehlschlägt, finden Sie weitere Informationen unter Konfiguration und Einstellungen der Anmeldeinformationsdatei in der AWS CLI-Dokumentation.
-
Zugriff auf das Modell Anthropic Claude Sonnet 4.0 in der Amazon Bedrock-Konsole aktiviert
-
AWS Region, in der Amazon Bedrock verfügbar AgentCore ist (siehe Unterstützte AWS Regionen)
IAM-Berechtigungen
Hängen Sie diese Richtlinie an Ihre IAM-Identität an. Suchen Sie in der IAM-Konsole nach Ihrem Benutzer oder Ihrer Rolle, wählen Sie Berechtigungen hinzufügen > Inline-Richtlinie erstellen, wechseln Sie zur JSON-Ansicht und fügen Sie Folgendes ein:
{ "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": [ "*" ] } ] }
Anmerkung
<Region>Ersetzen Sie es durch Ihre tatsächliche AWS Region und <account_id> durch Ihre AWS Konto-ID.
Schritt 1: Abhängigkeiten installieren
pip install bedrock-agentcore strands-agents strands-agents-tools playwright nest-asyncio
Schritt 2: Erstellen Sie Ihren Agenten
Erstellen Sie eine Datei mit dem Namenbrowser_agent.py:
Anmerkung
<Region>Ersetzen Sie es durch Ihre AWS Region (z. B.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"])
Schritt 3: Führen Sie den Agenten aus
python browser_agent.py
Sie sollten sehen, wie der Agent auf der Website navigiert und Details zu den AgentCore Diensten zurückgibt. Wenn Sie auf Fehler stoßen, überprüfen Sie Ihre IAM-Berechtigungen, Ihren Modellzugriff und Ihre AWS Anmeldeinformationen.
Schritt 4: Sehen Sie sich die Browsersitzung live an
Während Ihr Agent läuft, können Sie ihn in Echtzeit über die AWS Konsole verfolgen:
-
Öffnen Sie die AgentCore Browser-Konsole
-
Navigieren Sie in der linken Navigationsleiste zu Built-in Tools
-
Wählen Sie das Browser-Tool aus (z. B.
AgentCore Browser Tool, oder Ihren benutzerdefinierten Browser) -
Suchen Sie im Abschnitt Browsersitzungen nach Ihrer aktiven Sitzung mit dem Status Bereit
-
Klicken Sie in der Spalte Live-Ansicht/ Aufzeichnung auf die angegebene URL „Live-Sitzung anzeigen“
Die Live-Ansicht bietet einen Echtzeit-Videostream mit interaktiven Steuerelementen, mit denen Sie die Steuerung der Automatisierung übernehmen oder freigeben können.
Ihre Ressourcen finden
Nachdem Sie den AgentCore Browser verwendet haben, können Sie sich Ihre Ressourcen in der AWS Konsole ansehen:
| # | Ressource | Speicherort |
|---|---|---|
|
1 |
Live-Ansicht |
Browserkonsole > Name des Tools > Live-Sitzung anzeigen |
|
2 |
Sitzungsaufzeichnungen und Wiederholung |
Browserkonsole > Name des Tools > Aufzeichnung anzeigen |
|
3 |
Browser-Protokolle |
CloudWatch> Gruppen protokollieren > |
|
4 |
Dateien aufzeichnen |
S3 > Dein Bucket > |
|
5 |
Benutzerdefinierte Browser |
AgentCore Konsole > Built-in Tools > Ihr benutzerdefinierter Browser |
|
6 |
IAM-Rollen |
IAM > Rollen > Suchen Sie nach Ihrer Ausführungsrolle |
Nächste Schritte
Jetzt, wo der AgentCore Browser funktioniert, können Sie sich mit diesen erweiterten Funktionen vertraut machen:
-
Sitzungsaufzeichnung und -wiedergabe — Aufzeichnen und Wiedergeben von Sitzungen zum Debuggen
-
AgentCore Browser mit Nova Act verwenden und AgentCore Browser mit Playwright verwenden — Verwenden Sie andere Frameworks wie Nova Act oder Playwright
-
Grundlagen — Erfahren Sie mehr über API-Operationen und benutzerdefinierte Browser