会话录制和重播

浏览器会话记录和重播为调试、审计或训练目的提供了全面的可观察性。当您创建启用会话记录功能的浏览器时，Amazon Bedrock AgentCore 会自动捕获浏览器交互并将其存储在您指定的 Amazon S3 存储桶中以供日后分析。

会话重播可捕获全面的浏览器交互数据，使您能够查看重播并了解浏览器会话期间发生的操作。此功能通过提供对浏览器行为的详细见解，帮助您解决错误并改进 future 的调用。

会话重播期间收集的信息包括：

会话录制的先决条件

要启用会话录制，您需要：

配置 IAM 角色以进行录制

要启用会话录制，您需要一个 IAM 执行角色，该角色有权将录制数据写入 Amazon S3 并将活动记录到 CloudWatch。有关设置权限的详细说明，请参阅权限。

除了标准浏览器权限之外，执行角色还需要其他权限：

{
    "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": "*"
}

your-recording-bucket替换为您实际的 Amazon S3 存储桶名称。

第 1 步：创建带录制功能的浏览器工具

创建启用录制功能的自定义浏览器工具。有关创建浏览器工具的详细说明，请参阅创建 AgentCore 浏览器。

创建浏览器工具时，请确保：

使用 Python 开发工具包的示例：

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/")

第 2 步：使用支持录制功能的浏览器

将支持录制功能的浏览器与任何自动化框架配合使用。将自动记录所有浏览器互动。使用链的示例：

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"])

会话期间的所有互动都将自动记录下来，并在会话结束时上传到您的 Amazon S3 存储桶。

第 3 步：监控直播会话和重播录像

AWS 控制台为实时监控和录制的会话分析提供了全面的工具。

实时取景监控

实时监控浏览器会话并与活动会话进行交互：

在控制台中访问实时视图

实时预览界面提供：

会话重播和分析

通过控制台重播界面访问详细的会话录制和分析：

在控制台中访问会话重播

会话分析功能

控制台提供多种分析工具：

浏览录音

使用以下方法浏览录音：

第 4 步：以编程方式访问录音

使用 Amazon Bedrock AgentCore SDK 和 API，以编程方式访问实时视图和记录见解，进行自定义集成和自动分析。

编程实时取景权限

使用浏览器客户端和查看器服务器连接到实时浏览器会话：

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

编程录制访问权限

直接从 Amazon S3 访问记录数据以进行自定义分析工作流程：

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

录制数据结构：

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

每个会话都会创建一个带有会话 ID 的文件夹，随着会话的进行，录制数据将分块上传。

会话重播编程示例

对于高级用例，您可以构建自定义会话重播查看器，并将录制数据集成到自己的分析工作流程中。

以下 GitHub 示例显示了独立的会话重播查看器，以及使用浏览器会话重播功能时的完整浏览器体验。

有关其他示例，请参阅上的AgentCore 浏览器示例 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