View a markdown version of this page

Inizia a usare AgentCore Browser - Fondamento Amazon AgentCore

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

Inizia a usare AgentCore Browser

AgentCore Il browser consente ai tuoi agenti di interagire con le pagine Web tramite un browser Chrome gestito. In questa guida, creerai un agente AI che naviga in un sito Web ed estrae informazioni, in meno di 5 minuti.

Prerequisiti

Prima di iniziare, assicurati di avere:

  • Python 3.10 o versioni successive (python. org/downloads)

  • Boto3 installato (documentazione Boto3)

  • AWS credenziali configurate: verifica con:

    aws sts get-caller-identity

    Se questo comando ha esito negativo, vedi Configurazione e impostazioni dei file di credenziali nella documentazione della AWS CLI.

  • Accesso al modello Anthropic Claude Sonnet 4.0 abilitato nella console Amazon Bedrock

  • AWS Regione in cui è disponibile Amazon Bedrock (vedi AgentCore Regioni supportate) AWS

Autorizzazioni IAM

Allega questa policy alla tua identità IAM. Nella console IAM, trova il tuo utente o ruolo, scegli Aggiungi autorizzazioni > Crea policy in linea, passa alla visualizzazione JSON e incolla:

{ "Version":"2012-10-17", "Statement": [ { "Sid": "BedrockAgentCoreBrowserFullAccess", "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:<Region>:++<account_id>++:browser/*" }, { "Sid": "BedrockModelAccess", "Effect": "Allow", "Action": [ "bedrock:InvokeModel", "bedrock:InvokeModelWithResponseStream" ], "Resource": [ "*" ] } ] }
Nota

<Region>Sostituiscila con la tua AWS regione attuale e <account_id> con l'ID del tuo account AWS .

Fase 1: Installa le dipendenze

pip install bedrock-agentcore strands-agents strands-agents-tools playwright nest-asyncio

Fase 2: Crea il tuo agente

Crea un file chiamatobrowser_agent.py:

Nota

Sostituiscilo <Region> con la tua AWS regione (ad esempio,us-west-2).

from strands import Agent from strands_tools.browser import AgentCoreBrowser # Initialize the Browser tool browser_tool = AgentCoreBrowser(region="<Region>") # Create an agent with the Browser tool agent = Agent(tools=[browser_tool.browser]) # Test the agent with a web search prompt prompt = "what are the services offered by Bedrock AgentCore? Use the documentation link if needed: https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/what-is-bedrock-agentcore.html" print(f"\n\nPrompt: {prompt}\n\n") response = agent(prompt) print("\n\nAgent Response:") print(response.message["content"][0]["text"])

Fase 3: Avviare l'agente

python browser_agent.py

Dovresti vedere l'agente navigare nel sito Web e restituire i dettagli sui AgentCore servizi. Se riscontri errori, verifica le autorizzazioni IAM, l'accesso al modello e AWS le credenziali.

Fase 4: Visualizza la sessione del browser in tempo reale

Mentre il tuo agente è in funzione, puoi guardarla in tempo reale tramite la AWS Console:

  1. Apri la console AgentCore del browser

  2. Vai agli Built-in strumenti nella barra di navigazione a sinistra

  3. Seleziona lo strumento Browser (ad esempioAgentCore Browser Tool, o il tuo browser personalizzato)

  4. Nella sezione Sessioni del browser, individua la sessione attiva con lo stato Pronto

  5. Nella colonna Visualizzazione/registrazione dal vivo, fai clic sull'URL «Visualizza sessione live» fornito

La visualizzazione live fornisce un flusso video in tempo reale con controlli interattivi per assumere o rilasciare il controllo dall'automazione.

Trova le tue risorse

Dopo aver utilizzato AgentCore Browser, visualizza le tue risorse nella AWS console:

# Risorsa Location (Ubicazione)

1

Visualizzazione dal vivo

Console del browser > Nome dello strumento > Visualizza sessione live

2

Registrazioni e replay delle sessioni

Console del browser > Nome dello strumento > Visualizza registrazione

3

Registri del browser

CloudWatch> Gruppi di log > /aws/bedrock-agentcore/browser/

4

Registrazione di file

S3 > Il tuo bucket > prefisso browser-recordings/

5

Browser personalizzati

AgentCore Console > Built-in strumenti > Il tuo browser personalizzato

6

Ruoli IAM

IAM > Ruoli > Cerca il tuo ruolo di esecuzione

Fasi successive

Ora che AgentCore Browser funziona, esplora queste funzionalità avanzate: