本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

会话录制和重播

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

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

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

会话录制的先决条件

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

配置用于录制的 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 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/")

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

在任何自动化框架中使用支持录制的浏览器。所有浏览器交互都将自动记录。使用 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"])

会话结束后，会话期间的所有交互都将自动记录并上传到您的 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。