Penggunaan alat dengan Claude

Claude mampu berinteraksi dengan alat dan fungsi, memungkinkan Anda memperluas kemampuan Claude untuk melakukan berbagai tugas.

Berikut adalah contoh cara menyediakan alat ke Claude menggunakan Messages API:

curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 1024,
    "tools": [
      {
        "name": "get_weather",
        "description": "Get the current weather in a given location",
        "input_schema": {
          "type": "object",
          "properties": {
            "location": {
              "type": "string",
              "description": "The city and state, e.g. San Francisco, CA"
            }
          },
          "required": ["location"]
        }
      }
    ],
    "messages": [
      {
        "role": "user",
        "content": "What is the weather like in San Francisco?"
      }
    ]
  }'

Cara kerja penggunaan alat

Claude mendukung dua jenis alat:

1. Alat klien: Alat yang dijalankan pada sistem Anda, yang mencakup:

   • Alat khusus yang ditentukan pengguna yang Anda buat dan implementasikan
   • Alat yang ditentukan Anthropic seperti penggunaan komputer dan editor teks yang memerlukan implementasi klien

2. Alat server: Alat yang dijalankan pada server Anthropic, seperti alat pencarian web dan pengambilan web. Alat ini harus ditentukan dalam permintaan API tetapi tidak memerlukan implementasi di pihak Anda.

Alat klien

Integrasikan alat klien dengan Claude dalam langkah-langkah berikut:

Catatan: Langkah 3 dan 4 bersifat opsional. Untuk beberapa alur kerja, permintaan penggunaan alat Claude (langkah 2) mungkin semua yang Anda butuhkan, tanpa mengirim hasil kembali ke Claude.

Alat server

Alat server mengikuti alur kerja yang berbeda:

Menggunakan alat MCP dengan Claude

Jika Anda membangun aplikasi yang menggunakan Model Context Protocol (MCP), Anda dapat menggunakan alat dari server MCP secara langsung dengan Messages API Claude. Definisi alat MCP menggunakan format skema yang mirip dengan format alat Claude. Anda hanya perlu mengganti nama inputSchema menjadi input_schema.

Mengonversi alat MCP ke format Claude

Ketika Anda membangun klien MCP dan memanggil list_tools() pada server MCP, Anda akan menerima definisi alat dengan bidang inputSchema. Untuk menggunakan alat ini dengan Claude, konversikan ke format Claude:

Kemudian teruskan alat yang dikonversi ini ke Claude:

Ketika Claude merespons dengan blok tool_use, jalankan alat pada server MCP Anda menggunakan call_tool() dan kembalikan hasilnya ke Claude dalam blok tool_result.

Untuk panduan lengkap tentang membangun klien MCP, lihat Bangun klien MCP.

Contoh penggunaan alat

Berikut adalah beberapa contoh kode yang mendemonstrasikan berbagai pola dan teknik penggunaan alat. Demi singkatnya, alatnya adalah alat sederhana, dan deskripsi alatnya lebih pendek dari yang ideal untuk memastikan kinerja terbaik.

Harga

Tool use requests are priced based on:

1. The total number of input tokens sent to the model (including in the tools parameter)
2. The number of output tokens generated
3. For server-side tools, additional usage-based pricing (e.g., web search charges per search performed)

Client-side tools are priced the same as any other Claude API request, while server-side tools may incur additional charges based on their specific usage.

The additional tokens from tool use come from:

• The tools parameter in API requests (tool names, descriptions, and schemas)
• tool_use content blocks in API requests and responses
• tool_result content blocks in API requests

When you use tools, we also automatically include a special system prompt for the model which enables tool use. The number of tool use tokens required for each model are listed below (excluding the additional tokens listed above). Note that the table assumes at least 1 tool is provided. If no tools are provided, then a tool choice of none uses 0 additional system prompt tokens.

These token counts are added to your normal input and output tokens to calculate the total cost of a request.

Lihat tabel perbandingan model kami untuk harga per-model saat ini.

Ketika Anda mengirim prompt penggunaan alat, seperti permintaan API lainnya, respons akan menampilkan hitungan token input dan output sebagai bagian dari metrik usage yang dilaporkan.

Langkah Berikutnya

Jelajahi repositori kami dengan contoh kode penggunaan alat yang siap diimplementasikan di cookbook kami: