Pencarian web di Azure Databricks

Halaman ini menjelaskan pencarian web di Azure Databricks dan cara menggunakannya untuk mendasarkan respons model dengan informasi real-time dari web. Pencarian web tersedia untuk model Antropik melalui Model Context Protocol (MCP).

Tip

Genie Code (mode Agen) dapat melakukan ini untuk Anda. Coba perintah contoh ini:

Query the databricks-gemini-2-5-pro model using the OpenAI client with the google_search parameter enabled, ask a question about a current event, and print the response.

Pencarian web memungkinkan model dasar untuk mengambil informasi terkini dari internet selama pembuatan respons. Ketika pencarian web diaktifkan, model dapat mencari web untuk menemukan informasi yang relevan dan memasukkannya ke dalam responsnya. Ini berguna untuk pertanyaan tentang peristiwa saat ini, data terbaru, atau topik apa pun di mana informasi real-time meningkatkan respons.

Aktifkan pencarian web untuk model Antropik dengan menggunakan server MCP pencarian web, seperti You.com dari Azure Databricks Marketplace.

Model antropis dengan MCP

Alat pencarian web asli Anthropic tidak tersedia melalui API Model Azure Databricks Foundation. Sebagai gantinya, Anda dapat menambahkan pencarian web ke model Antropik menggunakan Protokol Konteks Model (MCP) dengan penyedia pencarian seperti You.com.

Menyiapkan server MCP You.com

  1. Navigasi ke Marketplace > Agen > Server MCP di ruang kerja Azure Databricks Anda.
  2. Cari You.com dan klik Instal.
  3. Konfigurasikan koneksi:
  • Nama koneksi: Masukkan nama (misalnya, youcom_web_search).
  • Token pembawa: Masukkan kunci API You.com Anda.
  1. Klik Instal.
  2. Berikan hak istimewa USE CONNECTION kepada pengguna atau grup yang sesuai di bawah >.

Setelah disiapkan, server MCP tersedia sebagai alat di AI Playground, agen, dan klien lain yang kompatibel dengan MCP. URL titik akhir proksi untuk koneksi Anda adalah:

https://<workspace_host>.databricks.com/api/2.0/mcp/external/<connection_name>

Gunakan dengan Kode Claude

Jika Anda menggunakan Claude Code dengan AZURE DATABRICKS Foundation Model API, tambahkan server MCP You.com untuk mengaktifkan pencarian web:

claude mcp add youcom-search \
  --transport http \
  --url "https://<workspace_host>.databricks.com/api/2.0/mcp/external/<connection_name>" \
  --header "Authorization: Bearer <your-databricks-pat>"

Verifikasi bahwa server ditambahkan dengan claude mcp list.

Atau, tambahkan server langsung ke ~/.claude.json:

{
  "mcpServers": {
    "youcom-search": {
      "type": "http",
      "url": "https://<workspace_host>.databricks.com/api/2.0/mcp/external/<connection_name>",
      "headers": {
        "Authorization": "Bearer <your-databricks-pat>"
      }
    }
  }
}

Model yang didukung

Model antropik (melalui MCP)

Pencarian web melalui MCP didukung pada semua model fondasi Antropik yang mendukung penggunaan alat.

  • databricks-claude-sonnet-4-6
  • databricks-claude-sonnet-4-5
  • databricks-claude-opus-4-7
  • databricks-claude-opus-4-6
  • databricks-claude-opus-4-5
  • databricks-claude-opus-4-1
  • databricks-claude-sonnet-4

Privasi dan penyimpanan data

Ketika Anda mengaktifkan pencarian web melalui API Model Azure Databricks Foundation, pencarian berjalan pada endpoint model foundation yang dihosting Azure Databricks. Kueri pencarian dan hasilnya diproses oleh model yang dihosting tanpa memandang model mana yang dipanggil aplikasi Anda. Ketentuan perlindungan data dan retensi yang sama yang mengatur Model Serving berlaku untuk permintaan ini:

  • Azure Databricks tidak menggunakan input yang dikirim ke Model Serving, atau output darinya, untuk melatih model. Lihat Perlindungan data Model Served.
  • Setiap penyimpanan sementara untuk deteksi penyalahgunaan disimpan di wilayah yang sama dengan ruang kerja Anda dan dibatasi waktu. Lihat Retensi Data.

Model ini merumuskan kueri pencarian dari prompt Anda dan mengirimkannya ke penyedia pencarian eksternal untuk mengambil hasil. Perlakukan konten prompt yang sampai ke pencarian web sebagai data yang keluar dari Azure Databricks untuk penyedia pencarian, dan sesuaikan cakupan apa yang dikirim aplikasi Anda.

Keterbatasan

  • Pencarian web hanya tersedia di titik akhir model fondasi bayar per token. Titik akhir throughput yang disediakan tidak mendukung pencarian web.
  • Pencarian web tidak tersedia untuk ruang kerja dengan kepatuhan HIPAA/BAA diaktifkan karena kueri pencarian web dikirim ke layanan pencarian eksternal yang tidak mematuhi HIPAA.
  • Hasil pencarian web bergantung pada kemampuan model untuk merumuskan kueri pencarian dan mensintesis hasil. Kualitas respons dapat bervariasi.

Sumber daya tambahan

  • Last updated on