Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

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 nanti.

Putar ulang sesi menangkap data interaksi browser komprehensif yang memungkinkan Anda melihat tayangan ulang dan memahami tindakan yang terjadi selama sesi browser. Fungsi ini membantu Anda mengatasi kesalahan dan meningkatkan pemanggilan di masa mendatang dengan memberikan wawasan terperinci tentang perilaku browser.

Informasi yang dikumpulkan selama sesi replay 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 mencatat aktivitas ke CloudWatch. Untuk petunjuk terperinci 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 rekaman

Buat alat browser khusus dengan perekaman diaktifkan. Untuk petunjuk terperinci tentang 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 mengaktifkan perekaman

Gunakan browser Anda yang mendukung perekaman dengan kerangka 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 secara otomatis dan diunggah ke bucket Amazon S3 Anda saat sesi berakhir.

Langkah 3: Pantau sesi langsung dan putar ulang rekaman

Kon AWS sol 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:

Putar ulang sesi dan analisis

Akses rekaman sesi terperinci dan analisis melalui antarmuka replay konsol:

Untuk mengakses pemutaran ulang sesi di konsol

Fitur analisis sesi

Konsol menyediakan beberapa alat analisis:

Navigasi rekaman

Gunakan metode ini untuk menavigasi melalui rekaman:

Langkah 4: Akses rekaman secara terprogram

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

Akses tampilan langsung terprogram

Hubungkan ke sesi browser langsung menggunakan klien browser dan server penampil:

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 rekaman 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()

Struktur data perekaman:

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 terprogram pemutaran ulang sesi

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

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

Untuk contoh tambahan, lihat Contoh AgentCore browser pada GitHub.