Principes fondamentaux

Les rubriques suivantes montrent comment fonctionne le AgentCore navigateur Amazon Bedrock et comment créer les ressources et gérer les sessions.

Création d'un outil de navigation et démarrage d'une session

Permissions

Pour utiliser le AgentCore navigateur Amazon Bedrock, vous devez disposer des autorisations suivantes dans votre politique 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/*"
        }
    ]
}

Si vous utilisez l'enregistrement de session avec S3, le rôle d'exécution que vous fournissez lors de la création d'un navigateur nécessite les autorisations suivantes :

{
    "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}}"
        }
    }
}

Vous devez également ajouter la politique de confiance suivante au rôle d'exécution :

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

Configuration du navigateur pour les opérations d'API

Exécutez les commandes suivantes pour configurer votre outil de navigateur qui est commun à toutes les opérations d'API du plan de contrôle et du plan de données.

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
)

Gestion des ressources

Le AgentCore navigateur fournit deux types de ressources :

Paramètres réseau

Le AgentCore navigateur prend en charge le mode réseau public. Ce mode permet à l'outil d'accéder aux ressources Internet publiques. Cette option permet l'intégration avec des API et des services externes.

Gestion de session

Les sessions AgentCore du navigateur présentent les caractéristiques suivantes :

Utilisation de sessions isolées

AgentCore Les outils permettent d'isoler chaque session utilisateur afin de garantir une réutilisation sécurisée et cohérente du contexte lors de plusieurs invocations d'outils. L'isolation des sessions est particulièrement importante pour les charges de travail des agents d'IA en raison de leurs modèles d'exécution dynamiques et en plusieurs étapes.

Chaque session d'outil s'exécute dans une microVM dédiée avec des ressources de processeur, de mémoire et de système de fichiers isolées. Cette architecture garantit que l'invocation d'un outil par un utilisateur ne peut pas accéder aux données de la session d'un autre utilisateur. À la fin de la session, la microVM est complètement arrêtée et sa mémoire est nettoyée, éliminant ainsi tout risque de fuite de données entre sessions.