Обоснование с Google Поиском

Обоснование с Google Search позволяет модели Gemini получать доступ к общедоступному веб-контенту в реальном времени. Это позволяет модели давать более точные и актуальные ответы и ссылаться на проверенные источники, которые были опубликованы после даты актуальности данных.

Обоснование с помощью Google Search имеет следующие преимущества:

  • Повышение фактической точности. Уменьшение галлюцинаций модели за счет использования информации из реального мира.
  • Получать информацию в реальном времени. Задавайте вопросы о недавних событиях и темах.
  • Указывайте источники. Чтобы повысить доверие пользователей или позволить им просматривать релевантные сайты, показывайте источники утверждений модели.
  • Выполнять более сложные задачи. Извлекать артефакты и подходящие изображения, видео и другие медиафайлы, чтобы помогать в решении задач.
  • Улучшать ответы с учетом региональных особенностей или языка. Находить информацию, относящуюся к определенному региону, или помогать с точным переводом контента.

Поддерживаемые модели

  • gemini-3.1-pro-preview
  • gemini-3.8-flash (а также более старые версии gemini-3.7-flash, gemini-3.6-flash и gemini-3.5-flash)
  • gemini-3.5-flash-lite (и более ранние версии, например gemini-3.1-flash-lite)
  • gemini-3-pro-image (также известна как Nano Banana Pro)
  • gemini-3.1-flash-image (также известна как Nano Banana 2)

Модели общего назначения Gemini 2.5 поддерживают эту функцию, но все они устарели.

Модели Gemini Live API также поддерживают эту возможность, но все примеры кода в этом руководстве предназначены для моделей Gemini общего назначения.

Поддерживаемые языки

Ознакомьтесь со списком поддерживаемых языков для моделей 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

Узнайте, как выбрать модель для вашего приложения и варианта использования.

Как работает обоснование с помощью Google Search

При использовании инструмента GoogleSearch модель автоматически выполняет весь рабочий процесс поиска, обработки и цитирования информации.

Вот как работает модель:

  1. Получить запрос. Приложение отправляет запрос модели Gemini с включенным инструментом GoogleSearch.
  2. Анализ запроса. Модель анализирует запрос и определяет, может ли Google Search улучшить ответ.
  3. Отправлять запросы в Google Search. При необходимости модель автоматически генерирует один или несколько поисковых запросов и выполняет их.
  4. Обработка результатов поиска. Модель обрабатывает результаты Google Search и формирует ответ на исходный запрос.
  5. Возвращает обоснованный результат. Модель возвращает окончательный, удобный для пользователя ответ, основанный на результатах Google Search. Этот ответ включает текстовый ответ модели и groundingMetadata с поисковыми запросами, результатами веб-поиска и источниками.

Обратите внимание, что предоставление модели инструмента Google Search не означает, что она всегда будет использовать его Google Search для создания ответа. В таких случаях ответ не будет содержать объект groundingMetadata и, следовательно, не будет "обоснованным результатом".

Схема, на которой показано, как обоснование с Google Поиском предполагает взаимодействие модели с Google Поиском

Как интерпретировать обоснованный ответ

Если модель основывает свой ответ на результатах поиска Google Search, то ответ включает объект groundingMetadata, содержащий структурированные данные, которые необходимы для проверки утверждений и создания расширенного источника в вашем приложении.

Объект groundingMetadata в обоснованном ответе содержит следующую информацию:

  • webSearchQueries – массив поисковых запросов, отправленных в Google Search. Эта информация полезна для отладки и понимания процесса рассуждения модели.

  • searchEntryPoint: содержит HTML и CSS для отрисовки необходимых "Google Search вариантов". Вы должны соблюдать требования к использованию функции "Обоснование с помощью Google Search" для выбранного поставщика API: Gemini Developer API или Agent Platform Gemini API (formerly Vertex AI) (см. раздел Условия использования сервиса в Условиях использования отдельных сервисов). Подробнее о том, как использовать и показывать обоснованный результат…

  • groundingChunks – массив объектов, содержащих веб-источники (uri и title).

  • groundingSupports – массив фрагментов, позволяющий связать ответ моделиtext с источниками в groundingChunks. Каждый фрагмент связывает текст segment (определенный в startIndex и endIndex) с одним или несколькими объектами groundingChunkIndices. Это поле помогает создавать встроенные ссылки на источники. Подробнее о том, как использовать и показывать обоснованный результат…

Ниже приведен пример ответа, содержащего объект 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 для создания ответа, она предоставит объект groundingMetadata в ответе.

Обязательно показывать подсказки Google Search и обязательно показывать источники.

Помимо соблюдения требований к использованию инструмента Google Search, показ этой информации помогает вам и конечным пользователям проверять ответы и получать дополнительные сведения.

(Обязательно) рекомендации для медийной рекламы Google Search

Если в ответе есть фраза "Google Search suggestions", вы обязаны соблюдать требования к использованию Google Search, в том числе к тому, как отображаются Google Search подсказки.

Объект groundingMetadata содержит "Google Search подсказок", в частности поле searchEntryPoint, в котором есть поле renderedContent с совместимым HTML- и CSS-кодом, необходимым для показа подсказок при поиске в приложении.

Подробную информацию о требованиях к показу и поведению подсказок Google Search можно найти в документации по Google Cloud. Обратите внимание, что, хотя подробные инструкции приведены в документации по Agent Platform Gemini API (formerly Vertex AI), они также применимы к поставщику Gemini Developer API.

Примеры кода приведены ниже.

(Обязательно) Источники для медийных кампаний

Объект groundingMetadata содержит структурированные исходные данные, в частности поля groundingSupports и groundingChunks. Используйте эту информацию, чтобы связывать утверждения модели с их источниками в интерфейсе (встроенными и агрегированными).

Примеры кода приведены ниже.

Примеры кода

В этих примерах кода приведены обобщенные шаблоны использования и отображения обоснованного результата. Однако вы несете ответственность за то, чтобы ваша реализация соответствовала требованиям.

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

Если вы включили мониторинг ИИ в консоли Firebase, ответы будут храниться в Cloud Logging. По умолчанию эти данные хранятся 30 дней.

Вы несете ответственность за то, чтобы этот период хранения или любой заданный вами период полностью соответствовал вашему варианту использования и любым дополнительным требованиям к соблюдению нормативных требований для выбранного вами поставщика: Gemini APIGemini Developer API или Agent Platform Gemini API (formerly Vertex AI) (см. раздел Условия использования сервисов в Условиях использования сервисов Workspace). Возможно, вам потребуется изменить срок хранения в Cloud Logging, чтобы соответствовать этим требованиям.

Цены и ограничения

Ознакомьтесь с документацией выбранного вами поставщика Gemini API, чтобы узнать о ценах, доступности моделей и ограничениях для функции "Обоснование с помощью Google Search": Gemini Developer API | Agent Platform Gemini API (formerly Vertex AI).