View a markdown version of this page

Menggunakan Alat Browser - Batuan Dasar Amazon AgentCore

Menggunakan Alat Browser

Membuat AgentCore Browser

Anda dapat membuat Alat Browser menggunakan AgentCore konsol Amazon Bedrock, AWS CLI, AWS atau SDK.

contoh
Console
  1. Untuk membuat Alat Browser menggunakan konsol

  2. Buka AgentCore konsol di https://console.aws.amazon.com/bedrock-agentcore/home#.

  3. Di panel navigasi, pilih Built-in alat.

  4. Pilih Buat alat browser.

  5. Berikan nama Alat yang unik dan Deskripsi opsional.

  6. Di bawah Pengaturan jaringan, pilih Jaringan publik yang memungkinkan akses ke sumber daya internet publik.

  7. Di bawah Perekaman sesi, Anda dapat mengaktifkan perekaman sesi browser ke bucket S3 untuk ditinjau nanti.

  8. Di bawah Izin, tentukan peran eksekusi IAM yang menentukan AWS sumber daya apa yang dapat diakses Alat Browser.

  9. Pilih Buat.

AWS CLI
  1. Untuk membuat Alat Browser menggunakan AWS CLI, gunakan perintah: create-browser

    aws bedrock-agentcore-control create-browser \ --region <Region> \ --name "my-browser" \ --description "My browser for web interaction" \ --network-configuration '{ "networkMode": "PUBLIC" }' \ --recording '{ "enabled": true, "s3Location": { "bucket": "my-bucket-name", "prefix": "sessionreplay" } }' \ --execution-role-arn "arn:aws:iam::123456789012:role/my-execution-role"
Boto3
  1. Untuk membuat Browser Tool menggunakan AWS SDK for Python (Boto3), gunakan metode: create_browser

    Permintaan Sintaks

    Berikut ini menunjukkan sintaks permintaan:

    response = cp_client.create_browser( name="my_custom_browser", description="Test browser for development", networkConfiguration={ "networkMode": "PUBLIC" }, executionRoleArn="arn:aws:iam::123456789012:role/Sessionreplay", clientToken=str(uuid.uuid4()), recording={ "enabled": True, "s3Location": { "bucket": "session-record-123456789012", "prefix": "replay-data" } } )
API
  1. Untuk membuat instance browser baru menggunakan API, gunakan panggilan berikut:

    # Using awscurl awscurl -X PUT \ "https://bedrock-agentcore-control.<Region>.amazonaws.com/browsers" \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ --service bedrock-agentcore \ --region <Region> \ -d '{ "name": "test_browser_1", "description": "Test sandbox for development", "networkConfiguration": { "networkMode": "PUBLIC" }, "recording": { "enabled": true, "s3Location": { "bucket": "<your-bucket-name>", "prefix": "sessionreplay" } }, "executionRoleArn": "arn:aws:iam::123456789012:role/my-execution-role" }'

Dapatkan alat AgentCore Browser

Anda bisa mendapatkan informasi tentang alat Browser di akun Anda dan melihat detail, status, dan konfigurasinya.

contoh
Console
  1. Untuk mendapatkan informasi tentang alat Browser menggunakan konsol

  2. Buka AgentCore konsol di https://console.aws.amazon.com/bedrock-agentcore/home#.

  3. Di panel navigasi, pilih Built-in alat.

  4. Alat browser tercantum di bagian Alat Browser.

  5. Anda dapat memilih alat yang Anda buat untuk melihat detailnya seperti nama, ID, status, dan tanggal pembuatan untuk setiap alat browser.

AWS CLI
  1. Untuk mendapatkan informasi tentang alat Browser menggunakan AWS CLI, gunakan perintah: get-browser

    aws bedrock-agentcore-control get-browser \ --region <Region> \ --browser-id "<your-browser-id>"
Boto3
  1. Untuk mendapatkan informasi tentang alat Browser menggunakan AWS SDK for Python (Boto3), gunakan metode: get_browser

    Permintaan Sintaks

    Berikut ini menunjukkan sintaks permintaan:

    response = cp_client.get_browser( browserId="<your-browser-id>" )
API
  1. Untuk mendapatkan alat browser menggunakan API, gunakan panggilan berikut:

    # Using awscurl awscurl -X GET \ "https://bedrock-agentcore-control.<Region>.amazonaws.com/browsers/<your-browser-id>" \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ --service bedrock-agentcore \ --region <Region>

Daftar alat AgentCore Browser

Anda dapat mencantumkan semua alat browser di akun Anda untuk melihat detail, status, dan konfigurasinya.

contoh
Console
  1. Untuk membuat daftar alat browser menggunakan konsol

  2. Buka AgentCore konsol di https://console.aws.amazon.com/bedrock-agentcore/home#.

  3. Di panel navigasi, pilih Built-in alat.

  4. Alat browser tercantum di bagian Alat Browser.

  5. Anda dapat melihat detail seperti nama, ID, status, dan tanggal pembuatan untuk setiap alat browser.

AWS CLI
  1. Untuk membuat daftar alat browser menggunakan AWS CLI, gunakan perintah: list-browsers

    aws bedrock-agentcore-control list-browsers \ --region <Region>

    Anda dapat memfilter hasil berdasarkan jenis:

    aws bedrock-agentcore-control list-browsers \ --region <Region> \ --type SYSTEM

    Anda juga dapat membatasi jumlah hasil dan menggunakan pagination:

    aws bedrock-agentcore-control list-browsers \ --region <Region> \ --max-results 10 \ --next-token "<your-pagination-token>"
Boto3
  1. Untuk membuat daftar alat browser menggunakan AWS SDK for Python (Boto3), gunakan metode: list_browsers

    Permintaan Sintaks

    Berikut ini menunjukkan sintaks permintaan:

    response = cp_client.list_browsers(type="CUSTOM")
API
  1. Untuk membuat daftar alat browser menggunakan API, gunakan panggilan berikut:

    # Using awscurl awscurl -X POST \ "https://bedrock-agentcore-control.<Region>.amazonaws.com/browsers" \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ --service bedrock-agentcore \ --region <Region>

    Anda dapat memfilter hasil berdasarkan jenis:

    awscurl -X POST \ "https://bedrock-agentcore-control.<Region>.amazonaws.com/browsers?type=SYSTEM" \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ --service bedrock-agentcore \ --region <Region>

    Anda juga dapat membatasi jumlah hasil dan menggunakan pagination:

    awscurl -X POST \ "https://bedrock-agentcore-control.<Region>.amazonaws.com/browsers?maxResults=1&nextToken=<your-pagination-token>" \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ --service bedrock-agentcore \ --region <Region>

Menghapus Browser AgentCore

Ketika Anda tidak lagi membutuhkan alat browser, Anda dapat menghapusnya untuk membebaskan sumber daya. Sebelum menghapus alat browser, pastikan untuk menghentikan semua sesi aktif yang terkait dengannya.

contoh
Console
  1. Untuk menghapus alat Browser menggunakan konsol

  2. Buka AgentCore konsol di https://console.aws.amazon.com/bedrock-agentcore/home#.

  3. Arahkan ke Built-in alat dan pilih alat browser Anda.

  4. Pilih Hapus dari menu Tindakan.

  5. Konfirmasikan penghapusan dengan mengetikkan nama alat browser di dialog konfirmasi.

  6. Pilih Hapus.

    catatan

    Anda tidak dapat menghapus alat browser yang memiliki sesi aktif. Hentikan semua sesi sebelum mencoba menghapus alat.

AWS CLI
  1. Untuk menghapus alat Browser menggunakan AWS CLI, gunakan perintah: delete-browser

    aws bedrock-agentcore-control delete-browser \ --region <Region> \ --browser-id "<your-browser-id>"
Boto3
  1. Untuk menghapus alat Browser menggunakan AWS SDK for Python (Boto3), gunakan metode: delete_browser

    Permintaan Sintaks

    Berikut ini menunjukkan sintaks permintaan:

    response = cp_client.delete_browser( browserId="<your-browser-id>" )
API
  1. Untuk menghapus alat browser menggunakan API, gunakan panggilan berikut:

    # Using awscurl awscurl -X DELETE \ "https://bedrock-agentcore-control.<Region>.amazonaws.com/browsers/<your-browser-id>" \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ --service bedrock-agentcore-control \ --region <Region>