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

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

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

개요

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

색인 최신 상태 및 선별

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

제품 선택

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

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

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

지원되는 모델

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

API 사용

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

디스플레이 요구사항

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

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

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

탭할 때 동작

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

앱/데스크톱 예시

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

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

다음 단계