Grounding dengan Penelusuran Web Paralel

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

Grounding dengan Parallel di Gemini Enterprise Agent Platform adalah Penawaran Terpisah (sebagaimana ditentukan dalam Perjanjian Anda) yang menghubungkan model Gemini ke data web publik yang disediakan oleh Parallel Web Systems' search API. Google Cloud Layanan ini memberi Gemini akses ke informasi langsung dari miliaran halaman web untuk memastikan respons yang lebih terbaru dan faktual.

Kasus penggunaan

Perujukan dengan Paralel cocok untuk kasus penggunaan seperti berikut:

  • Menggunakan data web untuk tujuan pelengkapan atau pengayaan informasi.
  • Agen multi-hop yang memerlukan penelusuran web lebih mendalam untuk pertanyaan yang lebih kompleks.
  • Membangun API yang mengintegrasikan data penelusuran web.
  • Asisten yang berinteraksi dengan 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) mendapatkan konteks terbaru dari web.

Contoh

Siapa yang memenangkan F1 Grand Prix Las Vegas 2025?

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

Model yang didukung

Grounding dengan Penelusuran web paralel 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 Grounding dengan Penelusuran Web Paralel, Anda harus menyiapkan akses Anda. Anda memiliki dua opsi:

  • Berlangganan langsung ke Perujukan dengan Penelusuran Web Paralel di Google Cloud Marketplace untuk integrasi yang lancar dalam lingkungan cloud yang ada. Penawaran Retensi Data Nol juga tersedia untuk workload sensitif. Untuk menggunakan ZDR, Anda harus berlangganan penawaran ZDR dan menetapkan tanda enable_zero_data_retention yang sesuai dalam permintaan API Anda.

  • Gunakan kunci Parallel API yang ada.

Berlangganan di Google Cloud Marketplace (direkomendasikan)

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

Membawa kunci API Anda sendiri

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

Mendasari respons Gemini dengan Parallel

Minta respons yang memiliki rujukan dari Gemini menggunakan Agent Studio di konsol, Google Gen AI SDK, atau REST API. Google Cloud Untuk performa terbaik, sebaiknya gunakan setelan default untuk parameter opsional, kecuali jika Anda benar-benar memerlukan nilai non-default.

Jika Anda berlangganan Grounding with Parallel Web Search di Google Cloud Marketplace, pastikan akun penagihan yang digunakan untuk langganan Anda aktif diGoogle Cloud project Anda.

Sebelum menjalankan contoh, selesaikan prasyarat, termasuk berlangganan di Google Cloud Marketplace atau memberikan kunci Parallel API.

Setiap contoh SDK membaca project dan lokasi Anda dari variabel lingkungan yang ditampilkan di tabnya. Dalam kode contoh, ganti MODEL_ID dengan ID model yang didukung, seperti gemini-2.5-flash.

Konsol

Untuk mendasari respons Gemini dengan Penelusuran Web Paralel menggunakan Agent Studio di Gemini Enterprise Agent Platform, ikuti langkah-langkah berikut:

  1. Di konsol Google Cloud , buka halaman Agent Studio.

    Buka Agent Studio

  2. Di panel samping, di bagian Setelan model, di bagian Grounding, aktifkan tombol Partner (Hasil penelusuran dari partner grounding).

  3. Pilih Parallel Web Search sebagai partner perujukan, lalu klik Terapkan. Untuk menggunakan Penelusuran Web Paralel, Anda harus berlangganan terlebih dahulu di Google Cloud Marketplace.

  4. Masukkan perintah Anda di kotak teks, lalu kirimkan.

Respons perintah Anda kini menggunakan Grounding dengan Penelusuran Web Paralel.

Python

Instal

pip install --upgrade google-genai

Untuk mempelajari lebih lanjut, lihat dokumentasi referensi SDK.

Tetapkan variabel lingkungan untuk menggunakan Google Gen AI SDK dengan Vertex AI: 

# Replace the `GOOGLE_CLOUD_PROJECT` and `GOOGLE_CLOUD_LOCATION` values
# with appropriate values for your project.
export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT
export GOOGLE_CLOUD_LOCATION=global
export GOOGLE_GENAI_USE_ENTERPRISE=True
 

from google import genai
from google.genai import types

client = genai.Client()

response = client.models.generate_content(
    model="MODEL_ID",
    contents="Who won the 2025 Las Vegas F1 Grand Prix?",
    config=types.GenerateContentConfig(
        tools=[
            types.Tool(
                parallel_ai_search=types.ToolParallelAiSearch(
                    # Optional. Omit api_key if you subscribed to Grounding with
                    # Parallel Web Search on Google Cloud Marketplace. Otherwise,
                    # provide your Parallel API key.
                    # api_key="API_KEY",
                    # Optional. Customize the search. See the REST tab for the
                    # full list of supported parameters. Keys inside custom_configs
                    # are Parallel.ai Search API params (snake_case).
                    custom_configs={
                        "mode": "basic",
                        "max_results": 10,
                        "source_policy": {"include_domains": ["wikipedia.org"]},
                    },
                )
            )
        ],
    ),
)

print(response.text)
# Example response:
# Max Verstappen won the 2025 Las Vegas F1 Grand Prix ...

# The grounding metadata contains the web sources used to ground the response.
print(response.candidates[0].grounding_metadata.grounding_chunks)

Untuk menyesuaikan penelusuran, tetapkan kolom custom_configs dari ToolParallelAiSearch. Kolom ini menerima parameter opsional yang sama yang dijelaskan di tab REST, seperti source_policy, excerpts, max_results, dan mode.

Java

Pelajari cara menginstal atau mengupdate Java.

Untuk mempelajari lebih lanjut, lihat dokumentasi referensi SDK.

Tetapkan variabel lingkungan untuk menggunakan Google Gen AI SDK dengan Vertex AI: 

# Replace the `GOOGLE_CLOUD_PROJECT` and `GOOGLE_CLOUD_LOCATION` values
# with appropriate values for your project.
export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT
export GOOGLE_CLOUD_LOCATION=global
export GOOGLE_GENAI_USE_ENTERPRISE=True
 

import com.google.genai.Client;
import com.google.genai.types.GenerateContentConfig;
import com.google.genai.types.GenerateContentResponse;
import com.google.genai.types.Tool;
import com.google.genai.types.ToolParallelAiSearch;
import java.util.List;
import java.util.Map;

public class ParallelGroundingSample {
  public static void main(String[] args) {
    try (Client client = Client.builder().build()) {

      GenerateContentConfig config =
          GenerateContentConfig.builder()
              .tools(
                  // Omit apiKey if you subscribed to Grounding with Parallel Web
                  // Search on Google Cloud Marketplace. Otherwise, set apiKey to
                  // your Parallel API key.
                  Tool.builder()
                      .parallelAiSearch(
                          ToolParallelAiSearch.builder()
                              // Optional. Customize the search. See the REST tab
                              // for the full list of supported parameters. Keys
                              // inside customConfigs are Parallel.ai Search API
                              // params (snake_case).
                              .customConfigs(
                                  Map.of(
                                      "mode", "basic",
                                      "max_results", 10,
                                      "source_policy",
                                      Map.of(
                                          "include_domains",
                                          List.of("wikipedia.org"))))
                              .build())
                      .build())
              .build();

      GenerateContentResponse response =
          client.models.generateContent(
              "MODEL_ID", "Who won the 2025 Las Vegas F1 Grand Prix?", config);

      System.out.println(response.text());
    }
  }
}

Untuk menyesuaikan penelusuran, tetapkan kolom customConfigs dari ToolParallelAiSearch. Kolom ini menerima parameter opsional yang sama yang dijelaskan di tab REST, seperti source_policy, excerpts, max_results, dan mode.

Node.js

Instal

npm install @google/genai

Untuk mempelajari lebih lanjut, lihat dokumentasi referensi SDK.

Tetapkan variabel lingkungan untuk menggunakan Google Gen AI SDK dengan Vertex AI: 

# Replace the `GOOGLE_CLOUD_PROJECT` and `GOOGLE_CLOUD_LOCATION` values
# with appropriate values for your project.
export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT
export GOOGLE_CLOUD_LOCATION=global
export GOOGLE_GENAI_USE_ENTERPRISE=True
 

import {GoogleGenAI} from '@google/genai';

const ai = new GoogleGenAI({});

const response = await ai.models.generateContent({
  model: 'MODEL_ID',
  contents: 'Who won the 2025 Las Vegas F1 Grand Prix?',
  config: {
    tools: [
      // Omit apiKey if you subscribed to Grounding with Parallel Web Search on
      // Google Cloud Marketplace. Otherwise, set apiKey to your Parallel API key.
      {
        parallelAiSearch: {
          // Optional. Customize the search. See the REST tab for the full
          // list of supported parameters. Keys inside customConfigs are
          // Parallel.ai Search API params (snake_case).
          customConfigs: {
            mode: 'basic',
            max_results: 10,
            source_policy: {include_domains: ['wikipedia.org']},
          },
        },
      },
    ],
  },
});

console.log(response.text);

Untuk menyesuaikan penelusuran, tetapkan kolom customConfigs alat parallelAiSearch. Kolom ini menerima parameter opsional yang sama yang dijelaskan di tab REST, seperti source_policy, excerpts, max_results, dan mode.

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 Google Cloud Anda.
  • MODEL_ID: ID model yang akan digunakan.
  • TEXT: Perintah teks yang akan dikirim ke model.
  • API_KEY: Kunci API Anda untuk Parallel Web Search. Jika Anda menentukan kunci API dan juga berlangganan Grounding dengan Penelusuran Web Paralel di Google Cloud Marketplace, kunci API akan lebih diutamakan.
  • ENABLE_ZERO_DATA_RETENTION: Opsional: Beralih ke versi ZDR dari Penelusuran Web Paralel 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, nilai defaultnya adalah versi standar. Versi ZDR hanya tersedia melalui Google Cloud Marketplace.
  • EXCLUDE_DOMAINS: Opsional: Daftar domain yang akan dikecualikan dari sumber perujukan. Jika ditentukan, sumber dari domain ini akan dikecualikan. Nilai yang dapat diterima adalah domain (www.example.com) atau ekstensi domain yang diawali dengan titik ( .gov, .edu, .co.uk). Anda dapat menentukan hingga 200 domain.
  • INCLUDE_DOMAINS: Opsional: Daftar domain yang akan disertakan dalam sumber perujukan. Jika ditentukan, sumber dari domain ini akan disertakan. Nilai yang dapat diterima adalah domain (www.example.com) atau ekstensi domain yang diawali 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 total karakter maksimum dari semua kutipan hasil penelusuran. Jika tidak ditentukan, nilai defaultnya adalah 100000. Rentang yang diizinkan adalah [1000, 1000000].
  • MAX_RESULTS: Opsional: Jumlah maksimum hasil penelusuran yang akan digunakan untuk perujukan. Jika tidak ditentukan, nilai 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:

Anda akan melihat respons JSON yang mirip seperti berikut:

Kuota

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

  • Jika Anda berlangganan Grounding dengan Penelusuran Web Paralel di Google Cloud Marketplace: Hubungi tim akun Google Anda.

  • Jika Anda memberikan kunci API Anda sendiri: Hubungi support@parallel.ai dan tim Akun Google Anda.

Penagihan

Penggunaan Grounding dengan Penelusuran Web Paralel akan dikenai biaya berikut:

  • Penggunaan token Gemini: Anda dapat ditagih untuk:

    • Token perintah
    • Token penalaran
    • Token output

    Untuk informasi selengkapnya, buka Harga.

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

  • Harga untuk penggunaan Parallel Web Search API:

    • Jika Anda berlangganan Grounding dengan Penelusuran Web Paralel di Google Cloud Marketplace, lihat bagian Harga paralel di Google Cloud Marketplace untuk mengetahui informasi selengkapnya.

    • Jika Anda memberikan kunci API Anda sendiri, lihat Situs paralel untuk mengetahui informasi selengkapnya.