View a markdown version of this page

Uso AgentCore del navegador con Nova Act - Base amazónica AgentCore

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

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

Crea una carpeta de proyecto (si aún no lo has hecho):

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

En Windows, usa: .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 el navegador AgentCore

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

  • rich: Biblioteca para texto enriquecido y formatos atractivos en la terminal

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

Paso 2: Obtenga la clave de API de Nova Act

Navegue hasta la página de Nova Act y genere una clave de API con sus credenciales de amazon.com. (Tenga 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 agrega el siguiente código:

Escriba un agente de navegador con 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"

Salida esperada

Debería ver la respuesta del agente con detalles de los casos de uso 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:

  • Tu 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 vivo

Mientras se ejecuta el script de su 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 de la barra de navegación de la izquierda

  3. Seleccione la herramienta del navegador (por ejemploAgentCore Browser Tool, o su navegador personalizado)

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

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

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

La interfaz de visualización en vivo proporciona:

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

  • Controles interactivos para tomar el control de la automatización o liberarla

  • Posibilidad de terminar la sesión