AWS Bedrock AgentCore
Führe agent-browser auf Cloud-Browser-Sitzungen aus, die von AWS Bedrock AgentCore gehostet werden. Alle Standardbefehle von agent-browser funktionieren identisch; der einzige Unterschied ist, wo der Browser läuft.
Einrichtung
Anmeldeinformationen werden automatisch aufgelöst:
- Umgebungsvariablen (
AWS_ACCESS_KEY_ID,AWS_SECRET_ACCESS_KEY, optionalAWS_SESSION_TOKEN) - AWS CLI Fallback (
aws configure export-credentials), das SSO, IAM-Rollen und benannte Profile unterstützt
Es ist keine zusätzliche Einrichtung erforderlich, wenn der Benutzer bereits funktionierende AWS-Anmeldeinformationen hat.
Kern-Workflow
# Öffne eine Seite auf einem AgentCore Cloud-Browser
agent-browser -p agentcore open https://example.com
# Alles andere ist identisch mit lokalem Chrome
agent-browser snapshot -i
agent-browser click @e1
agent-browser screenshot page.png
agent-browser close
Umgebungsvariablen
| Variable | Beschreibung | Standardwert |
|---|---|---|
AGENTCORE_REGION | AWS-Region | us-east-1 |
AGENTCORE_BROWSER_ID | Browser-Identifikator | aws.browser.v1 |
AGENTCORE_PROFILE_ID | Persönliches Browser-Profil (Cookies, localStorage) | (keine) |
AGENTCORE_SESSION_TIMEOUT | Sitzungs-Timeout in Sekunden | 3600 |
AWS_PROFILE | AWS CLI-Profil für die Anmeldeinformationsauflösung | default |
Persistente Profile
Verwende AGENTCORE_PROFILE_ID, um den Browser-Status über Sitzungen hinweg zu speichern. Dies ist nützlich, um Anmeldesitzungen aufrechtzuerhalten:
# Erster Durchlauf: Anmelden
AGENTCORE_PROFILE_ID=my-app agent-browser -p agentcore open https://app.example.com/login
agent-browser snapshot -i
agent-browser fill @e1 "[email protected]"
agent-browser fill @e2 "password"
agent-browser click @e3
agent-browser close
# Nachfolgende Durchläufe: bereits authentifiziert
AGENTCORE_PROFILE_ID=my-app agent-browser -p agentcore open https://app.example.com/dashboard
Live-Ansicht
Wenn eine Sitzung startet, gibt AgentCore eine Live-View-URL auf stderr aus. Öffne sie in einem Browser, um die Sitzung in Echtzeit über die AWS-Konsole zu verfolgen:
Session: abc123-def456
Live View: https://us-east-1.console.aws.amazon.com/bedrock-agentcore/browser/aws.browser.v1/session/abc123-def456#
Region-Auswahl
# Standard: us-east-1
agent-browser -p agentcore open https://example.com
# Explizite Region
AGENTCORE_REGION=eu-west-1 agent-browser -p agentcore open https://example.com
Anmeldeinformationsmuster
# Explizite Anmeldeinformationen (CI/CD, Skripte)
export AWS_ACCESS_KEY_ID=AKIA...
export AWS_SECRET_ACCESS_KEY=...
agent-browser -p agentcore open https://example.com
# SSO (interaktiv)
aws sso login --profile my-profile
AWS_PROFILE=my-profile agent-browser -p agentcore open https://example.com
# IAM-Rolle / Standard-Anmeldeinformationskette
agent-browser -p agentcore open https://example.com
Verwendung mit AGENT_BROWSER_PROVIDER
Setze den Anbieter über eine Umgebungsvariable, um bei jedem Befehl die Angabe von -p agentcore zu vermeiden:
export AGENT_BROWSER_PROVIDER=agentcore
export AGENTCORE_REGION=us-east-2
agent-browser open https://example.com
agent-browser snapshot -i
agent-browser click @e1
agent-browser close
Häufige Probleme
„Fehler beim Ausführen der AWS CLI“ bedeutet, dass die AWS CLI nicht installiert oder nicht im PATH ist. Installiere sie oder setze AWS_ACCESS_KEY_ID und AWS_SECRET_ACCESS_KEY direkt.
„AWS CLI fehlgeschlagen: ... Führe 'aws sso login' aus“ bedeutet, dass die SSO-Anmeldeinformationen abgelaufen sind. Führe aws sso login aus, um sie zu erneuern.
Sitzungs-Timeout: Der Standardwert beträgt 3600 Sekunden (1 Stunde). Für längere Aufgaben erhöhe den Wert mit AGENTCORE_SESSION_TIMEOUT=7200.