Grabación y reproducción de sesiones

La grabación y reproducción de las sesiones del navegador proporcionan una observabilidad completa con fines de depuración, auditoría o formación. Cuando crea un navegador con la grabación de sesiones habilitada, Amazon Bedrock captura AgentCore automáticamente las interacciones del navegador y las almacena en el bucket de Amazon S3 especificado para su posterior análisis.

La reproducción de sesiones recopila datos completos de interacción con el navegador que le permiten ver las repeticiones y comprender las acciones que se produjeron durante las sesiones del navegador. Esta funcionalidad le ayuda a resolver errores y mejorar las futuras invocaciones al proporcionar información detallada sobre el comportamiento del navegador.

La información recopilada durante la reproducción de la sesión incluye:

Requisitos previos para la grabación de sesiones

Para habilitar la grabación de sesiones, necesita:

Configure la función de IAM para la grabación

Para habilitar la grabación de sesiones, necesita una función de ejecución de IAM con permisos para escribir los datos de grabación en Amazon S3 y registrar la actividad en. CloudWatch Para obtener instrucciones detalladas sobre cómo configurar los permisos, consulte Permisos.

La función de ejecución requiere permisos adicionales además de los permisos estándar del navegador:

{
    "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-bucketSustitúyalo por el nombre real de su bucket de Amazon S3.

Paso 1: Crea una herramienta de navegador con grabación

Cree una herramienta de navegador personalizada con la grabación habilitada. Para obtener instrucciones detalladas sobre cómo crear herramientas de navegador, consulte Creación de un AgentCore navegador.

Al crear la herramienta de su navegador, asegúrese de:

Ejemplo de uso del SDK de 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/")

Paso 2: Usa el navegador con capacidad de grabación

Utilice su navegador con capacidad de grabación con cualquier marco de automatización. Todas las interacciones del navegador se registrarán automáticamente. Ejemplo de uso de 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"])

Todas las interacciones durante esta sesión se registrarán automáticamente y se subirán a su bucket de Amazon S3 cuando finalice la sesión.

Paso 3: Supervise las sesiones en directo y reproduzca las grabaciones

La AWS consola proporciona herramientas integrales tanto para la supervisión en tiempo real como para el análisis de las sesiones grabadas.

Monitorización con visualización en directo

Supervise las sesiones del navegador en tiempo real e interactúe con las sesiones activas:

Para acceder a la vista en directo en la consola

La interfaz de visualización en directo proporciona:

Reproducción y análisis de sesiones

Acceda a las grabaciones y análisis detallados de las sesiones a través de la interfaz de reproducción de la consola:

Para acceder a la reproducción de sesiones en la consola

Funciones de análisis de sesiones

La consola proporciona varias herramientas de análisis:

Navega por las grabaciones

Usa estos métodos para navegar por las grabaciones:

Paso 4: Accede a las grabaciones mediante programación

Acceda a la visualización en directo y a la información de grabación mediante programación mediante el AgentCore SDK y las API de Amazon Bedrock para una integración personalizada y un análisis automatizado.

Acceso programático con visualización en directo

Conéctese a las sesiones de navegador en vivo mediante el cliente del navegador y el servidor del visor:

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

Acceso a la grabación programática

Acceda a los datos de grabación directamente desde Amazon S3 para flujos de trabajo de análisis personalizados:

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

Estructura de datos de grabación:

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

Cada sesión crea una carpeta con el identificador de la sesión y los datos de grabación se cargan por partes a medida que avanza la sesión.

Ejemplos programáticos de reproducción de sesiones

Para casos de uso avanzados, puede crear visores de reproducción de sesiones personalizados e integrar los datos de grabación en sus propios flujos de trabajo de análisis.

Los siguientes GitHub ejemplos muestran un visor de reproducción de sesiones independiente y cómo es la experiencia completa del navegador cuando se utiliza la función de reproducción de sesiones del navegador.

Para ver más ejemplos, consulte los ejemplos AgentCore del navegador en. 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