适用于企业的 Web 接地

本页面介绍了 Web Grounding for Enterprise 的合规性控制措施，以及如何使用 Web Grounding for Enterprise API 来生成基于 Web 的接地回答。其索引的内容是 Google 搜索可用内容的子集，适合金融、医疗保健和公共部门等受严格监管行业的客户。

如果您不需要其他合规性控制措施，请使用依托 Google 搜索进行接地，因为它可访问更广泛且更新的 Web 索引。

概览

“适用于企业的 Web 接地”使用 Web 索引来生成接地回答。该服务不会记录客户数据，并且支持 VPC Service Controls。如需了解详情，请参阅生成式 AI 安全控制。由于系统不会保留任何客户数据，因此客户管理的加密密钥 (CMEK) 和 Access Transparency (AxT) 不适用。

索引新鲜度和整理

系统会自动选择企业版 Web 接地的 Web 索引，以满足医疗保健、金融和公共部门垂直行业的客户的预期需求。虽然具体的更新时间表可能会有所不同，但快速变化的内容每 6 小时更新一次，整个索引每 24 小时更新一次。

选择产品

选择合适的接地工具取决于组织在合规性控制和所需信息新鲜度方面的具体需求。

  • 使用 Google 搜索作为依据：对于希望获得最优质、最新鲜的依据型回答的客户，建议选择此选项。新鲜度是指用于生成回答的网络信息的最新程度。对于需要从网络中获取最新、最全面信息的用例而言，这一点至关重要。根据服务专用条款，“使用 Google 搜索进行接地”功能最多可存储 30 天的可靠性日志。Google 不会使用“使用 Google 搜索进行接地”功能处理的客户数据进行训练。

  • 面向企业的 Web Grounding：此解决方案专为企业客户设计，这些客户有严格的合规性要求，包括“不记录客户数据”。对于受到严格监管的行业中需要额外合规性控制措施的组织，企业版 Web 接地是首选。Web Grounding for Enterprise 不会存储客户数据。

支持的模型

本部分列出了支持“适用于企业的 Web 接地”的模型。

使用 API

本部分提供了一些示例请求，展示了如何使用 Vertex AI 上的生成式 AI API Gemini 2 通过 Gemini 来生成接地回答。如需使用该 API，您必须设置以下字段：

  • Contents.parts.text：用户要发送给 API 的文本查询。
  • tools.enterpriseWebSearch：提供此工具后，Gemini 便可使用“适用于企业的 Web 接地”。

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 (
    EnterpriseWebSearch,
    GenerateContentConfig,
    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 Enterprise Web Search Tool
            Tool(enterprise_web_search=EnterpriseWebSearch())
        ],
    ),
)

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

REST

将以下变量替换为您的值：

  • PROJECT_NUMBER：您的项目编号。
  • LOCATION：处理请求的区域。如需使用 global 端点，请清除端点名称中的相应位置，并将资源位置配置为 global。
  • PROMPT：您的提示。
  curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" -H "x-server-timeout: 60" https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/publishers/google/models/gemini-2.0-flash:generateContent -d '
  {
    "contents": [{
      "role": "user",
      "parts": [{
        "text": PROMPT
      }]
    }],
    "tools": [{
      "enterpriseWebSearch": {
      }
    }]
  }
  '

使用 Google 搜索建议

使用“适用于企业的 Web 接地”时，如果您在回答中收到搜索建议，则必须在生产环境和应用中显示搜索建议。

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

  • "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?"],
    }
  }
]

您可以使用 Google 搜索建议获取此输出并进行显示。

搜索建议的要求

以下是建议的要求：

要求 说明
正确做法
  • 在符合显示要求的同时，搜索建议将完全按照提供的内容显示，不会进行任何更改。
  • 当您与搜索建议互动时，系统会直接将您带到“搜索结果”页 (SRP)。
错误做法
  • 在用户点按与 SRP 显示之间包含任何屏幕或其他步骤
  • 在搜索建议或关联的接地 LLM 回答旁边显示任何其他搜索结果或建议。

显示要求

以下是显示要求：

  • 完全按照所提供的方式显示搜索建议，不对颜色、字体或外观进行任何修改。确保搜索建议按照以下模拟中指定的方式进行渲染，包括针对浅色和深色模式：

  • 每当显示接地回答时，其相应的 Google 搜索建议都应保持可见。
  • 在品牌塑造方面，您必须严格遵循 Google 的指南（第三方使用 Google 品牌特征时适用），详见欢迎访问我们的品牌资源中心。
  • 当您使用“适用于企业的 Web 接地”时，系统会显示搜索建议条状标签。包含建议条状标签的字段必须与 LLM 提供的接地回答宽度相同。

点按时的行为

用户点按条状标签后，会直接前往条状标签中显示的搜索字词的对应 Google 搜索结果页 (SRP)。SRP 可以在应用内浏览器或单独的浏览器应用中打开。请务必不要以任何方式最小化、移除或遮挡 SRP 的显示内容。以下动画模拟展示了点按与 SRP 的交互。

应用/桌面示例

实现搜索建议的代码

当您使用 API 为搜索回答建立依据时，模型回答会在 renderedContent 字段中提供合规的 HTML 和 CSS 样式，您可以实现该字段以在应用中显示搜索建议。

后续步骤