Tools

Claude Managed Agents menyediakan sekumpulan tools bawaan yang dapat digunakan Claude secara otonom dalam sebuah sesi. Anda mengontrol tools mana yang tersedia dengan menentukannya dalam konfigurasi agen.

Tools kustom yang didefinisikan pengguna juga didukung. Aplikasi Anda mengeksekusi tools ini secara terpisah dan mengirimkan hasil tools kembali ke Claude; Claude dapat menggunakan hasilnya untuk melanjutkan tugas yang sedang dikerjakan.

Tools yang tersedia

Toolset agen mencakup tools berikut. Semua diaktifkan secara default ketika Anda menyertakan toolset dalam konfigurasi agen Anda.

Mengonfigurasi toolset

Aktifkan toolset lengkap dengan agent_toolset_20260401 saat membuat agen. Gunakan array configs untuk menonaktifkan tools tertentu atau mengganti pengaturannya.

agent=$(curl -fsSL https://api.anthropic.com/v1/agents \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "content-type: application/json" \
  -d @- <<'EOF'
{
  "name": "Coding Assistant",
  "model": "claude-sonnet-4-6",
  "tools": [
    {
      "type": "agent_toolset_20260401",
      "configs": [
        {"name": "web_fetch", "enabled": false}
      ]
    }
  ]
}
EOF
)

Menonaktifkan tools tertentu

Untuk menonaktifkan sebuah tool, atur enabled: false dalam entri konfigurasinya:

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

Mengaktifkan hanya tools tertentu

Untuk memulai dengan semua dinonaktifkan dan hanya mengaktifkan 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 }
  ]
}

Tools kustom

Selain tools bawaan, Anda dapat mendefinisikan tools kustom. Tools kustom analog dengan tools klien yang didefinisikan pengguna dalam Messages API.

Tools kustom memungkinkan Anda memperluas kemampuan Claude untuk melakukan berbagai tugas yang lebih luas. Setiap tool mendefinisikan sebuah kontrak: Anda menentukan operasi apa yang tersedia dan apa yang dikembalikannya; Claude memutuskan kapan dan bagaimana memanggilnya. Model tidak pernah mengeksekusi apa pun sendiri. Model mengeluarkan permintaan terstruktur, kode Anda menjalankan operasi, dan hasilnya mengalir kembali ke dalam percakapan.

agent=$(curl -fsSL https://api.anthropic.com/v1/agents \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "content-type: application/json" \
  -d @- <<'EOF'
{
  "name": "Weather Agent",
  "model": "claude-sonnet-4-6",
  "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"]
      }
    }
  ]
}
EOF
)

Setelah Anda mendefinisikan tool di tingkat agen, agen akan memanggil tools tersebut selama berlangsungnya sesi. Lihat Aliran event sesi untuk alur lengkapnya.

Praktik terbaik untuk definisi tools kustom

• Berikan deskripsi yang sangat detail. Ini adalah faktor terpenting dalam performa tool. Deskripsi Anda harus menjelaskan apa yang dilakukan tool, kapan harus digunakan (dan kapan tidak), apa arti setiap parameter dan bagaimana pengaruhnya terhadap perilaku tool, serta peringatan atau batasan penting apa pun. Semakin banyak konteks yang dapat Anda berikan kepada Claude tentang tools Anda, semakin baik Claude dalam memutuskan kapan dan bagaimana menggunakannya. Targetkan setidaknya 3-4 kalimat per deskripsi tool, lebih banyak jika toolnya kompleks.
• Gabungkan operasi terkait ke dalam lebih sedikit tools. Daripada membuat tool terpisah untuk setiap tindakan (create_pr, review_pr, merge_pr), kelompokkan menjadi satu tool dengan parameter action. Lebih sedikit tools yang lebih mampu mengurangi ambiguitas pemilihan dan membuat permukaan tool Anda lebih mudah dinavigasi oleh Claude.
• Gunakan penamaan namespace yang bermakna dalam nama tools. Ketika tools Anda mencakup beberapa layanan atau sumber daya, awali nama dengan sumber daya (misalnya, db_query, storage_read). Ini membuat pemilihan tool tidak ambigu seiring berkembangnya library Anda.
• Rancang respons tool untuk mengembalikan hanya informasi yang bernilai tinggi. Kembalikan pengidentifikasi semantik yang stabil (misalnya, slug atau UUID) daripada referensi internal yang tidak transparan, dan sertakan hanya field yang dibutuhkan Claude untuk mempertimbangkan langkah selanjutnya. Respons yang membengkak membuang konteks dan mempersulit Claude untuk mengekstrak hal yang penting.