Memulai dengan AgentCore Browser
AgentCore Browser memungkinkan agen Anda berinteraksi dengan halaman web melalui browser Chrome yang dikelola. Dalam panduan ini, Anda akan membuat agen AI yang menavigasi situs web dan mengekstrak informasi - dalam waktu kurang dari 5 menit.
Topik
Prasyarat
Sebelum Anda mulai, pastikan Anda memiliki:
-
Boto3 diinstal (dokumentasi Boto3
) -
AWS kredensi dikonfigurasi - verifikasi dengan:
aws sts get-caller-identityJika perintah ini gagal, lihat Konfigurasi dan pengaturan file kredensi dalam dokumentasi AWS CLI.
-
Akses model Anthropic Claude Sonnet 4.0 diaktifkan di konsol Amazon Bedrock
-
AWS Wilayah tempat Amazon Bedrock AgentCore tersedia (lihat AWS Wilayah yang Didukung)
Izin IAM
Lampirkan kebijakan ini ke identitas IAM Anda. Di Konsol IAM, temukan pengguna atau peran Anda, pilih Tambahkan izin > Buat kebijakan sebaris, alihkan ke tampilan JSON, dan tempel:
{ "Version":"2012-10-17", "Statement": [ { "Sid": "BedrockAgentCoreBrowserFullAccess", "Effect": "Allow", "Action": [ "bedrock-agentcore:CreateBrowser", "bedrock-agentcore:ListBrowsers", "bedrock-agentcore:GetBrowser", "bedrock-agentcore:DeleteBrowser", "bedrock-agentcore:StartBrowserSession", "bedrock-agentcore:ListBrowserSessions", "bedrock-agentcore:GetBrowserSession", "bedrock-agentcore:StopBrowserSession", "bedrock-agentcore:UpdateBrowserStream", "bedrock-agentcore:ConnectBrowserAutomationStream", "bedrock-agentcore:ConnectBrowserLiveViewStream" ], "Resource": "arn:aws:bedrock-agentcore:<Region>:++<account_id>++:browser/*" }, { "Sid": "BedrockModelAccess", "Effect": "Allow", "Action": [ "bedrock:InvokeModel", "bedrock:InvokeModelWithResponseStream" ], "Resource": [ "*" ] } ] }
catatan
Ganti <Region> dengan AWS Wilayah Anda yang sebenarnya dan <account_id> dengan ID AWS akun Anda.
Langkah 1: Instal dependensi
pip install bedrock-agentcore strands-agents strands-agents-tools playwright nest-asyncio
Langkah 2: Buat agen Anda
Buat file bernamabrowser_agent.py:
catatan
Ganti <Region> dengan AWS Wilayah Anda (misalnya,us-west-2).
from strands import Agent from strands_tools.browser import AgentCoreBrowser # Initialize the Browser tool browser_tool = AgentCoreBrowser(region="<Region>") # Create an agent with the Browser tool agent = Agent(tools=[browser_tool.browser]) # Test the agent with a web search prompt prompt = "what are the services offered by Bedrock AgentCore? Use the documentation link if needed: https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/what-is-bedrock-agentcore.html" print(f"\n\nPrompt: {prompt}\n\n") response = agent(prompt) print("\n\nAgent Response:") print(response.message["content"][0]["text"])
Langkah 3: Jalankan agen
python browser_agent.py
Anda harus melihat agen menavigasi situs web dan mengembalikan detail tentang AgentCore layanan. Jika Anda mengalami kesalahan, verifikasi izin IAM, akses model, dan AWS kredensialnya.
Langkah 4: Lihat sesi browser secara langsung
Saat agen Anda berjalan, Anda dapat menontonnya secara real-time melalui AWS Konsol:
-
Arahkan ke Built-in alat di navigasi kiri
-
Pilih alat Browser (misalnya,
AgentCore Browser Tool, atau browser khusus Anda) -
Di bagian sesi Browser, temukan sesi aktif Anda dengan status Siap
-
Di kolom Live view/recording, klik URL “Lihat sesi langsung” yang disediakan
Tampilan langsung menyediakan streaming video real-time dengan kontrol interaktif untuk mengambil alih atau melepaskan kontrol dari otomatisasi.
Temukan sumber daya Anda
Setelah menggunakan AgentCore Browser, lihat sumber daya Anda di AWS Konsol:
| # | Sumber daya | Lokasi |
|---|---|---|
|
1 |
Tampilan Langsung |
Konsol Browser > Nama Alat > Lihat sesi langsung |
|
2 |
Rekaman Sesi dan Putar Ulang |
Konsol Browser > Nama Alat > Lihat rekaman |
|
3 |
Log Browser |
CloudWatch> Grup log > |
|
4 |
Merekam File |
S3 > Ember Anda> awalan |
|
5 |
Kustom Browser |
AgentCore Konsol > Built-in alat > Browser khusus Anda |
|
6 |
Peran IAM |
IAM > Peran > Cari peran eksekusi Anda |
Langkah selanjutnya
Sekarang setelah AgentCore Browser berfungsi, jelajahi fitur-fitur canggih ini:
-
Perekaman Sesi dan Putar Ulang - Rekam dan putar ulang sesi untuk debugging
-
Menggunakan AgentCore Browser dengan Nova Act dan Menggunakan AgentCore Browser dengan Playwright - Gunakan kerangka kerja lain seperti Nova Act atau Playwright
-
Dasar-dasar - Pelajari tentang operasi API dan browser khusus