Utilisation AgentCore du navigateur avec Nova Act

Vous pouvez créer un agent de navigateur à l'aide de Nova Act pour automatiser les interactions Web :

Étape 1 : installer les dépendances

Créez un dossier de projet (si ce n'est pas déjà fait) :

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

Installez les packages requis :

pip install bedrock-agentcore nova-act rich boto3

Ces packages fournissent :

Étape 2 : Obtenir la clé d'API Nova Act

Accédez à la page Nova Act et générez une clé API à l'aide de vos informations d'identification amazon.com. (Notez que cela ne fonctionne actuellement que pour les comptes amazon.com basés aux États-Unis)

Créez un fichier nommé nova_act_browser_agent.py et ajoutez le code suivant :

Écrire un agent de navigateur à l'aide de Nova Act

Le code Python suivant montre comment écrire un agent de navigateur à l'aide de Nova Act. Pour plus d'informations sur l'obtention de la clé d'API pour Nova Act, consultez la documentation 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}")

Étape 3 : Exécuter l'agent

Exécutez le script (remplacez-le par votre clé d'API Nova Act dans la commande) :

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"

Résultat attendu

Vous devriez voir la réponse de l'agent contenant des détails sur les cas d'utilisation courants d'Amazon Bedrock. AgentCore L'agent navigue sur le site Web, effectue la recherche et extrait les informations demandées.

Si vous rencontrez des erreurs, vérifiez :

Étape 4 : Afficher la session du navigateur en direct

Pendant que le script de votre navigateur est en cours d'exécution, vous pouvez consulter la session en temps réel via la AWS console :

L'interface de visualisation en direct fournit :