엔터프라이즈용 웹 그라운딩

이 페이지에서는 기업 규정 준수 관리를 위한 웹 그라운딩과 엔터프라이즈용 웹 그라운딩 API를 사용하여 웹에서 그라운딩된 응답을 생성하는 방법을 설명합니다. 색인이 생성된 콘텐츠는 Google 검색에서 사용할 수 있는 콘텐츠의 하위 집합이며 금융, 의료, 공공 부문과 같이 규제가 엄격한 업종의 고객에게 적합합니다.

추가 규정 준수 관리가 필요하지 않은 경우 보다 다양한 최신 웹 색인에 액세스할 수 있는 Google 검색으로 그라운딩을 사용합니다.

개요

엔터프라이즈용 웹 그라운딩은 그라운딩된 응답을 생성하는 데 사용되는 웹 색인을 사용합니다. 이 서비스는 고객 데이터를 로깅하지 않으며 VPC 서비스 제어를 지원합니다. 자세한 내용은 생성형 AI의 보안 제어를 참조하세요. 고객 데이터가 저장되지 않으므로 고객 관리 암호화 키(CMEK) 및 액세스 투명성(AxT)이 적용되지 않습니다.

색인 최신성 및 큐레이션

엔터프라이즈용 웹 그라운딩의 웹 색인은 의료, 금융, 공공 부문 업계의 고객이 예상하는 요구사항을 충족하기 위해 자동으로 선택됩니다. 구체적인 업데이트 일정은 다라질 수 있지만, 빠르게 변화하는 콘텐츠는 6시간마다 업데이트되고 전체 색인은 24시간마다 업데이트됩니다.

제품 선택

적절한 그라운딩 도구를 선택하는 것은 규정 준수 관리 및 정보의 최신성 요구사항과 관련된 조직의 구체적인 요구사항에 따라 달라집니다.

  • Google 검색을 사용한 그라운딩: 그라운딩된 응답에서 최고 품질과 최신 정보를 원하는 고객에게 권장되는 옵션입니다. 최신성은 응답을 생성하는 데 사용되는 웹 정보가 얼마나 최신인지에 대한 것입니다. 웹에서 가장 최신이고 포괄적인 정보에 액세스하는 것이 중요한 사용 사례에 매우 중요합니다. Google 검색을 사용한 그라운딩은 서비스별 약관에 따라 최대 30일 동안 안정성 로그를 저장합니다. Google 그라운딩 으로 처리된 고객 데이터를 기반으로 학습하지 않습니다.

  • 엔터프라이즈용 웹 그라운딩: 이 솔루션은 '고객 데이터 로깅 금지'를 포함한 엄격한 규정 준수 요구사항이 있는 기업 고객을 위해 특별히 설계되었습니다 . 엔터프라이즈용 웹 그라운딩은 추가 규정 준수 관리가 필요한 규제가 엄격한 업계의 조직에 권장되는 선택입니다. 엔터프라이즈용 웹 그라운딩은 고객 데이터를 저장하지 않습니다.

지원되는 모델

이 섹션에는 엔터프라이즈용 웹 그라운딩을 지원하는 모델이 나와 있습니다.

클릭하여 지원되는 모델 펼치기

Gemini 3 Pro 및 Gemini 3 Pro Image는 일일 검색어 5,000개로 제한됩니다.

API 사용

이 섹션에서는 Gemini Enterprise Agent Platform에서 생성형 AI API Gemini 2를 사용하여 Gemini로 그라운딩된 응답을 만드는 샘플 요청을 제공합니다. API를 사용하려면 다음 필드를 설정해야 합니다.

  • Contents.parts.text: 사용자가 API에 전송하려는 텍스트 쿼리입니다.
  • tools.enterpriseWebSearch: 이 도구가 제공되면 Gemini에서 엔터프라이즈용 웹 그라운딩을 사용할 수 있습니다.

Python

설치

pip install --upgrade google-genai

자세한 내용은 SDK 참고 문서를 참고하세요.

Vertex AI에서 생성형 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_ENTERPRISE=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.5-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)로 바로 이동합니다.
금지사항
  • 사용자 탭과 SRP 디스플레이 사이에 화면이나 추가 단계를 포함합니다.
  • 추천 검색어 또는 연결된 그라운딩된 LLM 응답 옆에 다른 검색 결과나 추천을 표시합니다.

디스플레이 요구사항

다음은 디스플레이 요구사항입니다.

  • 추천 검색어를 제공된 대로 정확하게 표시하고 색상, 글꼴 또는 모양을 수정하지 마세요. 추천 검색어가 밝은 모드와 어두운 모드와 같은 다음 모의에 지정된 대로 렌더링되는지 확인합니다.

  • 그라운딩된 응답이 표시될 때마다 해당 추천 검색어가 계속 표시되어야 합니다.
  • 브랜딩의 경우 브랜드 리소스 센터 시작에서 Google 브랜드 표시의 서드 파티 사용에 관한 Google 가이드라인을 엄격하게 준수해야 합니다.
  • 엔터프라이즈용 웹 그라운딩을 사용하면 추천 검색어 칩이 표시됩니다. 추천 검색어 칩이 포함된 필드는 LLM의 그라운딩된 응답과 너비가 같아야 합니다.

탭할 때 동작

사용자가 칩을 탭하면 칩에 표시된 검색어의 검색 결과 페이지(SRP)로 바로 이동합니다. SRP는 애플리케이션 내부 브라우저 또는 별도의 브라우저 애플리케이션에서 열 수 있습니다. 어떠한 방식으로든 SRP 디스플레이를 최소화, 삭제 또는 방해하지 않는 것이 중요합니다. 다음 애니메이션 목업에서는 탭-SRP 상호작용을 보여줍니다.

앱/데스크톱 예시

추천 검색어를 구현하는 코드

API를 사용하여 검색에 대한 응답을 그라운딩하는 경우, 모델 응답은 애플리케이션에서 추천 검색어를 표시하기 위해 구현하는 renderedContent 필드에 호환되는 HTML 및 CSS 스타일을 제공합니다.

다음 단계