Alat

Claude Managed Agents menyediakan serangkaian alat bawaan yang dapat digunakan Claude secara otonom dalam sesi. Anda mengontrol alat mana yang tersedia dengan menentukan alat tersebut dalam konfigurasi agen.

Alat khusus yang ditentukan pengguna juga didukung. Aplikasi Anda menjalankan alat ini secara terpisah dan mengirimkan hasil alat kembali ke Claude; Claude dapat menggunakan hasil untuk melanjutkan tugas yang sedang berlangsung.

Alat yang tersedia

Set alat agen mencakup alat berikut. Semua diaktifkan secara default ketika Anda menyertakan set alat dalam konfigurasi agen Anda.

Mengonfigurasi set alat

Aktifkan set alat lengkap dengan agent_toolset_20260401 saat membuat agen. Gunakan array configs untuk menonaktifkan alat tertentu atau mengganti pengaturan mereka.

ant beta:agents create <<'YAML'
name: Coding Assistant
model: claude-opus-4-7
tools:
  - type: agent_toolset_20260401
    configs:
      - name: web_fetch
        enabled: false
YAML

Menonaktifkan alat tertentu

Untuk menonaktifkan alat, atur enabled: false dalam entri konfigurasinya:

{
  "type": "agent_toolset_20260401",
  "configs": [
    { "name": "web_fetch", "enabled": false },
    { "name": "web_search", "enabled": false }
  ]
}

Mengaktifkan hanya alat tertentu

Untuk memulai dengan semuanya dimatikan dan mengaktifkan hanya apa yang Anda butuhkan, atur default_config.enabled ke false:

{
  "type": "agent_toolset_20260401",
  "default_config": { "enabled": false },
  "configs": [
    { "name": "bash", "enabled": true },
    { "name": "read", "enabled": true },
    { "name": "write", "enabled": true }
  ]
}

Alat khusus

Selain alat bawaan, Anda dapat menentukan alat khusus. Alat khusus analog dengan alat yang ditentukan pengguna yang dijalankan klien dalam Messages API.

Alat khusus memungkinkan Anda memperluas kemampuan Claude untuk melakukan berbagai tugas. Setiap alat mendefinisikan kontrak: Anda menentukan operasi apa yang tersedia dan apa yang mereka kembalikan; Claude memutuskan kapan dan bagaimana memanggilnya. Model tidak pernah menjalankan apa pun sendiri. Ini mengeluarkan permintaan terstruktur, kode Anda menjalankan operasi, dan hasilnya mengalir kembali ke percakapan.

ant beta:agents create <<'YAML'
name: Weather Agent
model: claude-opus-4-7
tools:
  - type: agent_toolset_20260401
  - type: custom
    name: get_weather
    description: Get current weather for a location
    input_schema:
      type: object
      properties:
        location:
          type: string
          description: City name
      required:
        - location
YAML

Setelah Anda menentukan alat di tingkat agen, agen akan memanggil alat selama sesi. Lihat Aliran acara sesi untuk alur lengkapnya.

Praktik terbaik untuk definisi alat khusus

• Berikan deskripsi yang sangat detail. Ini adalah faktor paling penting dalam kinerja alat. Deskripsi Anda harus menjelaskan apa yang dilakukan alat, kapan alat harus digunakan (dan kapan tidak), apa arti setiap parameter dan bagaimana hal itu mempengaruhi perilaku alat, dan peringatan atau batasan penting apa pun. Semakin banyak konteks yang dapat Anda berikan Claude tentang alat Anda, semakin baik dalam memutuskan kapan dan bagaimana menggunakannya. Targetkan setidaknya 3-4 kalimat per deskripsi alat, lebih banyak jika alat tersebut kompleks.
• Konsolidasikan operasi terkait ke dalam lebih sedikit alat. Daripada membuat alat terpisah untuk setiap tindakan (create_pr, review_pr, merge_pr), kelompokkan mereka ke dalam satu alat dengan parameter action. Lebih sedikit alat yang lebih mampu mengurangi ambiguitas pemilihan dan membuat permukaan alat Anda lebih mudah dinavigasi oleh Claude.
• Gunakan penamaan namespace yang bermakna dalam nama alat. Ketika alat Anda mencakup beberapa layanan atau sumber daya, awali nama dengan sumber daya (misalnya, db_query, storage_read). Ini membuat pemilihan alat tidak ambigu saat perpustakaan Anda berkembang.
• Desain respons alat untuk mengembalikan hanya informasi sinyal tinggi. Kembalikan pengidentifikasi semantik yang stabil (misalnya, slug atau UUID) daripada referensi internal yang buram, dan sertakan hanya bidang yang Claude butuhkan untuk bernalar tentang langkah berikutnya. Respons yang membengkak membuang konteks dan membuat lebih sulit bagi Claude untuk mengekstrak apa yang penting.