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.
Argomenti
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-identitySe 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:
-
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, individua la sessione attiva con lo stato Pronto
-
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 > |
|
4 |
Registrazione di file |
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 delle sessioni: registrazione e riproduzione delle sessioni per il debugging
-
Utilizzo di AgentCore Browser con Nova Act e Utilizzo di AgentCore Browser con Playwright: utilizza altri framework come Nova Act o Playwright
-
Nozioni fondamentali: scopri le operazioni API e i browser personalizzati