View a markdown version of this page

Uso AgentCore del navegador con Nova Act - Amazon Bedrock AgentCore

Uso AgentCore del navegador con Nova Act

Puede crear un agente de navegador con Nova Act para automatizar las interacciones web:

Paso 1: Instalar las dependencias

Cree una carpeta de proyecto (si aún no lo ha hecho):

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

En Windows, utilice: .venv\Scripts\activate

Instale los paquetes obligatorios:

pip install bedrock-agentcore nova-act rich boto3

Estos paquetes proporcionan:

  • bedrock-agentcore: El SDK para las AgentCore herramientas de Amazon Bedrock, incluido AgentCore el navegador

  • nova-act: El SDK de Nova Act, que incluye el modelo y el orquestador para la automatización del navegador

  • rich: Biblioteca para textos enriquecidos y un bonito formato en el terminal

  • boto3: AWS SDK para Python (Boto3) para crear, configurar y administrar servicios AWS

Paso 2: Obtenga la clave de API de Nova Act

Ve a la página de Nova Act y genera una clave de API con tus credenciales de amazon.com. (Ten en cuenta que, actualmente, esto solo funciona para las cuentas de amazon.com con sede en EE. UU.)

Crea un archivo con el nombre nova_act_browser_agent.py y añade el siguiente código:

Escribe un agente de navegador usando Nova Act

El siguiente código de Python muestra cómo escribir un agente de navegador con Nova Act. Para obtener información sobre cómo obtener la clave de API para Nova Act, consulte la documentación de 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}")

Paso 3: Ejecute el agente

Ejecute el script (sustitúyalo por su clave de API de Nova Act en el 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"

Resultado esperado

Deberías ver la respuesta del agente con detalles de los casos de uso más comunes de Amazon Bedrock. AgentCore El agente navega por el sitio web, realiza la búsqueda y extrae la información solicitada.

Si encuentra errores, compruebe lo siguiente:

  • Su IAM role/user tiene los permisos correctos

  • Su clave de API de Nova Act es correcta

  • Sus AWS credenciales están configuradas correctamente

Paso 4: Ver la sesión del navegador en directo

Mientras se ejecuta el script del navegador, puede ver la sesión en tiempo real a través de la AWS consola:

  1. Abra la consola del AgentCore navegador Amazon Bedrock

  2. Navegue hasta Built-in las herramientas en el menú de navegación de la izquierda

  3. Selecciona la herramienta del navegador (por ejemploAgentCore Browser Tool, o tu navegador personalizado)

  4. En la sección Sesiones del navegador, busque su sesión activa con el estado Listo

  5. En la columna Visualización en directo/grabación, haz clic en la URL proporcionada para «Ver sesión en directo»

  6. La vista en directo se abre en una nueva ventana del navegador y muestra la sesión del navegador en tiempo real

La interfaz de visualización en directo proporciona:

  • Real-time transmisión de vídeo de la sesión del navegador

  • Controles interactivos para asumir o liberar el control de la automatización

  • Posibilidad de finalizar la sesión