View a markdown version of this page

Erste Schritte mit AgentCore Browser - Amazon Grundgestein AgentCore

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.

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie über Folgendes verfügen:

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:

  1. Öffnen Sie die AgentCore Browser-Konsole

  2. Navigieren Sie in der linken Navigationsleiste zu Built-in Tools

  3. Wählen Sie das Browser-Tool aus (z. B.AgentCore Browser Tool, oder Ihren benutzerdefinierten Browser)

  4. Suchen Sie im Abschnitt Browsersitzungen nach Ihrer aktiven Sitzung mit dem Status Bereit

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

4

Dateien aufzeichnen

S3 > Dein Bucket > browser-recordings/ Präfix

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: