Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Utilisation AgentCore du navigateur avec Nova Act
Vous pouvez créer un agent de navigation à 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
Note
Sous Windows, utilisez : .venv\Scripts\activate
Installez les packages requis :
pip install bedrock-agentcore nova-act rich boto3
Ces packages fournissent :
-
bedrock-agentcore: le SDK pour les AgentCore outils Amazon Bedrock, y compris le navigateur AgentCore -
nova-act: le SDK pour Nova Act qui inclut le modèle et l'orchestrateur pour l'automatisation des navigateurs -
rich: bibliothèque pour du texte enrichi et une mise en forme élégante dans le terminal -
boto3: AWS SDK pour Python (Boto3) pour créer, configurer et gérer des services AWS
Étape 2 : Obtenir la clé d'API Nova Act
Accédez à la page
Créez un fichier nommé nova_act_browser_agent.py et ajoutez le code suivant :
Écrivez un agent de navigation à 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é 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 informations 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 :
-
Votre IAM role/user dispose des autorisations appropriées
-
Votre clé d'API Nova Act est correcte
-
Vos AWS informations d'identification sont correctement configurées
Étape 4 : Afficher la session du navigateur en direct
Pendant l'exécution du script de votre navigateur, vous pouvez consulter la session en temps réel via la AWS console :
-
Ouvrez la console du AgentCore navigateur Amazon Bedrock
-
Accédez aux Built-in outils dans la barre de navigation de gauche
-
Sélectionnez l'outil Navigateur (par exemple
AgentCore Browser Tool, ou votre navigateur personnalisé) -
Dans la section Sessions du navigateur, recherchez votre session active avec le statut Prêt
-
Dans la colonne Affichage en direct/enregistrement, cliquez sur l'URL « Afficher la session en direct » fournie
-
La vue en direct s'ouvre dans une nouvelle fenêtre de navigateur, affichant la session de navigation en temps réel
L'interface de visualisation en direct fournit :
-
Real-time flux vidéo de la session du navigateur
-
Commandes interactives pour prendre le contrôle de l'automatisation ou la libérer
-
Possibilité de mettre fin à la session