Nozioni fondamentali

I seguenti argomenti mostrano come funziona Amazon Bedrock AgentCore Browser e come creare le risorse e gestire le sessioni.

Creazione di uno strumento Browser e avvio di una sessione

Permissions

Per utilizzare il AgentCore browser Amazon Bedrock, sono necessarie le seguenti autorizzazioni nella tua policy IAM:

{
"Version":"2012-10-17",
    "Statement": [
        {
            "Sid": "BedrockAgentCoreInBuiltToolsFullAccess",
            "Effect": "Allow",
            "Action": [
                "bedrock-agentcore:CreateBrowser",
                "bedrock-agentcore:ListBrowsers",
                "bedrock-agentcore:GetBrowser",
                "bedrock-agentcore:DeleteBrowser",
                "bedrock-agentcore:StartBrowserSession",
                "bedrock-agentcore:ListBrowserSessions",
                "bedrock-agentcore:GetBrowserSession",
                "bedrock-agentcore:StopBrowserSession",
                "bedrock-agentcore:UpdateBrowserStream",
                "bedrock-agentcore:ConnectBrowserAutomationStream",
                "bedrock-agentcore:ConnectBrowserLiveViewStream"
            ],
            "Resource": "arn:aws:bedrock-agentcore:us-east-1:111122223333:browser/*"
        }
    ]
}

Se utilizzi la registrazione di sessioni con S3, il ruolo di esecuzione che fornisci durante la creazione di un browser richiede le seguenti autorizzazioni:

{
    "Sid": "BedrockAgentCoreBuiltInToolsS3Policy",
    "Effect": "Allow",
    "Action": [
        "s3:PutObject",
        "s3:ListMultipartUploadParts",
        "s3:AbortMultipartUpload"
    ],
    "Resource": "arn:aws:s3:::example-s3-bucket/example-prefix/*",
    "Condition": {
        "StringEquals": {
            "aws:ResourceAccount": "{{accountId}}"
        }
    }
}

Dovresti anche aggiungere la seguente politica di fiducia al ruolo di esecuzione:

{
"Version":"2012-10-17",
    "Statement": [{
        "Sid": "BedrockAgentCoreBuiltInTools",
        "Effect": "Allow",
        "Principal": {
            "Service": "bedrock-agentcore.amazonaws.com"
        },
        "Action": "sts:AssumeRole",
        "Condition": {
            "StringEquals": {
                "aws:SourceAccount": "111122223333"
            },
            "ArnLike": {
                "aws:SourceArn": "arn:aws:bedrock-agentcore:us-east-1:111122223333:*"
            }
        }
    }]
}

Configurazione del browser per le operazioni API

Esegui i seguenti comandi per configurare lo strumento Browser, comune a tutte le operazioni API del piano di controllo e del piano dati.

import boto3
import uuid

REGION = "<Region>"
CP_ENDPOINT_URL = f"https://bedrock-agentcore-control.{REGION}.amazonaws.com"
DP_ENDPOINT_URL = f"https://bedrock-agentcore.{REGION}.amazonaws.com"

cp_client = boto3.client(
    'bedrock-agentcore-control',
    region_name=REGION,
    endpoint_url=CP_ENDPOINT_URL
)

dp_client = boto3.client(
    'bedrock-agentcore',
    region_name=REGION,
    endpoint_url=DP_ENDPOINT_URL
)

Gestione delle risorse

Il AgentCore browser fornisce due tipi di risorse:

Impostazioni di rete

Il AgentCore browser supporta la modalità di rete pubblica. Questa modalità consente allo strumento di accedere alle risorse Internet pubbliche. Questa opzione consente l'integrazione con API e servizi esterni.

Gestione della sessione

Le sessioni AgentCore del browser hanno le seguenti caratteristiche:

Utilizzo di sessioni isolate

AgentCore Gli strumenti consentono l'isolamento di ogni sessione utente per garantire un riutilizzo sicuro e coerente del contesto tra più chiamate dello strumento. L'isolamento delle sessioni è particolarmente importante per i carichi di lavoro degli agenti AI grazie ai loro modelli di esecuzione dinamici e in più fasi.

Ogni sessione dello strumento viene eseguita in una microVM dedicata con risorse isolate di CPU, memoria e file system. Questa architettura garantisce che la chiamata allo strumento di un utente non possa accedere ai dati della sessione di un altro utente. Al termine della sessione, la MicroVM viene completamente interrotta e la sua memoria viene disinfettata, eliminando così ogni rischio di perdita di dati tra sessioni.