View a markdown version of this page

Utilisation AgentCore du navigateur avec Nova Act - Base rocheuse de l'Amazonie AgentCore

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

É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 :

  1. Ouvrez la console du AgentCore navigateur Amazon Bedrock

  2. Accédez aux Built-in outils dans la barre de navigation de gauche

  3. Sélectionnez l'outil Navigateur (par exempleAgentCore Browser Tool, ou votre navigateur personnalisé)

  4. Dans la section Sessions du navigateur, recherchez votre session active avec le statut Prêt

  5. Dans la colonne Affichage en direct/enregistrement, cliquez sur l'URL « Afficher la session en direct » fournie

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