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à.

Fondamenti

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

Creazione di uno strumento browser e avvio di una sessione

Permissions

Per utilizzare Amazon Bedrock AgentCore Browser, hai bisogno delle 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 delle 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}}"
        }
    }
}

È inoltre necessario 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

Eseguite i seguenti comandi per configurare il Browser Tool, che è 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 su più invocazioni di strumenti. L'isolamento delle sessioni è particolarmente importante per i carichi di lavoro degli agenti di intelligenza artificiale grazie ai loro modelli di esecuzione dinamici e in più fasi.

Ogni sessione dello strumento viene eseguita in una microVM dedicata con CPU, memoria e risorse di file system isolate. Questa architettura garantisce che l'invocazione dello strumento da parte di un utente non possa accedere ai dati della sessione di un altro utente. Al termine della sessione, la microVM viene terminata completamente e la sua memoria viene disinfettata, eliminando così qualsiasi rischio di perdita di dati tra sessioni.