View a markdown version of this page

Inizia a usare AgentCore Browser - Amazon Bedrock AgentCore

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.

Prerequisiti

Prima di iniziare, assicurati di avere:

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:

  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, trova la sessione attiva con lo stato Pronto

  5. 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 > /aws/bedrock-agentcore/browser/

4

File di registrazione

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: