Menangani pemanggilan alat

Halaman ini mencakup siklus hidup pemanggilan alat: membaca blok tool_use dari respons Claude, memformat blok tool_result dalam balasan Anda, dan menandakan kesalahan. Untuk abstraksi SDK yang menangani ini secara otomatis, lihat Tool Runner.

Respons Claude berbeda tergantung pada apakah menggunakan alat klien atau server.

Menangani hasil dari alat klien

Respons akan memiliki stop_reason dari tool_use dan satu atau lebih blok konten tool_use yang mencakup:

• id: Pengenal unik untuk blok penggunaan alat tertentu ini. Ini akan digunakan untuk mencocokkan hasil alat nanti.
• name: Nama alat yang digunakan.
• input: Objek yang berisi input yang diteruskan ke alat, sesuai dengan input_schema alat.

Ketika Anda menerima respons penggunaan alat untuk alat klien, Anda harus:

1. Ekstrak name, id, dan input dari blok tool_use.
2. Jalankan alat sebenarnya di basis kode Anda yang sesuai dengan nama alat tersebut, meneruskan input alat.
3. Lanjutkan percakapan dengan mengirim pesan baru dengan role dari user, dan blok content yang berisi tipe tool_result dan informasi berikut:
   • tool_use_id: id dari permintaan penggunaan alat ini adalah hasil untuk.
   • content: Hasil alat, sebagai string (misalnya, ), daftar blok konten bersarang (misalnya, ), atau daftar blok dokumen (misalnya, ). Blok konten ini dapat menggunakan tipe , , atau .

{
  "role": "user",
  "content": [
    { "type": "text", "text": "Here are the results:" }, // ❌ Text before tool_result
    { "type": "tool_result", "tool_use_id": "toolu_01" /* ... */ }
  ]
}

Setelah menerima hasil alat, Claude akan menggunakan informasi tersebut untuk terus menghasilkan respons terhadap prompt pengguna asli.

Menangani hasil dari alat server

Claude menjalankan alat secara internal dan menggabungkan hasilnya langsung ke dalam responsnya tanpa memerlukan interaksi pengguna tambahan.

Menangani kesalahan dengan is_error

Ada beberapa jenis kesalahan berbeda yang dapat terjadi saat menggunakan alat dengan Claude:

Langkah berikutnya

• Untuk menjalankan beberapa alat dalam satu putaran, lihat Parallel tool use.
• Untuk abstraksi SDK yang mengotomatisasi loop ini, lihat Tool Runner.
• Untuk alur kerja tool-use lengkap, lihat Define tools.