Cara Menggunakan Claude Web Search API

Model Bahasa Besar (LLM) seperti Claude dari Anthropic telah mengubah cara kita berinteraksi dengan informasi dan teknologi. Kemampuan mereka untuk memahami, menghasilkan, dan bernalar tentang teks telah membuka pintu bagi aplikasi yang tak terhitung jumlahnya. Namun, keterbatasan umum banyak LLM adalah ketergantungan mereka pada data pelatihan statis, yang berarti pengetahuan mereka terhenti pada titik waktu tertentu. Di dunia di mana informasi berubah setiap detik, "batas pengetahuan" ini bisa menjadi hambatan yang signifikan. Hadirlah API Pencarian Web Claude – alat canggih yang dirancang untuk menjembatani kesenjangan ini dengan memberikan Claude kemampuan untuk mengakses dan menggabungkan informasi real-time dari internet langsung ke dalam responsnya.

Artikel ini akan memberikan panduan komprehensif untuk memahami dan memanfaatkan API Pencarian Web Claude. Kami akan menjelajahi signifikansinya, cara kerjanya, langkah-langkah implementasi praktis, fitur canggih, kasus penggunaan yang menarik, dan praktik terbaik untuk pengembang yang ingin membangun aplikasi AI generasi berikutnya yang tidak hanya cerdas, tetapi juga terkini dan sadar konteks.

API Pencarian Web Claude: Sekilas

Dunia digital berada dalam keadaan fluks yang konstan. Berita muncul, tren pasar bergeser, penemuan ilmiah diterbitkan, dan dokumentasi perangkat lunak terus diperbarui. LLM yang dilatih pada kumpulan data sebelum perubahan ini dapat secara tidak sengaja memberikan informasi yang usang atau tidak lengkap, membatasi kegunaannya dalam skenario yang membutuhkan akurasi terkini.

Akses web real-time mengatasi keterbatasan mendasar ini dalam beberapa cara utama:

1. Mengatasi Batas Pengetahuan: Manfaat yang paling jelas adalah kemampuan untuk mengakses informasi yang dibuat atau diperbarui setelah siklus pelatihan terakhir LLM. Ini berarti Claude dapat menjawab pertanyaan tentang peristiwa terkini, urusan saat ini, atau perkembangan terbaru di bidang apa pun.
2. Peningkatan Akurasi dan Relevansi: Dengan mengambil data langsung, LLM dapat memberikan jawaban yang tidak hanya terkini tetapi juga lebih relevan dengan konteks langsung pengguna. Baik itu cuaca saat ini, harga saham terbaru, atau berita terkini, informasinya tepat waktu dan dapat ditindaklanjuti.
3. Penyelesaian Masalah Dinamis: Banyak masalah dunia nyata memerlukan informasi yang secara inheren dinamis. Misalnya, memecahkan masalah perangkat lunak mungkin memerlukan laporan bug atau diskusi forum terbaru, sementara riset pasar membutuhkan data pesaing terkini. Pencarian web memberdayakan LLM untuk mengatasi tantangan dinamis ini dengan lebih efektif.
4. Batasan Baru untuk Aplikasi AI: Akses ke data real-time membuka banyak aplikasi baru. Bayangkan asisten AI yang dapat memberikan skor olahraga langsung, penasihat keuangan yang menawarkan wawasan berdasarkan pergerakan pasar saat ini, atau alat penelitian yang dapat mensintesis makalah akademis terbaru.
5. Membangun Kepercayaan melalui Verifikasi: Ketika LLM dapat mengutip sumbernya dari web langsung, itu secara signifikan meningkatkan kepercayaan pengguna. Pengguna dapat memverifikasi informasi itu sendiri, menumbuhkan transparansi dan kepercayaan pada respons AI.

API Pencarian Web Claude adalah jawaban Anthropic untuk kebutuhan ini, menyediakan solusi yang kuat dan terintegrasi bagi pengembang untuk membangun aplikasi yang memanfaatkan basis pengetahuan internet yang luas dan terus berkembang.

Cara Menggunakan API Pencarian Web Claude

Pada intinya, API Pencarian Web untuk Claude adalah "alat" yang dapat diputuskan oleh Claude untuk digunakan ketika menentukan bahwa kueri pengguna akan mendapat manfaat dari informasi eksternal yang terkini. Ini bukan pencarian kata kunci sederhana; Claude menggunakan kemampuan penalaran canggihnya untuk memahami kapan dan bagaimana mencari secara efektif.

Model Claude yang Didukung:

Sejak diluncurkan dan pembaruan berikutnya, fungsionalitas pencarian web tersedia di beberapa model Claude yang kuat, termasuk:

• Claude 3.7 Sonnet (claude-3-7-sonnet-20250219 atau claude-3-7-sonnet-latest)
• Claude 3.5 Sonnet yang ditingkatkan (claude-3-5-sonnet-latest)
• Claude 3.5 Haiku (claude-3-5-haiku-latest)

Selalu rujuk dokumentasi resmi Anthropic untuk daftar model yang didukung yang paling terkini.

Cara Kerja API Pencarian Web Claude

1. Pemanggilan Cerdas: Ketika pengguna mengirimkan prompt ke model Claude yang didukung dengan alat pencarian web diaktifkan, Claude pertama-tama menganalisis kueri. Jika menyimpulkan bahwa pengetahuan internalnya tidak mencukupi atau mungkin sudah usang untuk kueri yang diberikan, ia memutuskan untuk memulai pencarian web.
2. Pembuatan & Eksekusi Kueri: Claude merumuskan kueri pencarian yang ditargetkan berdasarkan pemahamannya tentang kebutuhan pengguna. API Anthropic kemudian mengeksekusi pencarian ini, mengambil halaman web yang relevan.
3. Pencarian & Perbaikan Agen: Claude dapat beroperasi secara "agen", yang berarti ia dapat melakukan beberapa pencarian progresif. Ia mungkin menggunakan hasil dari pencarian awal untuk menginformasikan dan menyempurnakan kueri berikutnya, memungkinkannya melakukan penelitian ringan dan mengumpulkan informasi yang lebih komprehensif. Proses iteratif ini berlanjut hingga Claude yakin ia memiliki informasi yang cukup atau mencapai batas yang telah ditentukan (misalnya, max_uses).
4. Analisis dan Sintesis: Claude menganalisis hasil pencarian yang diambil, mengekstrak informasi penting, dan mensintesisnya untuk membentuk jawaban yang koheren dan komprehensif.
5. Respons dengan Kutipan: Yang terpenting, Claude memberikan respons akhirnya dengan kutipan kembali ke materi sumber. Ini memungkinkan pengguna untuk memverifikasi informasi dan memahami asalnya, mendorong transparansi dan kepercayaan.

Seluruh proses ini dirancang agar mulus bagi pengembang. Alih-alih membangun dan mengelola infrastruktur web scraping dan pencarian mereka sendiri, pengembang cukup mengaktifkan alat ini dan membiarkan Claude menangani kerumitan pengambilan informasi real-time.

Bagaimana dengan Harga untuk API Pencarian Web Claude?

Mengenai harga untuk API Pencarian Web Claude, Anthropic memiliki model yang sederhana. Penggunaan alat pencarian web itu sendiri ditagih dengan tarif $10 untuk setiap 1.000 pencarian yang dilakukan. Penting untuk dicatat bahwa biaya ini khusus untuk operasi pencarian yang dieksekusi oleh alat tersebut.

Biaya ini terpisah dan tambahan dari biaya standar yang terkait dengan pemrosesan permintaan, yang mencakup biaya reguler untuk token input dan output yang dikonsumsi oleh model Claude untuk memahami kueri, memproses hasil pencarian, dan menghasilkan respons akhir.

Cara Menggunakan API Pencarian Web Claude

Mengintegrasikan pencarian web ke dalam aplikasi bertenaga Claude Anda melibatkan beberapa langkah sederhana.

Prasyarat

Sebelum Anda dapat menggunakan alat pencarian web, administrator organisasi Anda harus mengaktifkannya di dalam Konsol Anthropic (biasanya ditemukan di bawah pengaturan terkait privasi atau penggunaan alat).

Melakukan Permintaan API

Untuk menggunakan alat pencarian web, Anda perlu menyertakannya dalam array tools dari permintaan API Anda ke Messages API. Berikut adalah tampilan konseptual bagaimana ini disusun:

Definisi Alat

Definisi alat dasar yang akan Anda gunakan adalah:

{
  "type": "web_search_20250305",
  "name": "web_search"
}

• type: String spesifik ini mengidentifikasi versi alat pencarian web.
• name: Nama deskriptif untuk alat, biasanya "web_search".

Berikut adalah contoh panggilan curl:

curl https://api.anthropic.com/v1/messages \\
    --header "x-api-key: $ANTHROPIC_API_KEY" \\
    --header "anthropic-version: 2023-06-01" \\ # Atau versi terbaru yang direkomendasikan
    --header "content-type: application/json" \\
    --data '{
        "model": "claude-3.5-sonnet-latest",    # Atau model lain yang didukung
        "max_tokens": 1024,
        "messages": [
            {
                "role": "user",
                "content": "What are the latest developments in quantum computing this year?" # Apa perkembangan terbaru dalam komputasi kuantum tahun ini?
            }
        ],
        "tools": [{
            "type": "web_search_20250305",
            "name": "web_search",
            "max_uses": 5 # Opsional: Batasi iterasi pencarian
        }]
    }'

Alat pencarian web menawarkan beberapa parameter opsional untuk menyesuaikan perilakunya:

max_uses (integer, opsional):

• Parameter ini membatasi jumlah operasi pencarian berbeda yang dapat dilakukan Claude dalam satu permintaan API.
• Ini adalah kontrol yang berguna untuk mengelola kedalaman penelitian dan potensi biaya yang terkait dengan pencarian.
• Jika Claude mencoba melebihi batas ini, web_search_tool_result akan menunjukkan kesalahan dengan kode max_uses_exceeded.
• Perilaku default jika tidak ditentukan memungkinkan Claude menentukan jumlah pencarian berdasarkan penalaran.

allowed_domains (array string, opsional):

• Tentukan daftar domain tempat Claude diizinkan mengambil hasil pencarian. Ini sangat baik untuk memastikan informasi hanya berasal dari sumber yang telah disetujui dan terpercaya.
• Penting:
• Jangan sertakan skema HTTP/HTTPS (misalnya, gunakan example.com, bukan https://example.com).
• Subdomain secara otomatis disertakan (misalnya, example.com juga mencakup docs.example.com).
• Subpath didukung (misalnya, example.com/blog).
• Anda dapat menggunakan allowed_domains atau blocked_domains dalam satu permintaan, tetapi tidak keduanya.

blocked_domains (array string, opsional):

• Tentukan daftar domain yang tidak boleh diakses oleh Claude. Ini berguna untuk mencegah akses ke situs pesaing, sumber yang tidak relevan, atau domain yang dikenal menyebarkan misinformasi.
• Aturan pemformatan yang sama dengan allowed_domains berlaku.
• Tidak dapat digunakan secara bersamaan dengan allowed_domains.

user_location (objek, opsional):

• Parameter ini memungkinkan Anda melokalisasi hasil pencarian, membuatnya lebih relevan dengan konteks geografis pengguna.
• Strukturnya adalah:

"user_location": {
  "type": "approximate", // Saat ini, hanya "approximate" yang didukung
  "city": "San Francisco",
  "region": "California",
  "country": "US",
  "timezone": "America/Los_Angeles" // ID zona waktu IANA
}

• Ini membantu Claude mengambil hasil yang relevan secara geografis, seperti berita lokal, layanan, atau cuaca.

Cara Menangani Respons API Pencarian Web Claude

Ketika Claude menggunakan alat pencarian web, respons API akan berisi blok informasi spesifik yang merinci proses dan hasil pencarian. Memahami struktur ini adalah kunci untuk menggunakan alat ini secara efektif.

Struktur Respons Umum:

Array content dalam pesan asisten akan mencakup:

Keputusan Claude untuk Mencari (type: "text"): Seringkali, Claude akan mengeluarkan teks singkat yang menunjukkan niatnya untuk mencari, misalnya, "Saya akan mencari berita terbaru tentang topik itu."

Blok Penggunaan Alat Server (type: "server_tool_use"):

• Blok ini menandakan bahwa Claude telah memutuskan untuk menggunakan alat sisi server (seperti pencarian web).
• Ini mencakup id (misalnya, srvtoolu_01WYG3ziw53XMcoyKL4XcZmE), name alat ("web_search"), dan objek input.
• Objek input berisi query sebenarnya yang dikirim Claude ke mesin pencari (misalnya, {"query": "claude shannon birth date"}).

Blok Hasil Alat Pencarian Web (type: "web_search_tool_result"):

• Blok ini berisi hasil pencarian. Ini merujuk pada tool_use_id dari blok server_tool_use.
• content di dalam blok ini akan menjadi array objek web_search_result jika pencarian berhasil.
• Setiap objek web_search_result mencakup:
• url: URL halaman sumber.
• title: Judul halaman sumber.
• encrypted_content: Konten terenkripsi dari halaman. Ini harus dikembalikan dalam giliran percakapan multi-giliran berikutnya jika Anda ingin Claude dapat mengutip konten spesifik ini secara akurat.
• page_age: Indikator kapan situs terakhir diperbarui atau dirayapi (misalnya, "30 April 2025").

Respons Sintesis Claude (type: "text" dengan kutipan):

• Setelah hasil pencarian, Claude memberikan jawaban tekstualnya, menggabungkan informasi yang ditemukan.
• Yang terpenting, bagian dari teks ini akan memiliki citations terkait.
• Setiap objek citation (dengan tipe web_search_result_location) mencakup:
• url: URL sumber yang dikutip.
• title: Judul sumber yang dikutip.
• encrypted_index: Referensi ke bagian spesifik dari encrypted_content yang mendukung kutipan ini. Ini juga perlu dikembalikan dalam percakapan multi-giliran.
• cited_text: Cuplikan (hingga 150 karakter) teks dari sumber yang dikutip.

Catatan Penting tentang Kutipan: Bidang kutipan (cited_text, title, url) tidak dihitung dalam penggunaan token input atau output Anda, menjadikannya cara yang hemat biaya untuk memberikan informasi yang dapat diverifikasi.

Menangani Kesalahan:
Jika terjadi kesalahan selama proses pencarian web, blok web_search_tool_result akan berisi objek kesalahan alih-alih hasil.

{
  "type": "web_search_tool_result",
  "tool_use_id": "servertoolu_a93jad",
  "content": {
    "type": "web_search_tool_result_error",
    "error_code": "max_uses_exceeded" // Contoh kesalahan
  }
}

Kode kesalahan umum meliputi:

• too_many_requests: Batas tarif untuk pencarian terlampaui.
• invalid_input: Masalah dengan parameter kueri pencarian (misalnya, filter domain yang salah format).
• max_uses_exceeded: Claude mencoba melakukan lebih banyak pencarian daripada yang diizinkan oleh parameter max_uses.
• query_too_long: Kueri pencarian yang dihasilkan oleh Claude terlalu panjang.
• unavailable: Terjadi kesalahan internal dalam layanan pencarian.

Alasan Berhenti pause_turn:
Untuk giliran yang berpotensi lama yang melibatkan banyak pencarian, respons API mungkin mencakup stop_reason berupa pause_turn. Ini menunjukkan bahwa API telah menjeda giliran. Anda dapat melanjutkan giliran dengan mengirimkan kembali seluruh konten respons dalam permintaan berikutnya, memungkinkan Claude melanjutkan pekerjaannya.

Menguji API Pencarian Web Claude dengan Apidog

Apidog menawarkan lingkungan yang kuat untuk menguji API seperti Pencarian Web Claude. Berikut cara Anda dapat melakukannya:

Siapkan Proyek Anda: Di Apidog, buat proyek baru atau gunakan yang sudah ada. Anda dapat menentukan endpoint API Claude secara manual atau mengimpor spesifikasi OpenAPI jika Anthropic menyediakannya.

Definisikan Permintaan:

• Navigasikan ke mode "Request" atau "Design". Buat permintaan API baru.
• Metode: Atur metode HTTP ke POST.
• URL: Masukkan endpoint Claude Messages API (misalnya, https://api.anthropic.com/v1/messages).
• Header: Tambahkan header yang diperlukan:
• x-api-key: Kunci API Anthropic Anda.
• anthropic-version: Versi API yang diperlukan (misalnya, 2023-06-01).
• content-type: application/json.

Susun Badan Permintaan:

• Di tab "Body" (pilih "raw" lalu "JSON"), masukkan payload JSON. Ini akan mencakup model, max_tokens, array messages (dengan peran dan konten pengguna), dan array tools yang menentukan alat web_search.

Kirim dan Periksa: Klik "Send". Apidog akan menampilkan respons, memungkinkan Anda memeriksa kode status, header, dan badan respons, termasuk hasil pencarian web dan kutipan dari Claude.

Asersi (Opsional): Gunakan fitur asersi Apidog untuk memvalidasi elemen respons secara otomatis, seperti keberadaan blok web_search_tool_result atau detail kutipan spesifik.

Proses yang disederhanakan di Apidog ini membantu Anda dengan cepat melakukan iterasi dan mengkonfirmasi fungsionalitas API Pencarian Web Claude.

Fitur Lanjutan & Praktik Terbaik untuk API Pencarian Web Claude

Selain dasar-dasarnya, API Pencarian Web Claude menawarkan fitur untuk mengoptimalkan kinerja, biaya, dan pengalaman pengguna.

Caching Prompt:

• Pencarian web terintegrasi dengan fitur caching prompt Anthropic.
• Dengan menempatkan titik henti cache_control secara strategis dalam permintaan Anda (terutama dalam percakapan multi-giliran), Anda dapat menyimpan hasil pencarian web dalam cache.
• Misalnya, setelah menerima web_search_tool_result, jika Anda menambahkannya ke riwayat pesan Anda dan kemudian menambahkan pesan pengguna baru dengan cache_control: {"type": "ephemeral"}, panggilan berikutnya dapat menggunakan kembali hasil pencarian yang di-cache, mengurangi latensi dan biaya token untuk bagian yang di-cache, sambil tetap memungkinkan pencarian baru jika diperlukan.

Streaming:

• Ketika streaming diaktifkan untuk permintaan API Anda, Anda akan menerima event terkait proses pencarian web secara real-time.
• Ini mencakup event untuk content_block_start ketika Claude memutuskan untuk mencari, content_block_delta saat kueri pencarian di-stream, jeda alami saat pencarian dieksekusi, dan kemudian event lebih lanjut saat hasil pencarian (web_search_tool_result) di-stream kembali.
• Streaming memberikan pengalaman pengguna yang lebih responsif, karena pengguna dapat melihat bahwa AI secara aktif bekerja mengambil informasi.

Permintaan Batch:

• Alat pencarian web dapat disertakan dalam permintaan yang dibuat ke Messages Batches API. Ini berguna untuk memproses beberapa kueri yang mungkin memerlukan pencarian web secara asinkron, dalam mode batch.
• Harga untuk pencarian web melalui Batches API sama dengan harga untuk permintaan Messages API biasa.

Membangun dengan Kepercayaan dan Kontrol:

• Manfaatkan Kutipan: Selalu rancang UI Anda untuk menampilkan kutipan yang diberikan oleh Claude. Transparansi ini adalah kunci kepercayaan pengguna dan memungkinkan pengguna memverifikasi informasi.
• Gunakan Penyaringan Domain: Untuk aplikasi di mana keandalan sumber sangat penting (misalnya, saran keuangan atau medis), gunakan allowed_domains untuk membatasi pencarian ke sumber yang berwenang. Gunakan blocked_domains untuk mencegah akses ke konten yang tidak pantas atau tidak diinginkan.
• Pengaturan Tingkat Organisasi: Ingatlah bahwa administrator dapat mengaktifkan atau menonaktifkan pencarian web di tingkat organisasi, menyediakan mekanisme kontrol yang menyeluruh.

Manajemen Biaya:

• Penggunaan pencarian web ditagih secara terpisah dari penggunaan token. Berdasarkan informasi terbaru, biayanya adalah $10 per 1.000 pencarian. Biaya token standar untuk konten yang dihasilkan oleh Claude berdasarkan hasil pencarian masih berlaku.
• Setiap pemanggilan pencarian web dihitung sebagai satu penggunaan, terlepas dari jumlah hasil yang dikembalikan. Kesalahan selama upaya pencarian biasanya tidak ditagih.
• Gunakan parameter max_uses dengan bijak untuk mengontrol potensi jumlah pencarian per kueri pengguna, terutama dalam skenario agen di mana Claude mungkin melakukan beberapa pencarian.

Kesimpulan

API Pencarian Web Claude merupakan langkah maju yang signifikan dalam menjadikan LLM lebih praktis, andal, dan cerdas. Dengan membebaskan diri dari batasan data pelatihan statis, Claude kini dapat berpartisipasi dalam percakapan dan menghasilkan konten yang mencerminkan dunia seperti apa adanya hari ini. Bagi pengembang, ini berarti kemampuan untuk membangun aplikasi AI yang lebih kuat, akurat, dan dapat dipercaya yang benar-benar dapat mengimbangi sifat informasi yang dinamis.

Seiring dengan terus berkembangnya LLM, alat terintegrasi seperti pencarian web akan semakin menjadi standar, mengubah model-model ini dari repositori pengetahuan yang mengesankan menjadi mitra yang dinamis dan interaktif dalam penemuan informasi dan penyelesaian masalah. Dengan memahami dan memanfaatkan kemampuan API Pencarian Web Claude, pengembang dapat berada di garis depan evolusi yang menarik ini, menciptakan solusi AI yang tidak hanya cerdas, tetapi juga terus-menerus diinformasikan oleh denyut nadi web.