View a markdown version of this page

Utilizzo AgentCore del browser con Nova Act - Amazon Bedrock AgentCore

Utilizzo AgentCore del browser con Nova Act

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

Passaggio 1: installare le dipendenze

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

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

In 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 di Amazon Bedrock, incluso Browser AgentCore

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

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

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

Passaggio 2: ottieni la chiave API Nova Act

Vai alla pagina Nova Act e genera una chiave API utilizzando le tue credenziali 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 seguente codice:

Scrivi un browser agent usando Nova Act

Il seguente codice Python mostra come scrivere un browser agent 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"

Output previsto

Dovresti vedere la risposta dell'agente contenente i dettagli dei casi d'uso comuni di Amazon AgentCore Bedrock. 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

Passaggio 4: Visualizza la sessione del browser in diretta

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

  6. La visualizzazione dal vivo 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 liberare il controllo dall'automazione

  • Possibilità di terminare la sessione