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
<a name="computer-use"></a>

Penggunaan komputer adalah keluarga Anthropic Claude alat (dalam versi beta) untuk mengotomatisasi tugas antarmuka pengguna grafis (GUI). Model mengembalikan `tool_use` tindakan seperti`screenshot`,, `left_click``type`, 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](https://docs.anthropic.com/en/docs/build-with-claude/computer-use) 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.

**Topics**
+ [Gunakan penggunaan komputer di Amazon Bedrock](#computer-use-bedrock-specifics)
+ [Contoh permintaan](#computer-use-example-code)

## Gunakan penggunaan komputer di Amazon Bedrock
<a name="computer-use-bedrock-specifics"></a>

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-masing[Sekilas tentang model](model-cards.md). 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_beta`Entri yang menamai versi beta penggunaan komputer (misalnya, `"anthropic_beta": ["computer-use-2025-11-24"]` di badan permintaan untuk`bedrock-runtime`, atau header `anthropic-beta: computer-use-2025-11-24` HTTP untuk`bedrock-mantle`).
+ Satu atau beberapa entri alat yang Anthropic telah ditentukan sebelumnya dalam `tools` array, dengan `type` bidang yang cocok dengan versi beta (misalnya,, `computer_20251124``bash_20250124`, atau`text_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)](model-parameters-anthropic-claude-messages-tool-use.md#model-parameters-anthropic-claude-messages-computer-use)

## Contoh permintaan
<a name="computer-use-example-code"></a>

Contoh Python berikut mengirimkan permintaan API Pesan melalui `bedrock-runtime` titik akhir dengan alat penggunaan komputer. Ganti `modelId` dengan yang mendukung penggunaan komputer (lihat[Sekilas tentang model](model-cards.md)).

```
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, lihat[Inferensi menggunakan Anthropic Messages API](inference-messages-api.md).