View a markdown version of this page

Menggunakan AgentCore Browser dengan Nova Act - Batuan Dasar Amazon AgentCore

Menggunakan AgentCore Browser dengan Nova Act

Anda dapat membangun agen browser menggunakan Nova Act untuk mengotomatiskan interaksi web:

Langkah 1: Instal dependensi

Buat folder proyek (jika Anda belum melakukannya):

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

Di Windows, gunakan: .venv\Scripts\activate

Instal paket yang diperlukan:

pip install bedrock-agentcore nova-act rich boto3

Paket-paket ini menyediakan:

  • bedrock-agentcore: SDK untuk AgentCore alat Amazon Bedrock termasuk Browser AgentCore

  • nova-act: SDK untuk Nova Act yang mencakup model dan orkestrator untuk otomatisasi browser

  • rich: Perpustakaan untuk teks kaya dan pemformatan yang indah di terminal

  • boto3: AWS SDK untuk Python (Boto3) SDK for Python (Boto3) untuk membuat, mengkonfigurasi, dan mengelola layanan AWS

Langkah 2: Dapatkan Kunci API Nova Act

Arahkan ke halaman Nova Act dan buat kunci API menggunakan kredenal amazon.com Anda. (Perhatikan saat ini hanya berfungsi untuk akun amazon.com yang berbasis di AS)

Buat file bernama nova_act_browser_agent.py dan tambahkan kode berikut:

Tulis agen browser menggunakan Nova Act

Kode Python berikut menunjukkan cara menulis agen browser menggunakan Nova Act. Untuk informasi tentang mendapatkan kunci API untuk Nova Act, lihat dokumentasi 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}")

Langkah 3: Jalankan agen

Jalankan skrip (Ganti dengan kunci API Nova Act Anda di perintah):

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"

Output yang diharapkan

Anda akan melihat respons agen yang berisi rincian kasus penggunaan umum Amazon Bedrock. AgentCore Agen menavigasi situs web, melakukan pencarian, dan mengekstrak informasi yang diminta.

Jika Anda menemukan kesalahan, verifikasi:

  • IAM Anda role/user memiliki izin yang benar

  • Kunci API Nova Act Anda benar

  • AWS Kredensi Anda dikonfigurasi dengan benar

Langkah 4: Lihat sesi browser secara langsung

Saat skrip browser Anda berjalan, Anda dapat melihat sesi secara real-time melalui AWS Konsol:

  1. Buka Konsol AgentCore Browser Amazon Bedrock

  2. Arahkan ke Built-in alat di navigasi kiri

  3. Pilih alat Browser (misalnya,AgentCore Browser Tool, atau browser khusus Anda)

  4. Di bagian sesi Browser, temukan sesi aktif Anda dengan status Siap

  5. Di kolom Live view/recording, klik URL “Lihat sesi langsung” yang disediakan

  6. Tampilan langsung terbuka di jendela browser baru, menampilkan sesi browser waktu nyata

Antarmuka tampilan langsung menyediakan:

  • Real-time aliran video dari sesi browser

  • Kontrol interaktif untuk mengambil alih atau melepaskan kontrol dari otomatisasi

  • Kemampuan untuk mengakhiri sesi