Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Grounding dengan penelusuran web Exa

Exa menyediakan API penelusuran yang memberikan akses ke data web yang tersedia secara publik dan dioptimalkan untuk grounding respons model bahasa besar. Halaman ini menjelaskan cara melakukan grounding pada respons Gemini menggunakan Exa.

Grounding dengan penelusuran web Exa di Gemini Enterprise Agent Platform adalah Penawaran Terpisah (sebagaimana didefinisikan dalam Perjanjian Google Cloud Anda) yang menghubungkan model Gemini ke data web publik yang disediakan oleh API penelusuran Exa.

Kasus penggunaan

Grounding dengan Exa meningkatkan akurasi dan mengurangi halusinasi dengan memberi model akses ke data web yang relevan dan terbaru. Kasus penggunaan umum mencakup:

Agen dan chatbot umum: Mengambil informasi terbaru untuk menghasilkan jawaban yang lebih andal.
Agen riset: Melakukan riset deep web dari berbagai sumber.
Agen coding: Mengambil cuplikan kode, dokumen, dan referensi teknis terbaru.
Agen suara: Pengambilan web untuk mendukung interaksi suara real-time dengan latensi rendah.
Agen khusus vertikal: Mengambil informasi terbaru dan khusus domain yang disesuaikan dengan industri atau vertikal pengetahuan tertentu.
Pengayaan data: Tingkatkan kualitas set data internal dengan konteks dan metadata web saat ini.
Alur kerja otomatis: Secara berkala mengumpulkan berita, orang, perusahaan, atau data lain yang sering diperbarui untuk alur kerja internal atau produksi.

Contoh

Siapa yang memenangkan Superbowl 2026?

Tanpa Grounding	Dengan Grounding
Saya tidak dapat memberi tahu Anda siapa yang memenangkan Super Bowl 2026 karena acara tersebut belum berlangsung.	Seattle Seahawks memenangkan Super Bowl LX pada 8 Februari 2026, mengalahkan New England Patriots dengan skor akhir 29-13. Sumber: domain1.com, domain2.com, ...

Model yang didukung

Bagian ini mencantumkan model yang mendukung grounding dengan penelusuran web Exa.

Klik untuk meluaskan model yang didukung

Sebelum memulai

Untuk menggunakan Perujukan dengan Exa, Anda harus mendapatkan kunci API dari situs Exa. Kunci API ini digunakan dalam permintaan Anda ke Gemini.

Memperkuat respons Gemini dengan Exa

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

Sebelum menjalankan contoh, selesaikan prasyarat, termasuk mendapatkan kunci API Exa.

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

Sebelum menjalankan contoh, lakukan penggantian berikut:

MODEL_ID: ID model yang didukung untuk digunakan, seperti gemini-2.5-flash.
TEXT: Perintah teks yang akan dikirim ke model.
API_KEY: Kunci API Anda untuk penelusuran web Exa.
SEARCH_TYPE: Opsional: Jenis penelusuran Exa yang akan dijalankan. Nilai yang didukung adalah fast dan instant. Nilai defaultnya adalah fast, yang memberikan hasil komprehensif dengan latensi yang lebih rendah dan sangat cocok untuk penelusuran yang ditampilkan kepada pengguna dan alur kerja interaktif. Gunakan instant untuk pengalaman yang memerlukan latensi terendah, seperti chat, agen suara, dan pelengkapan otomatis; hal ini meminimalkan waktu respons dengan memprioritaskan kecepatan daripada kedalaman penelusuran.
EXCLUDE_DOMAINS: Opsional: Daftar domain yang akan dikecualikan dari hasil penelusuran. Jika ditentukan, tidak ada hasil yang ditampilkan dari domain ini. Untuk mengecualikan lebih dari satu domain, tambahkan setiap domain sebagai string yang dikutip terpisah dalam daftar (misalnya, ["example.com", "example.net"]). Anda dapat menentukan hingga 1.200 domain.
INCLUDE_DOMAINS: Opsional: Daftar domain yang akan disertakan dalam penelusuran. Jika ditentukan, hasil hanya berasal dari domain ini. Untuk menyertakan lebih dari satu domain, tambahkan setiap domain sebagai string yang dikutip terpisah dalam daftar (misalnya, ["example.com", "example.net"]). Anda dapat menentukan hingga 1.200 domain.
MAX_CHARACTERS: Opsional: Jumlah maksimum karakter yang akan ditampilkan untuk sorotan. Mengontrol total panjang teks sorotan yang ditampilkan per URL.
NUM_RESULTS: Opsional: Jumlah maksimum hasil penelusuran yang akan digunakan untuk grounding. Jika tidak ditentukan, setelan defaultnya adalah 5.

from google import genai
from google.genai import types

client = genai.Client()

response = client.models.generate_content(
    model="MODEL_ID",
    contents="TEXT",
    config=types.GenerateContentConfig(
        tools=[
            types.Tool(
                exa_ai_search=types.ToolExaAiSearch(
                    # Required. Your API key for Exa web search.
                    api_key="API_KEY",
                    # Optional. Customize the search. Click a placeholder to
                    # enter a value, or remove the line to accept the default.
                    custom_configs={
                        "type": "SEARCH_TYPE",
                        "excludeDomains": ["EXCLUDE_DOMAINS"],
                        "includeDomains": ["INCLUDE_DOMAINS"],
                        "contents": {
                            "highlights": {
                                "maxCharacters": MAX_CHARACTERS,
                            },
                        },
                        "numResults": NUM_RESULTS,
                    },
                )
            )
        ],
    ),
)

print(response.text)

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

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

Sebelum menjalankan contoh, lakukan penggantian berikut:

MODEL_ID: ID model yang didukung untuk digunakan, seperti gemini-2.5-flash.
TEXT: Perintah teks yang akan dikirim ke model.
API_KEY: Kunci API Anda untuk penelusuran web Exa.
SEARCH_TYPE: Opsional: Jenis penelusuran Exa yang akan dijalankan. Nilai yang didukung adalah fast dan instant. Nilai defaultnya adalah fast, yang memberikan hasil komprehensif dengan latensi yang lebih rendah dan sangat cocok untuk penelusuran yang ditampilkan kepada pengguna dan alur kerja interaktif. Gunakan instant untuk pengalaman yang memerlukan latensi terendah, seperti chat, agen suara, dan pelengkapan otomatis; hal ini meminimalkan waktu respons dengan memprioritaskan kecepatan daripada kedalaman penelusuran.
EXCLUDE_DOMAINS: Opsional: Daftar domain yang akan dikecualikan dari hasil penelusuran. Jika ditentukan, tidak ada hasil yang ditampilkan dari domain ini. Untuk mengecualikan lebih dari satu domain, tambahkan setiap domain sebagai string yang dikutip terpisah dalam daftar (misalnya, ["example.com", "example.net"]). Anda dapat menentukan hingga 1.200 domain.
INCLUDE_DOMAINS: Opsional: Daftar domain yang akan disertakan dalam penelusuran. Jika ditentukan, hasil hanya berasal dari domain ini. Untuk menyertakan lebih dari satu domain, tambahkan setiap domain sebagai string yang dikutip terpisah dalam daftar (misalnya, ["example.com", "example.net"]). Anda dapat menentukan hingga 1.200 domain.
MAX_CHARACTERS: Opsional: Jumlah maksimum karakter yang akan ditampilkan untuk sorotan. Mengontrol total panjang teks sorotan yang ditampilkan per URL.
NUM_RESULTS: Opsional: Jumlah maksimum hasil penelusuran yang akan digunakan untuk perujukan. Jika tidak ditentukan, setelan defaultnya adalah 5.

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.ToolExaAiSearch;
import java.util.List;
import java.util.Map;

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

      GenerateContentConfig config =
          GenerateContentConfig.builder()
              .tools(
                  Tool.builder()
                      .exaAiSearch(
                          ToolExaAiSearch.builder()
                              // Required. Your API key for Exa web search.
                              .apiKey("API_KEY")
                              // Optional. Customize the search. Click a
                              // placeholder to enter a value, or remove the
                              // entry to accept the default.
                              .customConfigs(
                                  Map.of(
                                      "type", "SEARCH_TYPE",
                                      "excludeDomains",
                                      List.of("EXCLUDE_DOMAINS"),
                                      "includeDomains",
                                      List.of("INCLUDE_DOMAINS"),
                                      "contents",
                                      Map.of(
                                          "highlights",
                                          Map.of(
                                              "maxCharacters",
                                              MAX_CHARACTERS)),
                                      "numResults", NUM_RESULTS))
                              .build())
                      .build())
              .build();

      GenerateContentResponse response =
          client.models.generateContent(
              "MODEL_ID", "TEXT", config);

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

      // The grounding metadata contains the web sources used to ground the response.
      System.out.println(
          response.candidates().get().get(0).groundingMetadata().get().groundingChunks().get());
    }
  }
}

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

Sebelum menjalankan contoh, lakukan penggantian berikut:

MODEL_ID: ID model yang didukung untuk digunakan, seperti gemini-2.5-flash.
TEXT: Perintah teks yang akan dikirim ke model.
API_KEY: Kunci API Anda untuk penelusuran web Exa.
SEARCH_TYPE: Opsional: Jenis penelusuran Exa yang akan dijalankan. Nilai yang didukung adalah fast dan instant. Nilai defaultnya adalah fast, yang memberikan hasil komprehensif dengan latensi yang lebih rendah dan sangat cocok untuk penelusuran yang ditampilkan kepada pengguna dan alur kerja interaktif. Gunakan instant untuk pengalaman yang memerlukan latensi terendah, seperti chat, agen suara, dan pelengkapan otomatis; hal ini meminimalkan waktu respons dengan memprioritaskan kecepatan daripada kedalaman penelusuran.
EXCLUDE_DOMAINS: Opsional: Daftar domain yang akan dikecualikan dari hasil penelusuran. Jika ditentukan, tidak ada hasil yang ditampilkan dari domain ini. Untuk mengecualikan lebih dari satu domain, tambahkan setiap domain sebagai string yang dikutip terpisah dalam daftar (misalnya, ["example.com", "example.net"]). Anda dapat menentukan hingga 1.200 domain.
INCLUDE_DOMAINS: Opsional: Daftar domain yang akan disertakan dalam penelusuran. Jika ditentukan, hasil hanya berasal dari domain ini. Untuk menyertakan lebih dari satu domain, tambahkan setiap domain sebagai string yang dikutip terpisah dalam daftar (misalnya, ["example.com", "example.net"]). Anda dapat menentukan hingga 1.200 domain.
MAX_CHARACTERS: Opsional: Jumlah maksimum karakter yang akan ditampilkan untuk sorotan. Mengontrol total panjang teks sorotan yang ditampilkan per URL.
NUM_RESULTS: Opsional: Jumlah maksimum hasil penelusuran yang akan digunakan untuk perujukan. Jika tidak ditentukan, setelan defaultnya adalah 5.

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

const ai = new GoogleGenAI({});

const response = await ai.models.generateContent({
  model: 'MODEL_ID',
  contents: 'TEXT',
  config: {
    tools: [
      {
        exaAiSearch: {
          // Required. Your API key for Exa web search.
          apiKey: 'API_KEY',
          // Optional. Customize the search. Click a placeholder to enter a
          // value, or remove the line to accept the default.
          customConfigs: {
            type: 'SEARCH_TYPE',
            excludeDomains: ['EXCLUDE_DOMAINS'],
            includeDomains: ['INCLUDE_DOMAINS'],
            contents: {
              highlights: {
                maxCharacters: MAX_CHARACTERS,
              },
            },
            numResults: NUM_RESULTS,
          },
        },
      },
    ],
  },
});

console.log(response.text);

// The grounding metadata contains the web sources used to ground the response.
console.log(response.candidates[0].groundingMetadata.groundingChunks);

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 konfigurasikan 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 penelusuran web Exa.
SEARCH_TYPE: Opsional: Jenis penelusuran Exa yang akan dijalankan. Nilai yang didukung adalah fast dan instant. Nilai defaultnya adalah fast, yang memberikan hasil komprehensif dengan latensi yang lebih rendah dan sangat cocok untuk penelusuran yang ditampilkan kepada pengguna dan alur kerja interaktif. Gunakan instant untuk pengalaman yang memerlukan latensi terendah, seperti chat, agen suara, dan pelengkapan otomatis; mode ini meminimalkan waktu respons dengan memprioritaskan kecepatan daripada kedalaman penelusuran.
EXCLUDE_DOMAINS: Opsional: Daftar domain yang akan dikecualikan dari hasil penelusuran. Jika ditentukan, tidak ada hasil yang akan ditampilkan dari domain ini. Anda dapat menentukan hingga 1.200 domain.
INCLUDE_DOMAINS: Opsional: Daftar domain yang akan disertakan dalam penelusuran. Jika ditentukan, hasil hanya akan berasal dari domain ini. Anda dapat menentukan hingga 1.200 domain.
MAX_CHARACTERS: Opsional: Jumlah karakter maksimum yang akan ditampilkan untuk sorotan. Mengontrol total panjang teks sorotan yang ditampilkan per URL.
NUM_RESULTS: Opsional: Jumlah maksimum hasil penelusuran yang akan digunakan untuk perujukan. Jika tidak ditentukan, setelan defaultnya adalah 5.

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": [{
    "exaAiSearch": {
        "api_key": "API_KEY",
        "customConfigs": {
            "type": "SEARCH_TYPE",
            "excludeDomains": ["EXCLUDE_DOMAINS"],
            "includeDomains": ["INCLUDE_DOMAINS"],
            "contents": {
                "highlights": {
                    "maxCharacters": MAX_CHARACTERS
                }
            },
            "numResults": NUM_RESULTS
        }
    }
}],
  "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 Seattle Seahawks won Super Bowl LX on February 8, 2026, defeating the New England Patriots with a final score of 29-13."
          }
        ]
      },
      "finishReason": "STOP",
      "groundingMetadata": {
        "webSearchQueries": [
          "who won the last super bowl"
        ],
        "groundingChunks": [
          {
            "web": {
              "uri": "https://...",
              "title": "Super Bowl LX",
              "domain": "domain.com"
            }
          },
          {
            "web": {
              "uri": "https://...",
              "title": "Super Bowl LX Results",
              "domain": "domain.com"
            }
          }
        ],
        "groundingSupports": [
          {
            "segment": {
              "endIndex": 125,
              "text": "The Seattle Seahawks won Super Bowl LX on February 8, 2026, defeating the New England Patriots with a final score of 29-13."
            },
            "groundingChunkIndices": [
              0,
              1
            ]
          }
        ]
      }
    }
  ],
  "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"
}

Kuota

Kuota defaultnya adalah 200 perintah per menit. Jika Anda perlu meningkatkan batas kapasitas, hubungi support@exa.ai dan tim akun Google Anda dengan menyertakan kasus penggunaan dan persyaratan Anda.

Penagihan

Penggunaan Grounding dengan Exa akan dikenai biaya berikut:

Konsumsi token Gemini: Token perintah, token penalaran, token output. Untuk mengetahui informasi selengkapnya, lihat Harga.
Grounding Gemini dengan data Anda: Untuk mengetahui informasi selengkapnya, lihat Harga.
Harga untuk penggunaan API penelusuran Exa: Untuk mengetahui informasi selengkapnya, lihat halaman harga Exa.

Grounding dengan penelusuran web Exa Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Kasus penggunaan

Model yang didukung

Klik untuk meluaskan model yang didukung

Sebelum memulai

Memperkuat respons Gemini dengan Exa

Python

Instal

Java

Node.js

Instal

REST

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

Respons

Kuota

Penagihan

Grounding dengan penelusuran web Exa