View a markdown version of this page

Menggunakan Alat Browser - Batu Dasar Amazon AgentCore

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Menggunakan Alat Browser

Membuat AgentCore Browser

Anda dapat membuat Browser Tool menggunakan AgentCore konsol Amazon Bedrock, AWS CLI, atau AWS 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 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 Iz in, tentukan peran eksekusi IAM yang menentukan AWS sumber daya apa yang dapat diakses oleh Browser Tool.

  9. Pilih Buat.

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

    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 untuk Python (Boto3), gunakan metode ini: create_browser

    Minta 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 get-browser perintah:

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

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

Alat Per AgentCore amban Listing

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 list-browsers perintah:

    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 untuk Python (Boto3), gunakan metode ini: list_browsers

    Minta 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 AgentCore Browser

Ketika Anda tidak lagi memerlukan 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 delete-browser perintah:

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

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