Rekaman Sesi dan Putar Ulang

Perekaman dan pemutaran ulang sesi browser memberikan pengamatan komprehensif untuk tujuan debugging, audit, atau pelatihan. Saat Anda membuat browser dengan perekaman sesi diaktifkan, Amazon Bedrock AgentCore secara otomatis menangkap interaksi browser dan menyimpannya di bucket Amazon S3 yang Anda tentukan untuk analisis selanjutnya.

Pemutaran ulang sesi menangkap data interaksi browser komprehensif yang memungkinkan Anda melihat tayangan ulang dan memahami tindakan yang terjadi selama sesi browser. Fungsionalitas ini membantu Anda mengatasi kesalahan dan meningkatkan pemanggilan future dengan memberikan wawasan terperinci tentang perilaku browser.

Informasi yang dikumpulkan selama pemutaran ulang sesi meliputi:

Prasyarat untuk perekaman sesi

Untuk mengaktifkan perekaman sesi, Anda perlu:

Konfigurasikan peran IAM untuk merekam

Untuk mengaktifkan perekaman sesi, Anda memerlukan peran eksekusi IAM dengan izin untuk menulis data rekaman ke Amazon S3 dan aktivitas log ke. CloudWatch Untuk petunjuk mendetail tentang pengaturan izin, lihat Izin.

Peran eksekusi memerlukan izin tambahan di luar izin browser standar:

{
    "Sid": "S3Permissions",
    "Effect": "Allow",
    "Action": [
        "s3:PutObject",
        "s3:GetObject",
        "s3:ListBucket",
        "s3:ListMultipartUploadParts",
        "s3:AbortMultipartUpload"
    ],
    "Resource": [
        "arn:aws:s3:::your-recording-bucket",
        "arn:aws:s3:::your-recording-bucket/*"
    ]
},
{
    "Sid": "CloudWatchLogsPermissions",
    "Effect": "Allow",
    "Action": [
        "logs:CreateLogGroup",
        "logs:CreateLogStream",
        "logs:PutLogEvents",
        "logs:DescribeLogStreams"
    ],
    "Resource": "*"
}

Ganti your-recording-bucket dengan nama bucket Amazon S3 Anda yang sebenarnya.

Langkah 1: Buat alat browser dengan merekam

Buat alat browser khusus dengan perekaman diaktifkan. Untuk petunjuk mendetail tentang cara membuat alat browser, lihat Membuat AgentCore Browser.

Saat membuat alat browser Anda, pastikan Anda:

Contoh menggunakan Python SDK:

import boto3
import uuid

region = "us-west-2"
bucket = "your-recording-bucket"

client = boto3.client("bedrock-agentcore-control", region_name=region)

response = client.create_browser(
    name="MyRecordingBrowser",
    description="Browser with session recording enabled",
    networkConfiguration={"networkMode": "PUBLIC"},
    executionRoleArn="arn:aws:iam::123456789012:role/AgentCoreBrowserRecordingRole",
    clientToken=str(uuid.uuid4()),
    recording={
        "enabled": True,
        "s3Location": {
            "bucket": bucket,
            "prefix": "browser-recordings"
        }
    }
)

browser_identifier = response.get("browserId") or response.get("browserIdentifier")
print(f"Created browser with recording: {browser_identifier}")
print(f"Recordings will be stored at: s3://{bucket}/browser-recordings/")

Langkah 2: Gunakan browser yang mendukung perekaman

Gunakan browser Anda yang mendukung perekaman dengan kerangka kerja otomatisasi apa pun. Semua interaksi browser akan direkam secara otomatis. Contoh menggunakan Strands:

from strands import Agent
from strands_tools.browser import AgentCoreBrowser

# Use the browser created with recording
browser_identifier = "your-browser-identifier"
region = "us-west-2"
browser_tool = AgentCoreBrowser(region=region, identifier=browser_identifier)

agent = Agent(tools=[browser_tool.browser])
prompt = (
    "Navigate to https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/what-is-bedrock-agentcore.html "
    "and summarize the key features of AgentCore."
)

response = agent(prompt)
print("Agent Response:")
print(response.message["content"][0]["text"])

Semua interaksi selama sesi ini akan direkam dan diunggah secara otomatis ke bucket Amazon S3 Anda saat sesi berakhir.

Langkah 3: Pantau sesi langsung dan putar ulang rekaman

AWS Konsol menyediakan alat komprehensif untuk pemantauan waktu nyata dan analisis sesi yang direkam.

Pemantauan tampilan langsung

Pantau sesi browser secara real-time dan berinteraksi dengan sesi aktif:

Untuk mengakses tampilan langsung di konsol

Antarmuka tampilan langsung menyediakan:

Pemutaran ulang dan analisis sesi

Akses rekaman dan analisis sesi terperinci melalui antarmuka pemutaran ulang konsol:

Untuk mengakses pemutaran ulang sesi di konsol

Fitur analisis sesi

Konsol menyediakan beberapa alat analisis:

Navigasikan rekaman

Gunakan metode ini untuk menavigasi rekaman:

Langkah 4: Akses rekaman secara terprogram

Akses tampilan langsung dan rekaman insight secara terprogram menggunakan Amazon Bedrock AgentCore SDK dan API untuk integrasi kustom dan analisis otomatis.

Akses tampilan langsung terprogram

Connect to live browser session menggunakan browser client dan viewer server:

import time
from rich.console import Console
from bedrock_agentcore.tools.browser_client import browser_session
from browser_viewer import BrowserViewerServer

console = Console()

def main():
    try:
        # Create browser session
        with browser_session('us-west-2') as client:
            print("✅ Browser ready!")
            ws_url, headers = client.generate_ws_headers()

            # Start viewer server
            console.print("[cyan]Starting viewer server...[/cyan]")
            viewer = BrowserViewerServer(client, port=8005)
            viewer_url = viewer.start(open_browser=True)

            # Keep running
            while True:
                time.sleep(1)

    except KeyboardInterrupt:
        console.print("[yellow]Shutting down...[/yellow]")
        if 'client' in locals():
            client.stop()
            console.print("✅ Browser session terminated")

if __name__ == "__main__":
    main()

Akses perekaman terprogram

Akses data perekaman langsung dari Amazon S3 untuk alur kerja analisis kustom:

import boto3

s3_client = boto3.client('s3', region_name='us-west-2')

# List recordings in your bucket
bucket_name = "your-recording-bucket"
prefix = "browser-recordings/"

response = s3_client.list_objects_v2(Bucket=bucket_name, Prefix=prefix)

print(f"Recordings in s3://{bucket_name}/{prefix}:")
for obj in response.get('Contents', []):
    print(f"  {obj['Key']} ({obj['Size']} bytes)")
    print(f"    Last Modified: {obj['LastModified']}")
    print()

Merekam struktur data:

s3://your-recording-bucket/browser-recordings/
  └── session-id/
      ├── batch_1.ndjson.gz
      ├── batch_2.ndjson.gz
      └── batch_3.ndjson.gz

Setiap sesi membuat folder dengan ID sesi, dan data rekaman diunggah dalam potongan saat sesi berlangsung.

Contoh program pemutaran ulang sesi

Untuk kasus penggunaan lanjutan, Anda dapat membuat pemirsa pemutaran ulang sesi kustom dan mengintegrasikan data rekaman ke dalam alur kerja analisis Anda sendiri.

GitHub Contoh berikut menunjukkan penampil replay sesi mandiri dan seperti apa pengalaman browser lengkap saat menggunakan fitur pemutaran ulang sesi browser.

Untuk contoh tambahan, lihat contoh AgentCore Browser pada GitHub.

# View the latest recording in a bucket
python view_recordings.py --bucket session-record-test-123456789012 --prefix replay-data

# View a specific recording
python view_recordings.py --bucket session-record-test-123456789012 --prefix replay-data --session 01JZVDG02M8MXZY2N7P3PKDQ74

# Use a specific AWS profile
python view_recordings.py --bucket session-record-test-123456789012 --prefix replay-data --profile my-profile

# View the latest recording in a bucket
python -m live_view_sessionreplay.browser_interactive_session