View a markdown version of this page

Utilizzo AgentCore del browser con Nova Act - 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à.

Utilizzo AgentCore del browser con Nova Act

Puoi creare un browser agent utilizzando Nova Act per automatizzare le interazioni web:

Fase 1: Installare le dipendenze

Crea una cartella del progetto (se non l'hai già fatto):

mkdir agentcore-browser-quickstart cd agentcore-browser-quickstart python3 -m venv .venv source .venv/bin/activate
Nota

Su Windows, usa: .venv\Scripts\activate

Installa i pacchetti richiesti:

pip install bedrock-agentcore nova-act rich boto3

Questi pacchetti forniscono:

  • bedrock-agentcore: L'SDK per gli AgentCore strumenti Amazon Bedrock, incluso Browser AgentCore

  • nova-act: L'SDK per Nova Act che include il modello e l'orchestrator per l'automazione dei browser

  • rich: Libreria per testo ricco e bella formattazione nel terminale

  • boto3: AWS SDK per Python (Boto3) per creare, configurare e gestire servizi AWS

Fase 2: Ottieni la chiave API Nova Act

Accedi alla pagina Nova Act e genera una chiave API utilizzando le tue credenziali di amazon.com. (Nota che attualmente funziona solo per gli account amazon.com con sede negli Stati Uniti)

Crea un file denominato nova_act_browser_agent.py e aggiungi il codice seguente:

Scrivi un agente del browser usando Nova Act

Il seguente codice Python mostra come scrivere un agente browser usando Nova Act. Per informazioni su come ottenere la chiave API per Nova Act, consulta la documentazione di Amazon Nova Act.

from bedrock_agentcore.tools.browser_client import browser_session from nova_act import NovaAct from rich.console import Console import argparse import json import boto3 console = Console() from boto3.session import Session boto_session = Session() region = boto_session.region_name print("using region", region) def browser_with_nova_act(prompt, starting_page, nova_act_key, region="us-west-2"): result = None with browser_session(region) as client: ws_url, headers = client.generate_ws_headers() try: with NovaAct( cdp_endpoint_url=ws_url, cdp_headers=headers, nova_act_api_key=nova_act_key, starting_page=starting_page, ) as nova_act: result = nova_act.act(prompt) except Exception as e: console.print(f"NovaAct error: {e}") finally: return result if __name__ == "__main__": parser = argparse.ArgumentParser() parser.add_argument("--prompt", required=True, help="Browser Search instruction") parser.add_argument("--starting-page", required=True, help="Starting URL") parser.add_argument("--nova-act-key", required=True, help="Nova Act API key") parser.add_argument("--region", default="us-west-2", help="AWS region") args = parser.parse_args() result = browser_with_nova_act( args.prompt, args.starting_page, args.nova_act_key, args.region ) console.print(f"\n[cyan] Response[/cyan] {result.response}") console.print(f"\n[bold green]Nova Act Result:[/bold green] {result}")

Fase 3: Esegui l'agente

Esegui lo script (sostituiscilo con la tua chiave API Nova Act nel comando):

python nova_act_browser_agent.py --prompt "What are the common usecases of Bedrock AgentCore?" --starting-page "https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/what-is-bedrock-agentcore.html" --nova-act-key "your-nova-act-API-key"

Risultato previsto

Dovresti vedere la risposta dell'agente contenente i dettagli dei casi d'uso più comuni di Amazon Bedrock. AgentCore L'agente naviga nel sito Web, esegue la ricerca ed estrae le informazioni richieste.

Se riscontri errori, verifica:

  • Il tuo IAM role/user dispone delle autorizzazioni corrette

  • La tua chiave API Nova Act è corretta

  • AWS Le tue credenziali sono configurate correttamente

Fase 4: Visualizza la sessione del browser in tempo reale

Mentre lo script del browser è in esecuzione, puoi visualizzare la sessione in tempo reale tramite la AWS Console:

  1. Apri la console del AgentCore browser Amazon Bedrock

  2. Accedi 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

  6. La visualizzazione live si apre in una nuova finestra del browser, che mostra la sessione del browser in tempo reale

L'interfaccia live view fornisce:

  • Real-time flusso video della sessione del browser

  • Controlli interattivi per assumere o rilasciare il controllo dall'automazione

  • Possibilità di terminare la sessione