Grounding dengan Penelusuran Web Paralel

Pratinjau

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Parallel Web Systems menawarkan Search API yang menyediakan akses ke data web yang tersedia secara publik dan dioptimalkan untuk digunakan oleh model bahasa besar untuk perujukan (grounding). Halaman ini menjelaskan cara merujuk (grounding) respons Gemini menggunakan Parallel.

Perujukan (Grounding) dengan Parallel di Platform Agen Gemini Enterprise adalah Penawaran Terpisah (sebagaimana ditentukan dalam your Google Cloud Agreement) yang menghubungkan model Gemini ke data web publik yang disediakan oleh Search API Parallel Web Systems. Layanan ini memberi Gemini akses ke informasi langsung dari miliaran halaman web untuk memastikan respons yang lebih baru dan faktual.

Catatan: Untuk penayang web, perujukan (grounding) dengan Parallel di Gemini Enterprise Agent Platform tidak menggunakan halaman web untuk perujukan (grounding) yang telah menolak ShapBot. Penayang web dapat mengelola penolakan mereka dengan file robots.txt.

Kasus penggunaan

Perujukan (Grounding) dengan Parallel cocok untuk kasus penggunaan seperti berikut:

• Menggunakan data web untuk tujuan penyelesaian atau pengayaan informasi.
• Agen multi-hop yang memerlukan penelusuran web lebih mendalam untuk pertanyaan yang lebih kompleks.
• Membuat API yang mengintegrasikan data penelusuran web.
• Asisten yang digunakan karyawan yang memungkinkan pengguna akhir mengajukan pertanyaan dan membuat laporan kompleks menggunakan informasi web terbaru.
• Aplikasi yang ditujukan untuk konsumen, seperti retail dan perjalanan, yang memungkinkan pengguna membuat keputusan pembelian yang tepat.
• Agen otomatis yang berjalan secara mandiri untuk melakukan tugas otomatis, seperti analisis berita dan pemeriksaan KYC.
• Agen vertikal (agen penjualan, agen coding, agen keuangan) yang mendapatkan konteks terbaru dari web.

Contoh

Siapa yang memenangkan Grand Prix F1 Las Vegas 2025?

Tanpa Perujukan (Grounding)	Dengan Perujukan (Grounding)
Grand Prix Las Vegas 2025 belum terjadi. Balapan dijadwalkan akan berlangsung pada akhir pekan 20-22 November 2025. Oleh karena itu, pemenangnya tidak diketahui.	Pemenang Grand Prix F1 Las Vegas 2025 adalah Max Verstappen dari Red Bull Racing. Balapan berlangsung pada 22 November 2025. Sumber: domain1.com, domain2.com, ...

Model yang didukung

Perujukan (Grounding) dengan penelusuran web Parallel didukung oleh model berikut:

• Gemini 2.5 Flash (gemini-2.5-flash)
• Gemini 2.5 Flash-Lite (gemini-2.5-flash-lite)
• Gemini 2.5 Pro (gemini-2.5-pro)
• Gemini 3.1 Pro (gemini-3.1-pro-preview)
• Gemini 3.1 Flash Lite (gemini-3.1-flash-lite)
• Gemini 3.5 Flash (gemini-3.5-flash)

Sebelum memulai

Untuk menggunakan Perujukan (Grounding) dengan Penelusuran Web Parallel, Anda harus menyiapkan akses. Anda memiliki dua opsi:

• Berlangganan langsung ke Perujukan (Grounding) dengan Penelusuran Web Parallel di Google Cloud Marketplace (Pratinjau) untuk integrasi yang disederhanakan dalam lingkungan cloud yang ada. Penawaran Retensi Data Nol juga tersedia untuk beban kerja sensitif. Untuk menggunakan ZDR, Anda harus berlangganan penawaran ZDR dan menetapkan flag enable_zero_data_retention yang sesuai dalam permintaan API Anda.

• Menggunakan kunci API Parallel yang ada.

Berlangganan di Google Cloud Marketplace (direkomendasikan)

Pratinjau

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Dengan mengintegrasikan melalui Google Cloud Marketplace, Anda dapat mengelola layanan Perujukan (Grounding) dengan Penelusuran Web Parallel secara langsung di dalam Google Cloud. Untuk memulai, berlangganan layanan Perujukan (Grounding) dengan Penelusuran Web Parallel di Google Cloud Marketplace, setujui persyaratan layanan, dan tinjau harga.

Catatan: Saat Anda berlangganan Perujukan (Grounding) dengan Penelusuran Web Parallel di Google Cloud Marketplace, Google Cloud diperlukan untuk mengirim data tertentu, seperti kueri yang berasal dan ditulis ulang dari perintah pengguna asli, ke Penelusuran Web Parallel untuk diproses. Penggunaan layanan Penelusuran Web Parallel oleh Anda diatur oleh persyaratan penggunaan Google Cloud Marketplace untuk Penelusuran Web Parallel.

Membawa kunci API Anda sendiri

Jika Anda lebih suka mengelola penagihan dan akses API Parallel secara terpisah, Anda dapat memberikan kunci API Anda sendiri. Untuk menggunakan metode ini, Anda harus mendapatkan kunci API dari platform developer Parallel. Kunci API ini digunakan langsung dalam permintaan REST API Anda ke Gemini.

Catatan: Saat Anda membawa kunci API Anda sendiri, Google Cloud diperlukan untuk mengirim data tertentu, seperti kueri yang berasal dan ditulis ulang dari perintah pengguna asli, ke Penelusuran Web Parallel untuk diproses. Penggunaan layanan Penelusuran Web Parallel oleh Anda diatur oleh persyaratan penggunaan dan kebijakan penggunaan yang dapat diterima.

Merujuk (Grounding) respons Gemini dengan Parallel

Minta respons yang dirujuk (grounded) dari Gemini menggunakan REST API sebagai berikut. Untuk performa terbaik, sebaiknya gunakan setelan default untuk parameter opsional kecuali jika Anda benar-benar memerlukan nilai non-default.

Jika Anda berlangganan Perujukan (Grounding) dengan Penelusuran Web Parallel di Google Cloud Marketplace (Pratinjau), pastikan akun penagihan yang digunakan untuk langganan Anda aktif di Google Cloud project Anda.

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• LOCATION: Region untuk memproses permintaan. Untuk menggunakan endpoint global, kecualikan lokasi dari nama endpoint dan konfigurasi lokasi resource ke `global`.
• PROJECT_ID: Project ID Anda Google Cloud .
• MODEL_ID: ID model yang akan digunakan.
• TEXT: Perintah teks yang akan dikirim ke model.
• API_KEY: Kunci API Anda untuk Penelusuran Web Parallel. Jika Anda menentukan kunci API dan juga berlangganan Perujukan (Grounding) dengan Penelusuran Web Parallel di Google Cloud Marketplace (Pratinjau), kunci API akan diprioritaskan.
• ENABLE_ZERO_DATA_RETENTION: Opsional: Beralih ke versi ZDR Penelusuran Web Parallel untuk mengaktifkan Retensi Data Nol pada beban kerja sensitif. Tetapkan ke true untuk menggunakan penawaran ZDR untuk permintaan Anda. Anda harus berlangganan penawaran khusus ZDR agar permintaan ini berhasil. Jika tidak ditentukan, setelan defaultnya adalah versi standar. Versi ZDR hanya tersedia melalui Google Cloud Marketplace.
• EXCLUDE_DOMAINS: Opsional: Daftar domain yang akan dikecualikan dari sumber perujukan (grounding). Jika ditentukan, sumber dari domain ini akan dikecualikan. Nilai yang dapat diterima adalah domain (www.example.com) atau ekstensi domain yang dimulai dengan titik ( .gov, .edu, .co.uk). Anda dapat menentukan hingga 200 domain.
• INCLUDE_DOMAINS: Opsional: Daftar domain yang akan disertakan dalam sumber perujukan (grounding). Jika ditentukan, sumber dari domain ini akan disertakan. Nilai yang dapat diterima adalah domain (www.example.com) atau ekstensi domain yang dimulai dengan titik ( .gov, .edu, .co.uk). Anda dapat menentukan hingga 200 domain.
• MAX_CHARS_PER_RESULT: Opsional: Jumlah maksimum karakter yang akan disertakan dalam setiap kutipan hasil penelusuran. Jika tidak ditentukan, setelan defaultnya adalah 30000. Rentang yang diizinkan adalah [1000, 100000].
• MAX_CHARS_TOTAL: Opsional: Jumlah maksimum total karakter dari semua kutipan hasil penelusuran. Jika tidak ditentukan, setelan defaultnya adalah 100000. Rentang yang diizinkan adalah [1000, 1000000].
• MAX_RESULTS: Opsional: Jumlah maksimum hasil penelusuran yang akan digunakan untuk perujukan (grounding). Jika tidak ditentukan, setelan defaultnya adalah 10. Rentang yang diizinkan adalah [1, 20].
• MODE: Opsional: Mode yang akan digunakan untuk permintaan, baik basic maupun advanced. Defaultnya adalah basic. Pertimbangkan mode advanced jika Anda menginginkan hasil penelusuran yang lebih menyeluruh dengan mengorbankan latensi yang lebih tinggi.
• SEARCH_LOCATION: Opsional: Kode negara ISO 3166-1 alpha-2 untuk hasil penelusuran yang ditargetkan secara geografis. Contoh: "us".

Metode HTTP dan URL:

POST https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:generateContent

Meminta isi JSON:

{
  "contents": [{
    "role": "user",
    "parts": [{
      "text": "TEXT"
    }]
  }],
  "tools": [{
    "parallelAiSearch": {
        "api_key": "API_KEY",
        "enable_zero_data_retention": ENABLE_ZERO_DATA_RETENTION,
        "customConfigs": {
            "mode": "MODE",
            "location": "SEARCH_LOCATION",
            "max_results": MAX_RESULTS,
            "source_policy": {
                "exclude_domains": ["EXCLUDE_DOMAINS"],
                "include_domains": ["INCLUDE_DOMAINS"]
            },
            "excerpts": {
                "max_chars_per_result": MAX_CHARS_PER_RESULT,
                "max_chars_total": MAX_CHARS_TOTAL
            }
        }
    }
}],
  "model": "projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID"
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:generateContent"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:generateContent" | Select-Object -Expand Content

Anda akan melihat respons JSON yang mirip seperti berikut:

Respons

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "The most recent Super Bowl was Super Bowl LIX (59), which was played in 2025. The winner of Super Bowl LIX was the **Philadelphia Eagles**, who defeated the Kansas City Chiefs with a score of 40-22."
          }
        ]
      },
      "finishReason": "STOP",
      "groundingMetadata": {
        "webSearchQueries": [
          "who won the last super bowl"
        ],
        "groundingChunks": [
          {
            "web": {
              "uri": "https://...",
              "title": "Super Bowl LIX",
              "domain": "domain.com"
            }
          },
          {
            "web": {
              "uri": "https://...",
              "title": "Super Bowl LIX Results",
              "domain": "domain.com"
            }
          }
        ],
        "groundingSupports": [
          {
            "segment": {
              "endIndex": 77,
              "text": "The most recent Super Bowl was Super Bowl LIX (59), which was played in 2025."
            },
            "groundingChunkIndices": [
              0,
              1
            ]
          },
          {
            "segment": {
              "startIndex": 78,
              "endIndex": 198,
              "text": "The winner of Super Bowl LIX was the **Philadelphia Eagles**, who defeated the Kansas City Chiefs with a score of 40-22."
            },
            "groundingChunkIndices": [
              0
            ]
          },
        ]
      }
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 33,
    "candidatesTokenCount": 106,
    "totalTokenCount": 284,
    "billablePromptUsage": {
      "textCount": 142
    },
    "trafficType": "ON_DEMAND",
    "promptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 33
      }
    ],
    "candidatesTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 106
      }
    ],
    "toolUsePromptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 39
      }
    ],
    "toolUsePromptTokenCount": 39,
    "thoughtsTokenCount": 106
  },
  "modelVersion": "MODEL_VERSION",
  "createTime": "CREATE_TIME",
  "responseId": "RESPONSE_ID"
}

Quota

Kuota default adalah 200 perintah per menit. Untuk meminta peningkatan batas frekuensi Anda, berikan kasus penggunaan dan persyaratan Anda kepada kontak yang sesuai:

• Jika Anda berlangganan Perujukan (Grounding) dengan Penelusuran Web Parallel di Google Cloud Marketplace (Pratinjau): Hubungi tim akun Google Anda.

• Jika Anda memberikan kunci API Anda sendiri: Hubungi [e-mail] dan tim akun Google Anda.

Penagihan

Penggunaan Perujukan (Grounding) dengan Penelusuran Web Parallel akan dikenai biaya berikut:

• Penggunaan token Gemini: Anda dapat ditagih untuk:

  • Token perintah
  • Token penalaran
  • Token output

  Untuk informasi selengkapnya, buka Harga.

• Perujukan (Grounding) Gemini dengan data Anda: Untuk mengetahui informasi selengkapnya, lihat Harga.

• Harga untuk penggunaan Parallel Web Search API:

  • Jika Anda berlangganan Perujukan (Grounding) dengan Penelusuran Web Parallel di Google Cloud Marketplace (Pratinjau), lihat bagian harga Parallel di Google Cloud Marketplace untuk mengetahui informasi selengkapnya.

  • Jika Anda memberikan kunci API Anda sendiri, lihat situs Parallel untuk mengetahui informasi selengkapnya.