Penelusuran web dengan model Claude dari Anthropic

Penelusuran web adalah kemampuan yang memungkinkan model Claude menambah pengetahuannya dengan data real-time dari web. Model Claude menggunakan penyedia penelusuran pihak ketiga untuk fitur penelusuran web. Kemampuan penelusuran web sangat efektif untuk aplikasi RAG (Retrieval-Augmented Generation) yang mengharuskan Anda mengutip sumber secara akurat.

Kemampuan penelusuran web sangat cocok untuk kasus penggunaan berikut:

  • Mengambil dokumentasi teknis terbaru: Developer software dapat bertanya kepada Claude tentang dokumentasi API atau spesifikasi teknis terbaru, dan Claude dapat mengambil serta menyintesis informasi langsung dari dokumentasi sumber.
  • Mengumpulkan informasi bisnis dan pasar: Analis bisnis dapat mengumpulkan data pasar terkini, informasi perusahaan, atau berita industri untuk mendukung proses pengambilan keputusan mereka
  • Membantu riset: Pekerja intelektual dapat menggunakan Claude sebagai asisten riset yang dapat menemukan, menyintesis, dan menjelaskan informasi dari berbagai sumber web sambil mempertahankan kutipan yang akurat
  • Mendukung pelanggan: Aplikasi layanan pelanggan dapat mengakses informasi produk, harga, atau dokumentasi dukungan terbaru dari situs perusahaan

Model yang didukung

Gemini Enterprise Agent Platform mendukung penelusuran web untuk model Anthropic Claude berikut:

Mengontrol akses ke penelusuran web

Fitur penelusuran web memerlukan akses internet publik. Untuk project yang termasuk dalam organisasi, batasan kebijakan organisasi constraints/vertexai.allowedPartnerModelFeatures menonaktifkan penelusuran web secara default. Jika penelusuran web tidak diizinkan, permintaan yang menyertakan alat web_search_20250305 akan gagal dengan error HTTP 400 FAILED_PRECONDITION, sedangkan permintaan yang tidak menggunakan penelusuran web tidak akan terpengaruh.

Untuk mengaktifkan penelusuran web, administrator dengan peran Organization Policy Administrator (roles/orgpolicy.policyAdmin) harus menambahkan publishers/anthropic:web_search atau publishers/anthropic/models/MODEL_NAME:web_search ke allowedValues pada batasan.

Selain itu, Anda dapat mengonfigurasi batasan kebijakan organisasi constraints/vertexai.allowedModels untuk membatasi akses ke model Claude.

Untuk memastikan akses berkelanjutan ke penelusuran web untuk versi model ini pada atau setelah 2 Desember 2026, konfigurasikan kebijakan organisasi constraints/vertexai.allowedPartnerModelFeatures untuk mengizinkan penelusuran web sebelum 2 Desember 2026.

Untuk mengetahui petunjuk mendetail tentang cara mengonfigurasi batasan kebijakan organisasi, lihat Mengontrol akses ke model Model Garden.

Aktifkan penelusuran web dengan memberikan definisi alat penelusuran web Anthropic (web_search_20250305) dalam permintaan API.

Misalnya, cuplikan kode berikut menggunakan penelusuran web untuk mengambil informasi cuaca real-time:

response = await client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=1024,
    messages=[{
        "role": "user",
        "content": "What is the weather in San Francisco?"
    }],
    tools=[{
        "type": "web_search_20250305",
        "name": "web_search",
        "max_uses": 5
    }]
)

Anda juga dapat menggunakan kolom opsional untuk menentukan domain yang diizinkan dan diblokir. Misalnya:

tools=[{
  ...
  # Only one of allowed_domains and blocked_domains can be provided.
  # allowed_domains excludes everything except the specified domains
    "allowed_domains": ["example.com", "example.org"],

  # blocked_domains includes everything except the specified domains
  # Use the `NOT site:` search operator
    "blocked_domains": ["example.net"],
}]

Untuk mengetahui informasi selengkapnya tentang kolom opsional, lihat dokumentasi alat penelusuran web Claude

Saat model menentukan bahwa penelusuran web diperlukan, API akan memanggil alat penelusuran web hingga tidak ada lagi panggilan alat yang diperlukan. Responsnya mencakup detail tentang penelusuran perantara, dengan hasil yang dienkripsi.

Cuplikan kode berikut adalah contoh respons dengan penelusuran web:

{
  ...
  "role": "assistant",
  "content": [
    // Initial output from the model
    {
      "type": "text",
      "text": "I need to search the web to answer this question about the weather in San Francisco."
    },
    {
      "type": "server_tool_use",
      "id": "srvtoolu_9a90a390a",
      "name": "web_search",
      "input": {
        "query": "What is the weather in San Francisco?",
      }
    },
    // API sees an `</antml:function_calls>` stop sequence here, sees that
    // the tool use is for a server-side tool, and then runs that
    // tool. If there is a mix of client and server-side, the API would
    // need to return to the client and let it pass back client tool results
    // before continuing with server tools.
    {
      "type": "web_search_tool_result",
      // "name": "web_search", use this to determine what types of blocks are inside `content`
      "tool_use_id": "srvtoolu_9a90a390a",
      "content": [
        {
          "type": "web_search_result",
          "uri": "https://weather.com",
          "title": "National and Local Weather",
          "encrypted_content": "eyJlbmNyeXB0ZWRfa2V5Ijoic2VjcmV0LW...", // encrypted list of snippets from the web search provider
        },
        {
          "type": "web_search_result",
          "uri": "https://accuweather.com",
          "title": "San Francisco, CA Hourly Weather",
          "encrypted_content": "yaJlbmNyeXB0ZWRfa2V5Ijoic2VjcmV0LW...", // encrypted list of snippets from the web search provider
        },
      ],
    },
    // Server starts a new sampling run with the above content appended (unencrypted)
    // to the original request. Everything below is completion content from the
    // second sampling run.
    {
      "type": "text",
      "text": "The current weather in San Francisco, CA is 65 degrees Fahrenheit and partly cloudy."
    }
  ],
  // Server output is no longer 1-to-1 with a single sampling run. From the
  // user's perspective, there is just one "Message" with a single id
  "id": "msg_a930390d3",
  "usage": {
    "input_tokens": 3029,
    "output_tokens": 6039,
    "server_tool_use": {
      "web_search_requests": 2
    }
  },
  "stop_reason": "end_turn"
}

Streaming dengan penelusuran web

Dengan streaming yang diaktifkan, model akan menampilkan peristiwa penelusuran sebagai bagian dari streaming. Contoh:

// Claude's decision to search

event: content_block_start
data: {"type": "content_block_start", "index": 1, "content_block": {"type": "server_tool_use", "id": "srvtoolu_xyz789", "name": "web_search"}}

// Search query streamed
event: content_block_delta
data: {"type": "content_block_delta", "index": 1, "delta": {"type": "input_json_delta", "partial_json": "{\"query\":\"latest quantum computing breakthroughs 2025\"}"}}

// Pause while search executes

// Search results streamed
event: content_block_start
data: {"type": "content_block_start", "index": 2, "content_block": {"type": "web_search_tool_result", "tool_use_id": "srvtoolu_xyz789", "content": [{"type": "web_search_result", "title": "Quantum Computing Breakthroughs in 2025", "url": "https://example.com"}]}}

Penggunaan diukur dan disertakan dalam pesan message_delta, yang mencakup jumlah kumulatif item web_search. Contoh:

event: message_delta
data: {"type":"message_delta","delta":{"stop_reason":"end_turn","stop_sequence":null},"usage":{"input_tokens":10682,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"output_tokens":510,"server_tool_use":{"web_search_requests":1}}}

Fitur penelusuran web untuk Claude 4.0 dan model yang lebih baru adalah fitur opsional dari model Claude Anthropic. Anda dapat mengaktifkannya dengan menyediakan alat penelusuran web dalam permintaan. Saat Anda mengaktifkan fitur ini, Anda menginstruksikan Gemini Enterprise Agent Platform untuk mengaktifkan model Claude agar dapat mengirim kueri penelusuran yang berasal dari permintaan Anda ke penyedia layanan penelusuran pihak ketiga yang dipilih oleh Anthropic. Google tidak bertanggung jawab atas praktik pemrosesan data penyedia pihak ketiga ini. Setelah kueri penelusuran dikirim, penanganan data tersebut diatur oleh persyaratan layanan dan kebijakan privasi pihak ketiga, bukan Google.

Mengaktifkan fitur penelusuran web memiliki implikasi langsung terhadap tata kelola data dan postur keamanan Anda. Komitmen tambahan Gemini Enterprise Agent Platform, seperti Kunci enkripsi yang dikelola pelanggan (CMEK) dan Residensi Data, tidak berlaku untuk data saat diproses oleh penyedia penelusuran pihak ketiga. Jika project konsumen Anda berada di bawah perimeter VPC-SC, Vertex AI akan menolak permintaan dengan pesan error berikut:

{
  "error": {
    "code": 400,
    "message": "The requested model does not serve requests restricted by VPCSC",
    "status": "FAILED_PRECONDITION"
  }
}

Fitur ini tersedia secara eksklusif untuk Claude 4.0 dan model berikutnya; fitur ini tidak tersedia untuk model Claude yang lebih lama di Gemini Enterprise Agent Platform. Daftar layanan penelusuran pihak ketiga yang dapat dipanggil oleh fitur Anthropic Web Search jika fitur penelusuran web digunakan:

Harga

Penelusuran web diberi harga sebagai add-on untuk penggunaan API pesan standar, berdasarkan volume permintaan web. Karena panggilan pengambilan sampel tambahan, pengguna juga akan dikenai biaya untuk token input tambahan.

Untuk informasi selengkapnya, buka Harga.