Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Grabación y reproducción de sesiones

La grabación y reproducción de las sesiones en el navegador proporcionan una capacidad de observación 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 que haya especificado para su posterior análisis.

La reproducción de sesiones captura datos exhaustivos sobre las interacciones con el navegador, lo que le permite ver las repeticiones y comprender las acciones que se produjeron durante las sesiones del navegador. Esta funcionalidad te ayuda a resolver errores y a mejorar las invocaciones futuras, ya que proporciona 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 un rol de ejecución de IAM con permisos para escribir los datos de grabación en Amazon S3 y registrar en él la actividad. CloudWatch Para obtener instrucciones detalladas sobre la configuración de 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": "*"
}

Sustituya your-recording-bucket por el nombre real del bucket de Amazon S3.

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

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

Al crear la herramienta de navegación, 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

Use 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 completas tanto para la supervisión en tiempo real como para el análisis de las sesiones grabadas.

Monitoreo de visualización en vivo

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

Para acceder a la visualización en directo en la consola

La interfaz de visualización en vivo 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 la sesión en la consola

Funciones de análisis de sesiones

La consola proporciona varias herramientas de análisis:

Navegue por las grabaciones

Utilice estos métodos para navegar por las grabaciones:

Paso 4: Acceda a las grabaciones mediante programación

Acceda a la visualización en directo y a la grabación de informació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 a la visualización en vivo

Conéctese a las sesiones de navegador en tiempo real mediante el cliente del navegador y el servidor de visualización:

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 en fragmentos 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 Ejemplos de AgentCore navegadores en. GitHub