Google Search के आधार पर जानकारी देना

Google Search से जानकारी लेने की सुविधा, Gemini मॉडल को रीयल-टाइम में सार्वजनिक तौर पर उपलब्ध वेब कॉन्टेंट से कनेक्ट करती है. इससे मॉडल, ज़्यादा सटीक और अप-टू-डेट जवाब दे पाता है. साथ ही, अपनी जानकारी की सीमा से बाहर जाकर, पुष्टि किए जा सकने वाले सोर्स का हवाला दे पाता है.

Google Search से जानकारी लेने की सुविधा के ये फ़ायदे हैं:

  • तथ्यों की सटीक जानकारी देना: असली दुनिया की जानकारी के आधार पर जवाब देकर, मॉडल के गलत जवाब देने की संभावना को कम करना.
  • रीयल-टाइम में जानकारी ऐक्सेस करना: हाल ही में हुए इवेंट और विषयों के बारे में सवालों के जवाब देना.
  • सोर्स की जानकारी देना: मॉडल के दावों के सोर्स दिखाकर, उपयोगकर्ताओं का भरोसा जीतना या उन्हें काम की साइटें ब्राउज़ करने की अनुमति देना.
  • ज़्यादा मुश्किल टास्क पूरे करना: तर्क करने वाले टास्क में मदद करने के लिए, आर्टफ़ैक्ट और काम की इमेज, वीडियो या अन्य मीडिया को वापस पाना.
  • इलाके या भाषा के हिसाब से बेहतर जवाब देना: इलाके के हिसाब से जानकारी ढूंढना या कॉन्टेंट का सटीक अनुवाद करने में मदद करना.

इस्तेमाल किए जा सकने वाले मॉडल

  • gemini-3.1-pro-preview
  • gemini-3-flash-preview
  • gemini-3.1-flash-lite
  • gemini-3-pro-image-preview (इसे "Nano Banana Pro" भी कहा जाता है)
  • gemini-3.1-flash-image-preview (इसे "Nano Banana 2" भी कहा जाता है)
  • gemini-2.5-pro
  • gemini-2.5-flash
  • gemini-2.5-flash-lite

यह सुविधा इन भाषाओं में काम करती है

मॉडल के लिए, इस्तेमाल की जा सकने वाली Gemini भाषाएं देखें.

Google Search से जानकारी लेकर मॉडल को जवाब देने की सुविधा चालू करना

इस पेज पर, Gemini API प्रोवाइडर के हिसाब से कॉन्टेंट और कोड देखने के लिए, उस पर क्लिक करें.

GenerativeModel इंस्टेंस बनाते समय, GoogleSearch को tool के तौर पर शामिल करें. इससे मॉडल, जवाब जनरेट करने के लिए इसका इस्तेमाल कर पाएगा.

Swift


import FirebaseAILogic

// Initialize the Gemini Developer API backend service
let ai = FirebaseAI.firebaseAI(backend: .googleAI())

// Create a `GenerativeModel` instance with a model that supports your use case
let model = ai.generativeModel(
    modelName: "GEMINI_MODEL_NAME",
    // Provide Google Search as a tool that the model can use to generate its response
    tools: [Tool.googleSearch()]
)

let response = try await model.generateContent("Who won the euro 2024?")
print(response.text ?? "No text in response.")

// Make sure to comply with the "Grounding with Google Search" usage requirements,
// which includes how you use and display the grounded result

Kotlin


// Initialize the Gemini Developer API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
val model = Firebase.ai(backend = GenerativeBackend.googleAI()).generativeModel(
    modelName = "GEMINI_MODEL_NAME",
    // Provide Google Search as a tool that the model can use to generate its response
    tools = listOf(Tool.googleSearch())
)

val response = model.generateContent("Who won the euro 2024?")
print(response.text)

// Make sure to comply with the "Grounding with Google Search" usage requirements,
// which includes how you use and display the grounded result

Java


// Initialize the Gemini Developer API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.googleAI())
                .generativeModel("GEMINI_MODEL_NAME",
                        null,
                        null,
                        // Provide Google Search as a tool that the model can use to generate its response
                        List.of(Tool.GoogleSearch()));

// Use the GenerativeModelFutures Java compatibility layer which offers
// support for ListenableFuture and Publisher APIs
GenerativeModelFutures model = GenerativeModelFutures.from(ai);

ListenableFuture response = model.generateContent("Who won the euro 2024?");
  Futures.addCallback(response, new FutureCallback() {
      @Override
      public void onSuccess(GenerateContentResponse result) {
          String resultText = result.getText();
          System.out.println(resultText);
      }

      @Override
      public void onFailure(Throwable t) {
          t.printStackTrace();
      }
  }, executor);

// Make sure to comply with the "Grounding with Google Search" usage requirements,
// which includes how you use and display the grounded result

Web


import { initializeApp } from "firebase/app";
import { getAI, getGenerativeModel, GoogleAIBackend } from "firebase/ai";

// TODO(developer) Replace the following with your app's Firebase configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
  // ...
};

// Initialize FirebaseApp
const firebaseApp = initializeApp(firebaseConfig);

// Initialize the Gemini Developer API backend service
const ai = getAI(firebaseApp, { backend: new GoogleAIBackend() });

// Create a `GenerativeModel` instance with a model that supports your use case
const model = getGenerativeModel(
  ai,
  {
    model: "GEMINI_MODEL_NAME",
    // Provide Google Search as a tool that the model can use to generate its response
    tools: [{ googleSearch: {} }]
  }
);

const result = await model.generateContent("Who won the euro 2024?");

console.log(result.response.text());

// Make sure to comply with the "Grounding with Google Search" usage requirements,
// which includes how you use and display the grounded result

Dart


import 'package:firebase_core/firebase_core.dart';
import 'package:firebase_ai/firebase_ai.dart';
import 'firebase_options.dart';

// Initialize FirebaseApp
await Firebase.initializeApp(
  options: DefaultFirebaseOptions.currentPlatform,
);

// Initialize the Gemini Developer API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
final model = FirebaseAI.googleAI().generativeModel(
  model: 'GEMINI_MODEL_NAME',
  // Provide Google Search as a tool that the model can use to generate its response
  tools: [
    Tool.googleSearch(),
  ],
);

final response = await model.generateContent([Content.text("Who won the euro 2024?")]);
print(response.text);

// Make sure to comply with the "Grounding with Google Search" usage requirements,
// which includes how you use and display the grounded result

Unity


using Firebase;
using Firebase.AI;

// Initialize the Gemini Developer API backend service
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.GoogleAI());

// Create a `GenerativeModel` instance with a model that supports your use case
var model = ai.GetGenerativeModel(
  modelName: "GEMINI_MODEL_NAME",
  // Provide Google Search as a tool that the model can use to generate its response
  tools: new[] { new Tool(new GoogleSearch()) }
);

var response = await model.GenerateContentAsync("Who won the euro 2024?");
UnityEngine.Debug.Log(response.Text ?? "No text in response.");

// Make sure to comply with the "Grounding with Google Search" usage requirements,
// which includes how you use and display the grounded result

अपने इस्तेमाल के उदाहरण और ऐप्लिकेशन के हिसाब से, मॉडल चुनने का तरीका जानें. मॉडल की जगह चुनना ज़रूरी नहीं है.

बेहतर नतीजे पाने के लिए, 1.0 का तापमान इस्तेमाल करें. यह सभी 2.5 मॉडल के लिए डिफ़ॉल्ट तापमान है. मॉडल के कॉन्फ़िगरेशन में तापमान सेट करने का तरीका जानें.

जानकारी लेने की सुविधा कैसे काम करती हैGoogle Search

GoogleSearch टूल का इस्तेमाल करने पर, मॉडल, जानकारी खोजने, उसे प्रोसेस करने, और उसका हवाला देने का पूरा वर्कफ़्लो अपने-आप मैनेज करता है.

मॉडल का वर्कफ़्लो यहां दिया गया है:

  1. प्रॉम्प्ट पाना: आपका ऐप्लिकेशन, Gemini मॉडल को एक प्रॉम्प्ट भेजता है. इसमें GoogleSearch टूल चालू होता है.
  2. प्रॉम्प्ट का विश्लेषण करना: मॉडल, प्रॉम्प्ट का विश्लेषण करता है और यह तय करता है कि Google Search की मदद से, जवाब को बेहतर बनाया जा सकता है या नहीं.
  3. क्वेरी को Google Search भेजना: ज़रूरत पड़ने पर, मॉडल अपने-आप एक या एक से ज़्यादा खोज क्वेरी जनरेट करता है और उन्हें लागू करता है.
  4. खोज के नतीजों को प्रोसेस करना: मॉडल, Google Search नतीजों को प्रोसेस करता है और ओरिजनल प्रॉम्प्ट का जवाब तैयार करता है.
  5. "Google Search से जानकारी लेकर दिया गया जवाब" देना: मॉडल, Google Search नतीजों के आधार पर, उपयोगकर्ता के लिए एक आसान जवाब देता है. इस जवाब में, मॉडल का टेक्स्ट जवाब और groundingMetadata शामिल होता है. इसमें खोज क्वेरी, वेब नतीजे, और सोर्स की जानकारी होती है.

ध्यान दें कि मॉडल को Google Search को टूल के तौर पर उपलब्ध कराने का मतलब यह नहीं है कि मॉडल को जवाब जनरेट करने के लिए हमेशा Google Search टूल का इस्तेमाल करना होगा. इन मामलों में, जवाब में groundingMetadata ऑब्जेक्ट शामिल नहीं होगा. इसलिए, यह "Google Search से जानकारी लेकर दिया गया जवाब" नहीं होगा.

इस डायग्राम में दिखाया गया है कि Google Search की मदद से सटीक जानकारी पाने की सुविधा में, मॉडल Google Search के साथ कैसे इंटरैक्ट करता है

Google Search से जानकारी लेकर दिए गए जवाब को समझना

अगर मॉडल, Google Search नतीजों के आधार पर जवाब देता है, तो जवाब में groundingMetadata ऑब्जेक्ट शामिल होता है. इसमें स्ट्रक्चर्ड डेटा होता है. यह डेटा, दावों की पुष्टि करने और आपके ऐप्लिकेशन में सोर्स का बेहतर अनुभव देने के लिए ज़रूरी है.

"Google Search से जानकारी लेकर दिए गए जवाब" में मौजूद groundingMetadata ऑब्जेक्ट में यह जानकारी शामिल होती है:

यहां एक जवाब का उदाहरण दिया गया है, जिसमें groundingMetadata ऑब्जेक्ट शामिल है:

{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "text": "Spain won Euro 2024, defeating England 2-1 in the final. This victory marks Spain's record fourth European Championship title."
          }
        ],
        "role": "model"
      },
      "groundingMetadata": {
        "webSearchQueries": [
          "UEFA Euro 2024 winner",
          "who won euro 2024"
        ],
        "searchEntryPoint": {
          "renderedContent": "<!-- HTML and CSS for the search widget -->"
        },
        "groundingChunks": [
          {"web": {"uri": "https://vertexaisearch.cloud.google.com.....", "title": "aljazeera.com"}},
          {"web": {"uri": "https://vertexaisearch.cloud.google.com.....", "title": "uefa.com"}}
        ],
        "groundingSupports": [
          {
            "segment": {"startIndex": 0, "endIndex": 85, "text": "Spain won Euro 2024, defeatin..."},
            "groundingChunkIndices": [0]
          },
          {
            "segment": {"startIndex": 86, "endIndex": 210, "text": "This victory marks Spain's..."},
            "groundingChunkIndices": [0, 1]
          }
        ]
      }
    }
  ]
}

Google Search से जानकारी लेकर दिए गए जवाब को इस्तेमाल करना और दिखाना

अगर मॉडल, जवाब जनरेट करने के लिए Google Search टूल का इस्तेमाल करता है, तो वह जवाब में groundingMetadata ऑब्जेक्ट उपलब्ध कराएगा.

Google Search के सुझाव दिखाना ज़रूरी है. साथ ही, सोर्स दिखाना भी ज़रूरी है.Google Search

Google Search टूल के इस्तेमाल से जुड़ी ज़रूरी शर्तों का पालन करने के अलावा, इस जानकारी को दिखाने से आपको और आपके अंतिम उपयोगकर्ताओं को जवाबों की पुष्टि करने में मदद मिलती है और ज़्यादा जानकारी पाने के रास्ते खुलते हैं.

(ज़रूरी) Google Search सुझाव दिखाना

अगर किसी जवाब में "Google Search सुझाव" शामिल हैं, तो आपको "Google Search से जानकारी लेकर जवाब देने की सुविधा" के इस्तेमाल से जुड़ी ज़रूरी शर्तों का पालन करना होगा. इसमें यह भी शामिल है कि आपको Google Search सुझाव कैसे दिखाने हैं.

`groundingMetadata` ऑब्जेक्ट में "Google Search सुझाव" शामिल होते हैं. खास तौर पर, `searchEntryPoint` फ़ील्ड में `renderedContent` फ़ील्ड होता है. इसमें एचटीएमएल और सीएसएस स्टाइलिंग शामिल होती है, जो ज़रूरी शर्तों के मुताबिक होती है. आपको अपने ऐप्लिकेशन में खोज के सुझाव दिखाने के लिए, इसे लागू करना होगा.

दस्तावेज़ में, सुझावों को दिखाने और उनके काम करने के तरीके से जुड़ी ज़रूरी शर्तों के बारे में ज़्यादा जानकारी देखें.Google SearchGoogle Cloud ध्यान दें कि यह ज़्यादा जानकारी, Vertex AI Gemini API के दस्तावेज़ में दी गई है. हालांकि, यह जानकारी Gemini Developer API के प्रोवाइडर पर भी लागू होती है.

इस सेक्शन में, कोड के सैंपल के उदाहरण देखें.

(ज़रूरी) सोर्स दिखाना

groundingMetadata ऑब्जेक्ट में, सोर्स का स्ट्रक्चर्ड डेटा शामिल होता है. खास तौर पर, groundingSupports और groundingChunks फ़ील्ड शामिल होते हैं. इस जानकारी का इस्तेमाल करके, मॉडल के स्टेटमेंट को सीधे अपने यूज़र इंटरफ़ेस (यूआई) में मौजूद सोर्स से लिंक करें. इसके लिए, इनलाइन और एग्रीगेट में लिंक करें.

इस सेक्शन में, कोड के सैंपल के उदाहरण देखें.

कोड के सैंपल के उदाहरण

इन कोड के सैंपल में, Google Search से जानकारी लेकर दिए गए जवाब को इस्तेमाल करने और दिखाने के सामान्य पैटर्न दिए गए हैं. हालांकि, यह पक्का करना आपकी ज़िम्मेदारी है कि आपका खास तौर पर लागू किया गया पैटर्न, ज़रूरी शर्तों के मुताबिक हो.

Swift

// ...

// Get the model's response
let text = response.text

// Get the grounding metadata
if let candidate = response.candidates.first,
   let groundingMetadata = candidate.groundingMetadata {
  // REQUIRED - display Google Search suggestions
  // (renderedContent contains HTML and CSS for the search widget)
  if let renderedContent = groundingMetadata.searchEntryPoint?.renderedContent {
    // TODO(developer): Display Google Search suggestions using a WebView
  }

  // REQUIRED - display sources
  let groundingChunks = groundingMetadata.groundingChunks
  for chunk in groundingMetadata.groundingChunks {
    if let web = chunk.web {
      let title = web.title  // for example, "uefa.com"
      let uri = web.uri  // for example, "https://vertexaisearch.cloud.google.com..."
      // TODO(developer): show source in the UI
    }
  }
}

Kotlin

// ...

// Get the model's response
val text = response.text

// Get the grounding metadata
val groundingMetadata = response.candidates.firstOrNull()?.groundingMetadata

// REQUIRED - display Google Search suggestions
// (renderedContent contains HTML and CSS for the search widget)
val renderedContent = groundingMetadata?.searchEntryPoint?.renderedContent
if (renderedContent != null) {
    // TODO(developer): Display Google Search suggestions using a WebView
}

// REQUIRED - display sources
val groundingChunks = groundingMetadata?.groundingChunks
groundingChunks?.let { chunks ->
  for (chunk in chunks) {
  	val title = chunk.web?.title  // for example, "uefa.com"
	val uri = chunk.web?.uri  // for example, "https://vertexaisearch.cloud.google.com..."
// TODO(developer): show source in the UI
  }
}

Java

// ...

Futures.addCallback(response, new FutureCallback() {
  @Override
  public void onSuccess(GenerateContentResponse result) {
  // Get the model's response
  String text = result.getText();

  // Get the grounding metadata
  GroundingMetadata groundingMetadata =
  result.getCandidates()[0].getGroundingMetadata();

  if (groundingMetadata != null) {
    // REQUIRED - display Google Search suggestions
  // (renderedContent contains HTML and CSS for the search widget)
    String renderedContent =
  groundingMetadata.getSearchEntryPoint().getRenderedContent();
    if (renderedContent != null) {
      // TODO(developer): Display Google Search suggestions using a WebView
    }

    // REQUIRED - display sources
    List chunks = groundingMetadata.getGroundingChunks();
    if (chunks != null) {
      for(GroundingChunk chunk : chunks) {
        WebGroundingChunk web = chunk.getWeb();
        if (web != null) {
          String title = web.getTitle();  // for example, "uefa.com"
          String uri = web.getUri();  // for example, "https://vertexaisearch.cloud.google.com..."
          // TODO(developer): show sources in the UI
        }
      }
    }
  }
  }

  @Override
  public void onFailure(Throwable t) {
  t.printStackTrace();
  }
  }, executor);

Web

// ...

// Get the model's text response
const text = result.response.text();

// Get the grounding metadata
const groundingMetadata = result.response.candidates?.[0]?.groundingMetadata;

// REQUIRED - display Google Search suggestions
// (renderedContent contains HTML and CSS for the search widget)
const renderedContent = groundingMetadata?.searchEntryPoint?.renderedContent;
if (renderedContent) {
  // TODO(developer): render this HTML and CSS in the UI
}

// REQUIRED - display sources
const groundingChunks = groundingMetadata?.groundingChunks;
if (groundingChunks) {
  for (const chunk of groundingChunks) {
    const title = chunk.web?.title;  // for example, "uefa.com"
    const uri = chunk.web?.uri;  // for example, "https://vertexaisearch.cloud.google.com..."
    // TODO(developer): show sources in the UI
  }
}

Dart

// ...

// Get the model's response
final text = response.text;

// Get the grounding metadata
final groundingMetadata = response.candidates.first.groundingMetadata;

// REQUIRED - display Google Search suggestions
// (renderedContent contains HTML and CSS for the search widget)
final renderedContent = groundingMetadata?.searchEntryPoint?.renderedContent;
if (renderedContent != null) {
    // TODO(developer): Display Google Search suggestions using a WebView
}

// REQUIRED - display sources
final groundingChunks = groundingMetadata?.groundingChunks;
if (groundingChunks != null) {
  for (var chunk in groundingChunks) {
    final title = chunk.web?.title;  // for example, "uefa.com"
    final uri = chunk.web?.uri;  // for example, "https://vertexaisearch.cloud.google.com..."
    // TODO(developer): show sources in the UI
  }
}

Unity

// ...

// Get the model's response
var text = response.Text;

// Get the grounding metadata
var groundingMetadata = response.Candidates.First().GroundingMetadata.Value;

// REQUIRED - display Google Search suggestions
// (renderedContent contains HTML and CSS for the search widget)
if (groundingMetadata.SearchEntryPoint.HasValue) {
    var renderedContent = groundingMetadata.SearchEntryPoint.Value.RenderedContent;
    // TODO(developer): Display Google Search suggestions using a WebView
}

// REQUIRED - display sources
foreach(GroundingChunk chunk in groundingMetadata.GroundingChunks) {
    var title = chunk.Web.Value.Title;  // for example, "uefa.com"
    var uri = chunk.Web.Value.Uri;  // for example, "https://vertexaisearch.cloud.google.com..."
    // TODO(developer): show sources in the UI
}

Firebase console में, Google Search से जानकारी लेकर दिए गए जवाब और एआई की निगरानी की सुविधा

अगर आपने एआई की निगरानी की सुविधा Firebase console में चालू की है, तो जवाब Cloud Logging में सेव किए जाते हैं. डिफ़ॉल्ट रूप से, इस डेटा को 30 दिनों तक सेव रखा जाता है.

यह पक्का करना आपकी ज़िम्मेदारी है कि डेटा को सेव रखने की यह अवधि या आपके सेट की गई कोई भी कस्टम अवधि, आपके इस्तेमाल के उदाहरण और अपने चुने गए Gemini API प्रोवाइडर के लिए, ज़रूरी शर्तों के मुताबिक हो: Gemini Developer API या Vertex AI Gemini API (इसके लिए, सेवा की शर्तें सेक्शन देखें). इन ज़रूरी शर्तों को पूरा करने के लिए, आपको डेटा को सेव रखने की अवधि में Cloud Logging बदलाव करना पड़ सकता है.

कीमत और सीमाएं

Gemini API के अपने चुने हुए प्रोवाइडर के दस्तावेज़ में, Google Search से जानकारी लेकर जवाब देने की सुविधा की कीमत, मॉडल की उपलब्धता, और सीमाओं की समीक्षा करना न भूलें: Gemini Developer API | Vertex AI Gemini API.Google SearchGemini APIGemini Developer APIVertex AI Gemini API