View a markdown version of this page

Gunakan alat penggunaan komputer untuk mengotomatiskan tugas GUI dengan model Amazon Bedrock - Amazon Bedrock
Gunakan penggunaan komputer di Amazon BedrockContoh permintaan

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

Gunakan alat penggunaan komputer untuk mengotomatiskan tugas GUI dengan model Amazon Bedrock

Penggunaan komputer adalah keluarga Anthropic Claude alat (dalam versi beta) untuk mengotomatisasi tugas antarmuka pengguna grafis (GUI). Model mengembalikan tool_use tindakan sepertiscreenshot,, left_clicktype, dan scroll di JSON. Aplikasi Anda mengeksekusi tindakan tersebut di desktop atau wadah dan mengembalikan tangkapan layar yang dihasilkan ke Claude giliran berikutnya.

Untuk protokol alat yang mendasari, daftar lengkap tindakan, dan panduan prompt engineering, lihat Penggunaan komputer dalam dokumentasi. Anthropic Halaman ini mencakup Bedrock-specific penggunaan Amazon di atas protokol itu.

Awas

Penggunaan komputer tersedia untuk Anda sebagai “Layanan Beta” sebagaimana didefinisikan dalam Ketentuan AWS Layanan. Ini tunduk pada Perjanjian Anda dengan AWS, Ketentuan AWS Layanan, dan model EULA yang berlaku. Computer Use API menimbulkan risiko unik yang berbeda dari fitur API standar atau antarmuka obrolan. Risiko ini meningkat saat menggunakan Computer Use API untuk berinteraksi dengan Internet. Untuk meminimalkan risiko, pertimbangkan untuk mengambil tindakan pencegahan seperti:

  • Mengoperasikan fungsionalitas penggunaan komputer dalam Mesin Virtual khusus atau wadah dengan hak istimewa minimal untuk mencegah serangan sistem langsung atau kecelakaan.

  • Untuk mencegah pencurian informasi, hindari memberikan akses API Penggunaan Komputer ke akun atau data sensitif.

  • Batasi akses internet API yang digunakan komputer ke domain yang diperlukan untuk mengurangi paparan konten berbahaya.

  • Untuk memastikan pengawasan yang tepat, pertahankan manusia dalam lingkaran untuk tugas-tugas sensitif (seperti membuat keputusan yang dapat memiliki konsekuensi dunia nyata yang berarti) dan untuk apa pun yang memerlukan persetujuan afirmatif (seperti menerima cookie, melaksanakan transaksi keuangan, atau menyetujui persyaratan layanan).

Konten apa pun yang Anda aktifkan Claude untuk dilihat atau diakses berpotensi mengesampingkan instruksi atau Claude menyebabkan kesalahan atau melakukan tindakan yang tidak diinginkan. Mengambil tindakan pencegahan yang tepat, seperti mengisolasi Claude dari permukaan sensitif, sangat penting - termasuk untuk menghindari risiko yang terkait dengan injeksi segera. Sebelum mengaktifkan atau meminta izin yang diperlukan untuk mengaktifkan fitur penggunaan komputer dalam produk Anda sendiri, harap beri tahu pengguna akhir tentang risiko yang relevan, dan dapatkan persetujuan mereka sebagaimana mestinya.

Gunakan penggunaan komputer di Amazon Bedrock

Penggunaan komputer didukung pada titik akhir bedrock-runtime dan bedrock-mantle titik akhir. Untuk menemukan model mana yang mendukung penggunaan komputer pada setiap titik akhir, lihat tabel Capabilities and Features di masing-masingSekilas tentang model. Mengirimkan permintaan ke model yang tidak mendukung penggunaan komputer, atau memasangkan jenis alat dengan model yang tidak didukung, mengembalikan file. 400 invalid_request_error

Untuk mengaktifkan penggunaan komputer berdasarkan permintaan, sertakan keduanya:

  • anthropic_betaEntri yang menamai versi beta penggunaan komputer (misalnya, "anthropic_beta": ["computer-use-2025-11-24"] di badan permintaan untukbedrock-runtime, atau header anthropic-beta: computer-use-2025-11-24 HTTP untukbedrock-mantle).

  • Satu atau beberapa entri alat yang Anthropic telah ditentukan sebelumnya dalam tools array, dengan type bidang yang cocok dengan versi beta (misalnya,, computer_20251124bash_20250124, atautext_editor_20250124).

Untuk pasangan beta-versi-ke-jenis alat, alat tambahan yang Anthropic ditentukan (bash dan editor teks), serta dokumentasi bidang permintaan dan respons lengkap, lihat. Penggunaan komputer (Beta)

Contoh permintaan

Contoh Python berikut mengirimkan permintaan API Pesan melalui bedrock-runtime titik akhir dengan alat penggunaan komputer. Ganti modelId dengan yang mendukung penggunaan komputer (lihatSekilas tentang model).

import boto3
import json

client = boto3.client("bedrock-runtime", region_name="us-east-1")

response = client.invoke_model(
    modelId="us.anthropic.claude-opus-4-7",
    body=json.dumps({
        "anthropic_version": "bedrock-2023-05-31",
        "anthropic_beta": ["computer-use-2025-11-24"],
        "max_tokens": 1024,
        "messages": [
            {"role": "user", "content": "Take a screenshot of the desktop."}
        ],
        "tools": [
            {
                "type": "computer_20251124",
                "name": "computer",
                "display_width_px": 1024,
                "display_height_px": 768,
            }
        ],
    }),
)

result = json.loads(response["body"].read())
print(result["stop_reason"])  # "tool_use" when the model issues a computer action
print(result["content"])      # contains the tool_use block describing the action

Untuk bentuk permintaan bedrock-mantle Messages API yang setara, lihatInferensi menggunakan Anthropic Messages API.