Registrazione e riproduzione della sessione

La registrazione e la riproduzione delle sessioni del browser offrono un'osservabilità completa per scopi di debug, controllo o formazione. Quando crei un browser con la registrazione della sessione abilitata, Amazon Bedrock acquisisce AgentCore automaticamente le interazioni del browser e le archivia nel bucket Amazon S3 specificato per analisi successive.

La riproduzione della sessione acquisisce dati completi sulle interazioni del browser che consentono di visualizzare i replay e comprendere le azioni che si sono verificate durante le sessioni del browser. Questa funzionalità consente di risolvere gli errori e migliorare le chiamate future fornendo informazioni dettagliate sul comportamento del browser.

Le informazioni raccolte durante la riproduzione della sessione includono:

Prerequisiti per la registrazione della sessione

Per abilitare la registrazione della sessione, è necessario:

Configura il ruolo IAM per la registrazione

Per abilitare la registrazione delle sessioni, è necessario un ruolo di esecuzione IAM con autorizzazioni per scrivere i dati di registrazione su Amazon S3 e registrare l'attività. CloudWatch Per istruzioni dettagliate sulla configurazione delle autorizzazioni, consulta Autorizzazioni.

Il ruolo di esecuzione richiede autorizzazioni aggiuntive oltre alle autorizzazioni standard del browser:

{
    "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-bucketSostituiscilo con il nome effettivo del bucket Amazon S3.

Passaggio 1: crea uno strumento browser con registrazione

Crea uno strumento browser personalizzato con la registrazione abilitata. Per istruzioni dettagliate sulla creazione degli strumenti del browser, consultate Creazione di un AgentCore browser.

Quando crei lo strumento del tuo browser, assicurati di:

Esempio di utilizzo di 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/")

Passaggio 2: utilizza il browser abilitato alla registrazione

Usa il tuo browser abilitato alla registrazione con qualsiasi framework di automazione. Tutte le interazioni con il browser verranno registrate automaticamente. Esempio di utilizzo di 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"])

Tutte le interazioni durante questa sessione verranno automaticamente registrate e caricate nel tuo bucket Amazon S3 al termine della sessione.

Fase 3: Monitora le sessioni live e riproduci le registrazioni

La AWS console fornisce strumenti completi sia per il monitoraggio in tempo reale che per l'analisi delle sessioni registrate.

Monitoraggio in diretta

Monitora le sessioni del browser in tempo reale e interagisci con le sessioni attive:

Per accedere alla visualizzazione live nella console

L'interfaccia live view fornisce:

Riproduzione e analisi della sessione

Accedi alle registrazioni e alle analisi dettagliate delle sessioni tramite l'interfaccia di riproduzione della console:

Per accedere alla riproduzione della sessione nella console

Funzionalità di analisi della sessione

La console offre diversi strumenti di analisi:

Naviga tra le registrazioni

Usa questi metodi per navigare tra le registrazioni:

Passaggio 4: Accedi alle registrazioni a livello di codice

Accedi alle informazioni di visualizzazione dal vivo e registrazione in modo programmatico utilizzando l' AgentCore SDK e le API di Amazon Bedrock per l'integrazione personalizzata e l'analisi automatizzata.

Accesso programmatico alla visualizzazione live

Connect alle sessioni live del browser utilizzando il client del browser e il server del visualizzatore:

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

Accesso alla registrazione programmatica

Accedi ai dati di registrazione direttamente da Amazon S3 per flussi di lavoro di analisi personalizzati:

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

Struttura dei dati di registrazione:

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

Ogni sessione crea una cartella con l'ID della sessione e i dati di registrazione vengono caricati in blocchi man mano che la sessione procede.

Esempi programmatici di riproduzione delle sessioni

Per casi d'uso avanzati, puoi creare visualizzatori di replay di sessione personalizzati e integrare i dati di registrazione nei tuoi flussi di lavoro di analisi.

GitHub Gli esempi seguenti mostrano un visualizzatore di replay delle sessioni autonomo e come si presenta l'esperienza completa del browser quando si utilizza la funzione di riproduzione delle sessioni del browser.

Per ulteriori esempi, consultate AgentCore Browser examples on. 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