此页面由 Cloud Translation API 翻译。

使用 Google 搜索建立依据

本指南介绍了如何使用 Google 搜索让模型回答接地，以及如何实现其搜索建议。

本页面涵盖以下主题：

什么是依托 Google 搜索进行接地？了解如何以公开提供的 Web 数据作为依据，并查看支持哪些模型。
使用 Google 搜索为模型建立依据：按照步骤使用 Vertex AI Studio 或 API 为模型建立依据。
了解并显示回答：了解如何解读接地回答并显示接地支持。
使用 Google 搜索建议：了解如何实现随依托回答一起显示的必需搜索建议。

什么是“依托 Google 搜索进行接地”？

如需将模型与世界知识、各种主题或互联网上的最新信息相关联，请使用“依托 Google 搜索进行接地”功能。

如需详细了解 Vertex AI 中的模型接地功能，请参阅接地概览。

支持的模型

本部分列出了支持“依托 Google 搜索进行接地”的模型。

支持的语言

如需查看支持的语言列表，请参阅语言。

优势

通过将 Google 搜索用作工具，您可以创建需要规划和推理的复杂提示和工作流。福利包括：

基于公共网站上的信息生成回答，从而提高回答的真实性和时效性。
从 Web 检索制品以供分析。
查找相关图片、视频或其他媒体内容，以辅助进行多模态推理或任务生成。
执行编码、技术问题排查和其他专业任务。
查找特定于某个区域的信息或协助准确翻译内容。
查找相关网站以供浏览。

借助 Google 搜索让模型接地

按照以下说明借助公开提供的网络数据让模型接地。

注意事项

如需使用“依托 Google 搜索进行接地”，您必须启用 Google 搜索建议。如需了解详情，请参阅使用 Google 搜索建议。
为了获得理想的结果，请使用 1.0 温度。如需详细了解此配置，请参阅 Gemini API 请求正文。
“借助 Google 搜索接地”功能的查询次数上限为每天 100 万次。如果您需要更多查询，请与Google Cloud 支持团队联系以获取帮助。

控制台

如需将“使用 Google 搜索建立依据”与 Vertex AI Studio 搭配使用，请按照以下步骤操作：

在 Google Cloud 控制台中，前往 Vertex AI Studio 页面。
进入 Vertex AI Studio
点击 Freeform 标签页。
在侧边栏中，点击让模型回答接地切换开关。
点击自定义，并将 Google 搜索设置为来源。
在文本框中输入提示，然后点击提交。

您的提示回答现在会以 Google 搜索为基础。

Python

安装

pip install --upgrade google-genai

如需了解详情，请参阅 SDK 参考文档。

设置环境变量以将 Gen AI SDK 与 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_VERTEXAI=True

from google import genai
from google.genai.types import (
    GenerateContentConfig,
    GoogleSearch,
    HttpOptions,
    Tool,
)

client = genai.Client(http_options=HttpOptions(api_version="v1"))

response = client.models.generate_content(
    model="gemini-2.5-flash",
    contents="When is the next total solar eclipse in the United States?",
    config=GenerateContentConfig(
        tools=[
            # Use Google Search Tool
            Tool(google_search=GoogleSearch())
        ],
    ),
)

print(response.text)
# Example response:
# 'The next total solar eclipse in the United States will occur on ...'

Go

了解如何安装或更新 Go。

如需了解详情，请参阅 SDK 参考文档。

设置环境变量以将 Gen AI SDK 与 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_VERTEXAI=True

import (
	"context"
	"fmt"
	"io"

	genai "google.golang.org/genai"
)

// generateWithGoogleSearch shows how to generate text using Google Search.
func generateWithGoogleSearch(w io.Writer) error {
	ctx := context.Background()

	client, err := genai.NewClient(ctx, &genai.ClientConfig{
		HTTPOptions: genai.HTTPOptions{APIVersion: "v1"},
	})
	if err != nil {
		return fmt.Errorf("failed to create genai client: %w", err)
	}

	modelName := "gemini-2.5-flash"
	contents := []*genai.Content{
		{Parts: []*genai.Part{
			{Text: "When is the next total solar eclipse in the United States?"},
		},
			Role: "user"},
	}
	config := &genai.GenerateContentConfig{
		Tools: []*genai.Tool{
			{GoogleSearch: &genai.GoogleSearch{}},
		},
	}

	resp, err := client.Models.GenerateContent(ctx, modelName, contents, config)
	if err != nil {
		return fmt.Errorf("failed to generate content: %w", err)
	}

	respText := resp.Text()

	fmt.Fprintln(w, respText)

	// Example response:
	// The next total solar eclipse in the United States will occur on March 30, 2033, but it will only ...

	return nil
}

REST

在使用任何请求数据之前，请先进行以下替换：

LOCATION：处理请求的区域。
PROJECT_ID：您的项目 ID。
MODEL_ID：多模态模型的模型 ID。
TEXT：要包含在提示中的文本说明。

HTTP 方法和网址：

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

请求 JSON 正文：

{
  "contents": [{
    "role": "user",
    "parts": [{
      "text": "TEXT"
    }]
  }],
  "tools": [{
    "googleSearch": {}
  }],
  "model": "projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID"
}

如需发送您的请求，请展开以下选项之一：

curl（Linux、macOS 或 Cloud Shell）

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI，或者使用了 Cloud Shell，这会使您自动登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

将请求正文保存在名为 request.json 的文件中，然后执行以下命令：

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)

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

将请求正文保存在名为 request.json 的文件中，然后执行以下命令：

$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

您应该收到类似以下内容的 JSON 响应：

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "The weather in Chicago this weekend, will be partly cloudy. The temperature will be between 49°F (9°C) and 55°F (13°C) on Saturday and between 51°F (11°C) and 56°F (13°C) on Sunday. There is a slight chance of rain on both days.\n"
          }
        ]
      },
      "finishReason": "STOP",
      "groundingMetadata": {
        "webSearchQueries": [
          "weather in Chicago this weekend"
        ],
        "searchEntryPoint": {
          "renderedContent": "..."
        },
        "groundingChunks": [
          {
            "web": {
              "uri": "https://www.google.com/search?q=weather+in+Chicago,+IL",
              "title": "Weather information for locality: Chicago, administrative_area: IL",
              "domain": "google.com"
            }
          },
          {
            "web": {
              "uri": "...",
              "title": "weatherbug.com",
              "domain": "weatherbug.com"
            }
          }
        ],
        "groundingSupports": [
          {
            "segment": {
              "startIndex": 85,
              "endIndex": 214,
              "text": "The temperature will be between 49°F (9°C) and 55°F (13°C) on Saturday and between 51°F (11°C) and 56°F (13°C) on Sunday."
            },
            "groundingChunkIndices": [
              0
            ],
            "confidenceScores": [
              0.8662828
            ]
          },
          {
            "segment": {
              "startIndex": 215,
              "endIndex": 261,
              "text": "There is a slight chance of rain on both days."
            },
            "groundingChunkIndices": [
              1,
              0
            ],
            "confidenceScores": [
              0.62836814,
              0.6488607
            ]
          }
        ],
        "retrievalMetadata": {}
      }
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 10,
    "candidatesTokenCount": 98,
    "totalTokenCount": 108,
    "trafficType": "ON_DEMAND",
    "promptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 10
      }
    ],
    "candidatesTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 98
      }
    ]
  },
  "modelVersion": "gemini-2.0-flash",
  "createTime": "2025-05-19T14:42:55.000643Z",
  "responseId": "b0MraIMFoqnf-Q-D66G4BQ"
}

理解回答

如果您的模型提示从 Vertex AI Studio 或 API 成功连接到 Google 搜索，则回答会包含带有来源链接（网址）的元数据。不过，如果模型回答中的来源相关性较低或信息不完整，则可能不会提供此元数据。

接地支持

建议显示接地支持，因为这有助于您验证发布方的回答，并为用户提供更多学习途径。

对来自 Google 搜索来源的回答的依据支持应以内嵌和汇总形式显示。下图展示了如何显示事实依据支持。

接地支持示例

使用 Google 搜索建议

使用“使用 Google 搜索建立依据”时，如果您在回答中收到 Google 搜索建议，则必须在生产应用中显示这些搜索建议。

具体而言，您必须显示有依据的回答的元数据中包含的搜索查询。回答包括：

"content"：LLM 生成的回答。
"webSearchQueries"：用于搜索建议的查询。

例如，在以下代码段中，Gemini 会回答 Google 搜索连接提示，该提示询问一种热带植物。

"predictions": [
  {
    "content": "Monstera is a type of vine that thrives in bright indirect light…",
    "groundingMetadata": {
      "webSearchQueries": ["What's a monstera?"],
    }
  }
]

使用此输出在您的应用中显示搜索建议。

搜索建议的要求

以下是建议的要求：

要求	说明
正确做法	在遵守显示要求的前提下，完全按照所提供的方式显示搜索建议，不进行任何更改。当用户与搜索建议互动时，直接将他们带到搜索结果页 (SRP)。
错误做法	在用户点按与 SRP 显示之间包含任何屏幕或其他步骤。在搜索建议或关联的接地 LLM 回答旁边显示任何其他搜索结果或建议。

显示要求

遵循以下展示要求：

完全按照所提供的方式显示搜索建议，不对颜色、字体或外观进行任何修改。确保搜索建议按照以下模拟中指定的方式进行渲染，包括针对浅色和深色模式：
每当显示接地回答时，其相应的 Google 搜索建议都必须保持可见。
在品牌塑造方面，您必须遵循 Google 的指南，网址为欢迎访问我们的品牌资源中心。
使用“依托 Google 搜索进行接地”时，包含建议条状标签的字段必须与 LLM 提供的接地回答宽度相同。

点按时的行为

当用户点按或点击条状标签后，直接前往条状标签中显示的搜索字词的对应搜索结果页 (SRP)。SRP 可以在应用内浏览器或单独的浏览器应用中打开。请勿以任何方式最小化、移除或遮挡 SRP 的显示内容。以下动画演示了这种互动。

应用/桌面示例

实现搜索建议的代码

当您使用 API 为搜索响应建立依据时，模型响应会在 renderedContent 字段中包含合规的 HTML 和 CSS 样式。在应用中实现此内容以显示搜索建议。

注意：API 响应中提供的 HTML 和 CSS 会自动适应您的设备设置，根据 @media(prefers-color-scheme) 所指示的您的偏好设置以浅色或深色模式显示。

使用备用搜索引擎选项

使用“依托 Google 搜索进行接地”时，您的应用可以执行以下操作：

提供备用搜索引擎选项。
将其他搜索引擎设为默认选项。
显示自有或第三方搜索建议或搜索结果。不过，任何非 Google 结果都必须与 Google 的接地结果和搜索建议分开显示，并且不得以会使用户感到困惑或暗示这些结果来自 Google 的方式显示。

后续步骤

如需详细了解接地，请参阅接地概览。
如需了解如何发送聊天提示请求，请参阅多轮聊天。
如需了解 Responsible AI 最佳实践和 Vertex AI 的安全过滤器，请参阅安全最佳实践。
了解如何发送聊天提示请求。
了解 Responsible AI 最佳实践和 Vertex AI 的安全过滤条件。