View a markdown version of this page

Verwendung von Browserprofilen - Amazon Grundgestein AgentCore
-ÜbersichtVoraussetzungenErste Schritte mit BrowserprofilenOperationen mit BrowserprofilenAnwendungsfälleÜberlegungen

Verwendung von Browserprofilen

Mit Browserprofilen können Sie Browserprofildaten über mehrere Browsersitzungen hinweg beibehalten und wiederverwenden. Ein Browserprofil speichert Sitzungsinformationen, einschließlich Cookies und lokalem Speicher.

Sie können sich beispielsweise einmal in einer Browsersitzung auf einer Website authentifizieren und die Profildaten in der Browserprofilressource speichern. Wenn Sie eine neue Browsersitzung mit diesem gespeicherten Profil starten, bleibt Ihr Authentifizierungsstatus erhalten und Sie bleiben angemeldet. Auf diese Weise können Agenten Aufgaben auf authentifizierten Websites ausführen, ohne dass manuelles Eingreifen erforderlich ist.

-Übersicht

Browserprofile in Amazon Bedrock AgentCore funktionieren wie folgt:

  1. Erstellen Sie eine Browserprofilressource, die in mehreren Browsersitzungen wiederverwendet wird

  2. Starten Sie eine Browsersitzung und führen Sie Aktionen aus (z. B. eine Website anmelden oder Artikel in den Warenkorb legen), um Cookies und LocalStorage zu füllen

  3. Speichern Sie die Profildaten der aktuellen Browsersitzung in der Browserprofilressource

  4. Starten Sie neue Browsersitzungen mit dem gespeicherten Profil, um den vorherigen Status wiederherzustellen

Voraussetzungen

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

  • Sie haben die allgemeinen Browservoraussetzungen erfüllt

  • IAM-Berechtigungen zur Verwaltung von Profilressourcen. Fügen Sie Ihrer IAM-Richtlinie die folgenden Berechtigungen hinzu:

    {
"Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "BedrockAgentCoreBrowserProfileManagementAccess",
            "Effect": "Allow",
            "Action": [
                "bedrock-agentcore:CreateBrowserProfile",
                "bedrock-agentcore:ListBrowserProfiles",
                "bedrock-agentcore:GetBrowserProfile",
                "bedrock-agentcore:DeleteBrowserProfile"
            ],
            "Resource": "arn:aws:bedrock-agentcore:<Region>:<account_id>:browser-profile/*"
        }
    ]
}

  • IAM-Berechtigungen zum Speichern und Laden von Profilen. Fügen Sie Ihrer IAM-Richtlinie die folgenden Berechtigungen hinzu:

    {
"Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "BedrockAgentCoreBrowserProfileUsageAccess",
            "Effect": "Allow",
            "Action": [
                "bedrock-agentcore:StartBrowserSession",
                "bedrock-agentcore:SaveBrowserSessionProfile"
            ],
            "Resource": [
                "arn:aws:bedrock-agentcore:<Region>:<account_id>:browser-profile/*",
                "arn:aws:bedrock-agentcore:<Region>:<account_id>:browser-custom/*",
                "arn:aws:bedrock-agentcore:<Region>:<account_id>:browser/*"
            ]
        }
    ]
}

Erste Schritte mit Browserprofilen

In diesem Abschnitt erfahren Sie, wie Sie ein Browserprofil erstellen, Sitzungsdaten darin speichern und das Profil in nachfolgenden Sitzungen wiederverwenden.

Schritt 1: Erstellen Sie ein Browserprofil

Erstellen Sie eine Browserprofilressource zum Speichern von Sitzungsdaten.

Beispiel
AWS CLI

  1. So erstellen Sie ein Browserprofil mit der AWS CLI:

    aws bedrock-agentcore-control create-browser-profile \
  --region <Region> \
  --name "profile_demo" \
  --description "example profile"
Boto3

  1. Um ein Browserprofil mit dem AWS SDK for Python (Boto3) zu erstellen:

    import boto3

region = "us-west-2"
client = boto3.client('bedrock-agentcore-control', region_name=region)

response = client.create_browser_profile(
    name="profile_demo",
    description="example profile"
)

profile_id = response['profileId']
print(f"Created profile: {profile_id}")
API

  1. Um ein Browserprofil mit der API zu erstellen:

    awscurl -X PUT \
  "https://bedrock-agentcore-control.<Region>.amazonaws.com/browser-profiles" \
  -H "Content-Type: application/json" \
  --service bedrock-agentcore-control \
  --region <Region> \
  -d '{
    "name": "profile_demo",
    "description": "example profile",
    "clientToken": "FC21DD1F-FA7B-40EC-8D3A-12E029A1BFF3"
  }'

Schritt 2: Starten Sie eine Browsersitzung und führen Sie Aktionen aus

Starten Sie eine Browsersitzung und führen Sie Aktionen aus, z. B. das Anmelden auf einer Website. Der Sitzungsstatus, einschließlich Cookies und lokalem Speicher, wird erfasst.

Beispiel
AWS CLI

  1. So starten Sie eine Browsersitzung mit der AWS CLI:

    aws bedrock-agentcore start-browser-session \
  --region <Region> \
  --browser-identifier "aws.browser.v1" \
  --name "my-session" \
  --session-timeout-seconds 3600

    Verwenden Sie die zurückgegebene Sitzungs-ID, um mit dem Browser zu interagieren und die gewünschten Aktionen auszuführen (z. B. sich auf einer Website anzumelden).

Boto3

  1. Um eine Browsersitzung mit Boto3 zu starten:

    import boto3

region = "us-west-2"
client = boto3.client('bedrock-agentcore', region_name=region)

response = client.start_browser_session(
    browserIdentifier="aws.browser.v1",
    name="my-session",
    sessionTimeoutSeconds=3600
)

session_id = response['sessionId']
print(f"Session ID: {session_id}")

# Use the session to perform actions (e.g., login to a website)
# ... your browser automation code here ...
API

  1. Um eine Browsersitzung mit der API zu starten:

    awscurl -X PUT \
  "https://bedrock-agentcore.<Region>.amazonaws.com/browsers/aws.browser.v1/sessions/start" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  --service bedrock-agentcore \
  --region <Region> \
  -d '{
    "name": "my-session",
    "sessionTimeoutSeconds": 3600
  }'

Schritt 3: Speichern Sie die Sitzung in einem Profil

Nachdem Sie Aktionen in der Browsersitzung ausgeführt haben, speichern Sie den aktuellen Status in Ihrem Browserprofil. Dadurch werden Cookies, lokaler Speicher und andere Sitzungsdaten erfasst.

Beispiel
AWS CLI

  1. So speichern Sie eine Browsersitzung mit der AWS CLI in einem Profil:

    aws bedrock-agentcore save-browser-session-profile \
  --region <Region> \
  --profile-identifier "<ProfileId>" \
  --browser-identifier "aws.browser.v1" \
  --session-id "<SessionId>"
Boto3

  1. Um eine Browsersitzung mit Boto3 in einem Profil zu speichern:

    import boto3

region = "us-west-2"
client = boto3.client('bedrock-agentcore', region_name=region)

response = client.save_browser_session_profile(
    profileIdentifier=profile_id,  # From Step 1
    browserIdentifier="aws.browser.v1",
    sessionId=session_id  # From Step 2
)

print(f"Profile saved successfully")
API

  1. Um eine Browsersitzung mithilfe der API in einem Profil zu speichern:

    awscurl -X PUT \
  "https://bedrock-agentcore.<Region>.amazonaws.com/browser-profiles/<ProfileId>/save" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  --service bedrock-agentcore \
  --region <Region> \
  -d '{
    "browserIdentifier": "aws.browser.v1",
    "sessionId": "<SessionId>",
    "clientToken": "52866F95-4468-4B6C-920C-09A00D36F04E"
  }'

Schritt 4: Starten Sie eine neue Sitzung mit dem Profil

Starten Sie eine neue Browsersitzung mit dem gespeicherten Profil. Die Sitzung wird mit dem gespeicherten Status initialisiert, einschließlich Authentifizierungs-Cookies und lokalem Speicher.

Beispiel
AWS CLI

  1. So starten Sie eine Browsersitzung mit einem Profil mithilfe der AWS CLI:

    aws bedrock-agentcore start-browser-session \
  --region <Region> \
  --browser-identifier "aws.browser.v1" \
  --name "session-with-profile" \
  --session-timeout-seconds 3600 \
  --profile-configuration '{
    "profileIdentifier":"<ProfileId>"
  }'
Boto3

  1. Um eine Browsersitzung mit einem Profil mit Boto3 zu starten:

    import boto3

region = "us-west-2"
client = boto3.client('bedrock-agentcore', region_name=region)

response = client.start_browser_session(
    browserIdentifier="aws.browser.v1",
    name="session-with-profile",
    sessionTimeoutSeconds=3600,
    profileConfiguration={
        "profileIdentifier": profile_id  # From Step 1
    }
)

new_session_id = response['sessionId']
print(f"New session started with profile: {new_session_id}")
print("Session is now authenticated with saved cookies and state")
API

  1. So starten Sie mithilfe der API eine Browsersitzung mit einem Profil:

    awscurl -X PUT \
  "https://bedrock-agentcore.<Region>.amazonaws.com/browsers/aws.browser.v1/sessions/start" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  --service bedrock-agentcore \
  --region <Region> \
  -d '{
    "name": "session-with-profile",
    "sessionTimeoutSeconds": 3600,
    "profileConfiguration": {
      "profileIdentifier": "<ProfileId>"
    },
    "clientToken": "8FAAFF7F-7803-4C40-A7BD-139C6D008646"
  }'

Operationen mit Browserprofilen

In diesem Abschnitt werden zusätzliche Operationen zur Verwaltung von Browserprofilen beschrieben.

Browserprofile auflisten

Sie können alle Browserprofile in Ihrem Konto auflisten.

Beispiel
AWS CLI

  1. So listen Sie Browserprofile mit der AWS CLI auf:

    aws bedrock-agentcore-control list-browser-profiles \
  --region <Region>
Boto3

  1. Um Browserprofile mit Boto3 aufzulisten:

    import boto3

region = "us-west-2"
client = boto3.client('bedrock-agentcore-control', region_name=region)

response = client.list_browser_profiles()

for profile in response.get('items', []):
    print(f"Profile ID: {profile['profileId']}")
    print(f"Name: {profile['name']}")
    print(f"Status: {profile['status']}")
    print("---")
API

  1. Um Browserprofile mithilfe der API aufzulisten:

    awscurl -X POST \
  "https://bedrock-agentcore-control.<Region>.amazonaws.com/browser-profiles/list" \
  -H "Content-Type: application/json" \
  --service bedrock-agentcore-control \
  --region <Region>

Details zum Browserprofil abrufen

Sie können Details zu einem bestimmten Browserprofil abrufen.

Beispiel
AWS CLI

  1. So rufen Sie Browserprofildetails mit der AWS CLI ab:

    aws bedrock-agentcore-control get-browser-profile \
  --region <Region> \
  --profile-id "<ProfileId>"
Boto3

  1. So rufen Sie Browserprofildetails mit Boto3 ab:

    import boto3

region = "us-west-2"
client = boto3.client('bedrock-agentcore-control', region_name=region)

response = client.get_browser_profile(
    profileId=profile_id
)

print(f"Profile ID: {response['profileId']}")
print(f"Name: {response['name']}")
print(f"Description: {response.get('description', 'N/A')}")
print(f"Status: {response['status']}")
print(f"Created: {response['createdAt']}")
API

  1. So rufen Sie Browserprofildetails mithilfe der API ab:

    awscurl -X GET \
  "https://bedrock-agentcore-control.<Region>.amazonaws.com/browser-profiles/<ProfileId>" \
  -H "Content-Type: application/json" \
  --service bedrock-agentcore-control \
  --region <Region>

Löschen eines Browserprofils

Wenn Sie ein Browserprofil nicht mehr benötigen, können Sie es löschen, um Ressourcen freizugeben.

Beispiel
AWS CLI

  1. So löschen Sie ein Browserprofil mit der AWS CLI:

    aws bedrock-agentcore-control delete-browser-profile \
  --region <Region> \
  --profile-id "<ProfileId>"
Boto3

  1. Um ein Browserprofil mit Boto3 zu löschen:

    import boto3

region = "us-west-2"
client = boto3.client('bedrock-agentcore-control', region_name=region)

response = client.delete_browser_profile(
    profileId=profile_id
)

print(f"Profile deleted successfully")
API

  1. Um ein Browserprofil mithilfe der API zu löschen:

    awscurl -X DELETE \
  "https://bedrock-agentcore-control.<Region>.amazonaws.com/browser-profiles/<ProfileId>" \
  -H "Content-Type: application/json" \
  --service bedrock-agentcore-control \
  --region <Region>

Anwendungsfälle

Browserprofile sind nützlich für:

  • Dauerhafte Authentifizierung: Behalten Sie Anmeldesitzungen über mehrere Browser-Aufrufe hinweg bei, ohne sich jedes Mal neu zu authentifizieren

  • Multi-step Workflows: Führen Sie komplexe Workflows aus, die sich über mehrere Sitzungen erstrecken, und behalten Sie dabei Status und Kontext (in Cookies oder lokalem Speicher) bei

  • Automatisierte Aufgaben: Ermöglichen Sie es KI-Agenten, Aufgaben auf authentifizierten Websites ohne manuelles Eingreifen auszuführen

Überlegungen

  • Profilpersistenz: Profildaten werden gespeichert, wenn Sie den Speichervorgang explizit aufrufen. Stellen Sie sicher, dass Sie das Profil speichern, bevor Sie die Sitzung beenden, um den Status beizubehalten.

  • Sitzungsisolierung: Jede Browsersitzung, die ein Profil verwendet, funktioniert unabhängig. In einer Sitzung vorgenommene Änderungen sind in anderen gleichzeitigen Sitzungen nicht sichtbar.

  • Profil wird geladen: Gespeicherte Profiländerungen gelten nur für neue Sitzungen. Aktive Sitzungen verwenden weiterhin den Profilstatus ab dem Zeitpunkt, an dem sie gestartet wurden, und spiegeln keine Aktualisierungen wider, die nach dem Sitzungsstart am Profil vorgenommen wurden.

  • Sicherheit: Browserprofile können vertrauliche Daten wie Authentifizierungs-Cookies enthalten. Stellen Sie sicher, dass die richtigen IAM-Richtlinien vorhanden sind, um den Zugriff auf Profilressourcen einzuschränken.

  • Profilaktualisierungen: Wenn Sie eine Sitzung in einem Profil speichern, werden die vorherigen Profildaten überschrieben. Überlegen Sie sich Ihren Arbeitsablauf sorgfältig, um zu vermeiden, dass wichtige Statusinformationen verloren gehen.

  • Ablauf von Cookies: Cookies haben ihre eigenen Ablaufzeiten, die von Websites festgelegt werden. In Browserprofilen werden Cookies gespeichert, aber abgelaufene Cookies werden vom Browser automatisch entsprechend ihrem Ablaufdatum entfernt.