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 di intelligenza artificiale che naviga in un sito Web ed estrae informazioni, in meno di 5 minuti.
Argomenti
Prerequisiti
Prima di iniziare, assicurati di avere:
-
Boto3 installato (documentazione Boto3
) -
AWS credenziali configurate: verifica con:
aws sts get-caller-identitySe questo comando fallisce, consulta Configurazione e impostazioni dei file di credenziali nella documentazione AWS CLI.
-
Accesso al modello Anthropic Claude Sonnet 4.0 abilitato nella console Amazon Bedrock
-
AWS Regione in cui AgentCore è disponibile Amazon Bedrock (vedi AWS Regioni supportate)
Autorizzazioni IAM
Collega 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>Sostituiscilo con la tua AWS regione attuale e <account_id> con l'ID del tuo account AWS .
Fase 1: Installare le dipendenze
pip install bedrock-agentcore strands-agents strands-agents-tools playwright nest-asyncio
Passaggio 2: crea il tuo agente
Crea un file denominatobrowser_agent.py:
Nota
Sostituisci <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: Esegui 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.
Passaggio 4: Visualizza la sessione del browser in diretta
Mentre il tuo agente è in funzione, puoi guardarlo in tempo reale tramite la AWS console:
-
Apri la console AgentCore del browser
-
Vai agli Built-in strumenti nella barra di navigazione a sinistra
-
Seleziona lo strumento Browser (ad esempio
AgentCore Browser Tool, o il tuo browser personalizzato) -
Nella sezione Sessioni del browser, trova la sessione attiva con lo stato Pronto
-
Nella colonna Live view/registrazione, fai clic sull'URL «Visualizza sessione live» fornito
La visualizzazione live fornisce uno streaming video in tempo reale con controlli interattivi per assumere o sbloccare il controllo dell'automazione.
Trova le tue risorse
Dopo aver usato 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 riproduzione delle sessioni |
Browser Console > Nome dello strumento > Visualizza registrazione |
|
3 |
Registri del browser |
CloudWatch> Gruppi di log > |
|
4 |
File di registrazione |
S3 > Il tuo bucket > prefisso |
|
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:
-
Registrazione e riproduzione della sessione: registra e riproduci le sessioni per il debug
-
Utilizzo AgentCore del browser con Nova Act e utilizzo AgentCore del browser con Playwright: utilizza altri framework come Nova Act o Playwright
-
Nozioni di base: scopri le operazioni delle API e i browser personalizzati