企業版網站資料來源

本頁說明企業法規遵循控制項的網頁基礎功能，以及如何使用企業適用的網頁基礎 API，根據網頁內容生成回應。建立索引的內容是 Google 搜尋提供的部分內容，適合金融、醫療照護和公部門等管制嚴格產業的客戶。

如果不需要額外的法規遵循控管機制，請使用 Ground with Google Search，因為這項功能可存取更廣泛且更即時的網路索引。

總覽

企業適用的網路內容建立基準功能會使用網路索引，生成有依據的回覆。這項服務不會記錄顧客資料，且支援 VPC Service Controls。詳情請參閱生成式 AI 的安全性控制項。由於系統不會保留任何客戶資料，因此不適用客戶自行管理的加密金鑰 (CMEK) 和存取透明度 (AxT)。

索引新鮮度和彙整

系統會自動選取企業版 Web Grounding 的網路索引，以滿足醫療保健、金融和公部門垂直產業客戶的預期需求。具體的更新時間表可能有所不同，但快速變動的內容每 6 小時更新一次，整個索引則每 24 小時更新一次。

選擇產品

選擇合適的基礎工具取決於貴機構在法規遵循控管和資訊即時性方面的具體需求。

  • 以 Google 搜尋為基礎：建議選擇這個選項，確保基礎回應的品質和即時性。「新穎度」是指用來生成回覆的網路資訊有多新。如果用途需要從網路上存取最新且全面的資訊，這項功能就非常重要。根據服務專屬條款，利用 Google 搜尋建立基準會將可靠性記錄儲存最多 30 天。 Google 不會使用利用 Google 搜尋建立基準處理的客戶資料進行訓練。

  • 企業專用網路基礎：這項解決方案專為企業客戶設計，可滿足嚴格的法規遵循需求，包括「不得記錄顧客資料」。對於需要額外法規遵循控管機制的嚴格管制產業，企業版網頁基準是首選。Enterprise 專用的網頁基礎功能不會儲存客戶資料。

支援的模型

本節列出支援 Enterprise 網頁基礎功能的模型。

使用 API

本節提供使用 Vertex AI 上的 Generative AI API Gemini 2，透過 Gemini 建立有根據回覆的範例要求。如要使用這個 API，請務必設定下列欄位：

  • Contents.parts.text：使用者要傳送至 API 的文字查詢。
  • tools.enterpriseWebSearch：提供這項工具後，Gemini 就能使用 Enterprise 網頁基礎功能。

Python

安裝

pip install --upgrade google-genai

詳情請參閱 SDK 參考說明文件。

設定環境變數，透過 Vertex AI 使用 Gen AI SDK： 

# 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 搜尋建議

使用企業版網頁基準功能時，如果回覆中包含搜尋建議，您必須在正式環境和應用程式中顯示搜尋建議。

具體來說，您必須顯示基礎回應中繼資料中包含的搜尋查詢。回覆內容包括：

  • "content"：LLM 生成的回覆。
  • "webSearchQueries"：用於搜尋建議的查詢。

舉例來說，在下列程式碼片段中，Gemini 會回覆以搜尋結果為依據的提示詞，詢問某種熱帶植物。

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

您可以取得這項輸出內容，並使用搜尋建議顯示。

搜尋建議的規定

建議的條件如下：

規定 說明
建議的宣傳訊息
  • 在符合顯示規定的前提下，系統會直接顯示搜尋建議，不會進行任何變更。
  • 與搜尋建議互動時，系統會直接將你帶往搜尋結果網頁 (SRP)。
錯誤做法
  • 包括使用者輕觸和顯示搜尋結果網頁之間的任何畫面或額外步驟。
  • 在搜尋建議或相關的 LLM 回覆旁，顯示任何其他搜尋結果或建議。

多媒體廣告規定

顯示規定如下：

  • 請按照提供的內容顯示搜尋建議，且不得修改顏色、字型或外觀。請確保搜尋建議會按照下列模擬畫面 (例如淺色和深色模式) 顯示：

  • 顯示以搜尋結果為依據的回覆時，對應的搜尋建議應會持續顯示。
  • 如要使用品牌宣傳元素，請務必嚴格遵守「歡迎使用品牌資源中心」中，Google 品牌特徵第三方使用指南的規定。
  • 使用企業版網頁基礎模型時，系統會顯示搜尋建議晶片。包含建議方塊的欄位寬度必須與 LLM 的有依據回覆相同。

輕觸時的行為

使用者輕觸動態磚後，系統會直接將他們帶往動態磚中顯示的搜尋字詞搜尋結果網頁。搜尋結果頁面可以在應用程式內建瀏覽器或獨立瀏覽器應用程式中開啟。請勿以任何方式縮小、移除或遮蔽搜尋結果網頁。以下動畫模擬圖說明輕觸搜尋結果網頁的互動。

應用程式/電腦版廣告範例

導入搜尋建議的程式碼

使用 API 根據搜尋結果生成回覆時，模型回覆會在 renderedContent 欄位中提供符合規範的 HTML 和 CSS 樣式，您可實作這些樣式，在應用程式中顯示搜尋建議。

後續步驟