Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Registrazione e riproduzione della sessione

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

Session Replay 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 delle sessioni

Per abilitare la registrazione delle sessioni, è 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 le attività su. CloudWatch Per istruzioni dettagliate sulla configurazione delle autorizzazioni, consulta Autorizzazioni. Permissions

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

Sostituiscilo your-recording-bucket 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, vedere Creazione di un AgentCore browser.

Quando crei il tuo strumento per il 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: utilizzare il browser abilitato alla registrazione

Usa il tuo browser abilitato alla registrazione con qualsiasi framework di automazione. Tutte le interazioni del 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 registrate automaticamente e caricate nel bucket Amazon S3 al termine della sessione.

Passaggio 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 modalità live view

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 delle sessioni

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

Per accedere alla riproduzione delle sessioni nella console

Funzionalità di analisi della sessione

La console fornisce diversi strumenti di analisi:

Naviga tra le registrazioni

Utilizzate questi metodi per navigare tra le registrazioni:

Passaggio 4: accedi alle registrazioni in modo programmatico

Accedi a informazioni dettagliate sulla visualizzazione in tempo reale e sulla registrazione in modo programmatico utilizzando l' AgentCore SDK e le API di Amazon Bedrock per l'integrazione personalizzata e l'analisi automatizzata.

Accesso programmatico al live view

Connettiti alle sessioni live del browser utilizzando il client del browser e il server di visualizzazione:

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 programmatico alla registrazione

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 delle sessioni personalizzati e integrare i dati di registrazione nei tuoi flussi di lavoro di analisi.

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

Per ulteriori esempi, consulta Esempi di AgentCore browser su. GitHub