병렬 웹 검색을 사용한 그라운딩

프리뷰

이 기능에는 서비스별 약관이 적용됩니다. GA 이전 기능은 '있는 그대로' 제공되며 지원이 제한될 수 있습니다. 자세한 내용은 출시 단계 설명을 참조하세요.

Parallel Web Systems는 그라운딩을 위해 대규모 언어 모델에서 사용하도록 최적화된 공개 웹 데이터에 액세스할 수 있는 검색 API를 제공합니다. 이 페이지에서는 Parallel을 사용하여 Gemini 대답을 그라운딩하는 방법을 설명합니다.

Vertex AI의 Parallel을 사용한 그라운딩은 Google Cloud 계약에 정의된 별도의 제품으로, Gemini 모델을 Parallel Web Systems' 검색 API에서 제공하는 공개 웹 데이터에 연결합니다. 이 서비스를 통해 Gemini는 수십억 개의 웹페이지에서 실시간 정보에 액세스하여 최신 정보를 반영하고 사실에 기반한 대답을 제공할 수 있습니다.

다음 사항에 유의하세요. Parallel을 사용하려면 Google Cloud에서 처리를 위해 특정 고객 데이터를 Parallel 별도 제품에 전송해야 합니다. Parallel 서비스 사용에는 Parallel의 별도 이용약관 및 Parallel의 허용되는 사용 정책이 적용됩니다.

참고: 웹 게시자의 경우 Vertex AI에서 Parallel을 사용하여 그라운딩할 때 ShapBot을 허용하지 않는 웹페이지는 그라운딩에 사용되지 않습니다. 웹 게시자는 robots.txt 파일을 사용하여 선택 해제를 관리할 수 있습니다.

사용 사례

Parallel을 사용한 그라운딩은 다음과 같은 사용 사례에 적합합니다.

• 정보 완성 또는 보강 목적으로 웹 데이터를 사용합니다.
• 더 복잡한 질문에 대해 더 심층적인 웹 검색이 필요한 멀티홉 에이전트
• 웹 검색 데이터를 통합하는 API를 빌드합니다.
• 최신 웹 정보를 사용하여 최종 사용자가 질문하고 복잡한 보고서를 만들 수 있는 직원용 어시스턴트
• 사용자가 정보에 기반한 구매 결정을 내릴 수 있는 소매, 여행과 같은 소비자 대상 애플리케이션
• 뉴스 분석, KYC 확인과 같은 자동화된 작업을 실행하기 위해 자율적으로 실행되는 자동화된 에이전트입니다.
• 웹에서 최신 컨텍스트를 가져오는 업종별 에이전트 (영업 에이전트, 코딩 에이전트, 금융 에이전트)

예시

2025년 라스베이거스 F1 그랑프리 우승자는 누구야?

그라운딩 없음	접지 포함
2025년 라스베이거스 그랑프리는 아직 개최되지 않았습니다. 이 경주는 2025년 11월 20~22일 주말에 개최될 예정입니다. 따라서 현재 승자를 알 수 없습니다.	2025년 라스베이거스 F1 그랑프리의 우승자는 Red Bull Racing의 Max Verstappen입니다. 레이스는 2025년 11월 22일에 진행되었습니다. 소스: domain1.com, domain2.com, ...

지원되는 모델

이 섹션에는 병렬 웹 검색을 통한 그라운딩을 지원하는 모델이 나와 있습니다.

• Gemini 3 Flash 프리뷰 프리뷰 모델
• Gemini 3 Pro 프리뷰 프리뷰 모델
• Gemini 3 Pro Image 프리뷰 프리뷰 모델
• Gemini 2.5 Pro
• Gemini 2.5 Flash 프리뷰 프리뷰 모델
• Gemini 2.5 Flash-Lite 프리뷰 프리뷰 모델
• Gemini 2.5 Flash
• Gemini 2.5 Flash-Lite
• Gemini Live API 네이티브 오디오를 사용한 Gemini 2.5 Flash
• Live API 네이티브 오디오를 사용한 Gemini 2.5 Flash(프리뷰) 프리뷰 프리뷰 모델
• Live API를 사용한 Gemini 2.0 Flash 프리뷰 프리뷰 모델
• Gemini 2.0 Flash

시작하기 전에

Parallel을 사용한 그라운딩을 사용하려면 Parallel 웹사이트에서 API 키를 가져와야 합니다. 이 API 키는 Gemini에 대한 요청에 사용됩니다.

Parallel을 사용하여 Gemini 응답 그라운딩

다음과 같이 REST API를 사용하여 Gemini에 그라운딩된 대답을 요청합니다. 최적의 성능을 위해서는 기본값이 아닌 값이 엄격하게 필요한 경우가 아니라면 선택적 매개변수에 기본 설정을 사용하는 것이 좋습니다.

REST

요청 데이터를 사용하기 전에 다음을 바꿉니다.

• LOCATION: 요청을 처리하는 리전입니다. 전역 엔드포인트를 사용하려면 엔드포인트 이름에서 위치를 제외하고 리소스 위치를 `global`로 구성합니다.
• PROJECT_ID: Google Cloud 프로젝트 ID입니다.
• MODEL_ID: 사용할 모델의 ID입니다.
• TEXT: 모델에 전송할 텍스트 프롬프트
• API_KEY: Parallel AI Search의 API 키입니다.
• EXCLUDE_DOMAINS: (선택사항) 그라운딩 소스에서 제외할 도메인 목록입니다. 지정된 경우 이러한 도메인의 소스가 제외됩니다. 허용되는 값은 도메인 (www.example.com) 또는 마침표로 시작하는 도메인 확장 프로그램(.gov, .edu, .co.uk)입니다. 최대 10개의 도메인을 지정할 수 있습니다.
• INCLUDE_DOMAINS: 선택사항: 그라운딩 소스에 포함할 도메인 목록입니다. 지정된 경우 이러한 도메인의 소스가 포함됩니다. 허용되는 값은 도메인 (www.example.com) 또는 마침표로 시작하는 도메인 확장자(.gov, .edu, .co.uk)입니다. 최대 10개의 도메인을 지정할 수 있습니다.
• MAX_CHARS_PER_RESULT: (선택사항) 각 검색 결과 발췌문에 포함할 최대 문자 수입니다. 지정되지 않은 경우 기본값은 30000입니다. 허용되는 범위는 [1000, 100000]입니다.
• MAX_CHARS_TOTAL: 선택사항: 모든 검색 결과 발췌문의 최대 총 문자 수입니다. 지정되지 않은 경우 기본값은 100000입니다. 허용되는 범위는 [1000, 1000000]입니다.
• MAX_RESULTS: 선택사항: 그라운딩에 사용할 최대 검색 결과 수입니다. 지정되지 않은 경우 기본값은 10입니다. 허용되는 범위는 [1, 20]입니다.

HTTP 메서드 및 URL:

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": [{
    "parallelAiSearch": {
        "api_key": "API_KEY",
        "customConfigs": {
            "source_policy": {
                "exclude_domains": ["EXCLUDE_DOMAINS"],
                "include_domains": ["INCLUDE_DOMAINS"],
            },
            "excerpts": {
                "max_chars_per_result": MAX_CHARS_PER_RESULT,
                "max_chars_total": MAX_CHARS_TOTAL
            },
            "max_results": MAX_RESULTS
        }
    }
}],
  "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 most recent Super Bowl was Super Bowl LIX (59), which was played in 2025. The winner of Super Bowl LIX was the **Philadelphia Eagles**, who defeated the Kansas City Chiefs with a score of 40-22."
          }
        ]
      },
      "finishReason": "STOP",
      "groundingMetadata": {
        "webSearchQueries": [
          "who won the last super bowl"
        ],
        "groundingChunks": [
          {
            "web": {
              "uri": "https://...",
              "title": "Super Bowl LIX",
              "domain": "domain.com"
            }
          },
          {
            "web": {
              "uri": "https://...",
              "title": "Super Bowl LIX Results",
              "domain": "domain.com"
            }
          }
        ],
        "groundingSupports": [
          {
            "segment": {
              "endIndex": 77,
              "text": "The most recent Super Bowl was Super Bowl LIX (59), which was played in 2025."
            },
            "groundingChunkIndices": [
              0,
              1
            ]
          },
          {
            "segment": {
              "startIndex": 78,
              "endIndex": 198,
              "text": "The winner of Super Bowl LIX was the **Philadelphia Eagles**, who defeated the Kansas City Chiefs with a score of 40-22."
            },
            "groundingChunkIndices": [
              0
            ]
          },
        ]
      }
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 33,
    "candidatesTokenCount": 106,
    "totalTokenCount": 284,
    "billablePromptUsage": {
      "textCount": 142
    },
    "trafficType": "ON_DEMAND",
    "promptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 33
      }
    ],
    "candidatesTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 106
      }
    ],
    "toolUsePromptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 39
      }
    ],
    "toolUsePromptTokenCount": 39,
    "thoughtsTokenCount": 106
  },
  "modelVersion": "MODEL_VERSION",
  "createTime": "CREATE_TIME",
  "responseId": "RESPONSE_ID"
}

할당량

기본 할당량은 분당 60개의 프롬프트입니다. 요율 한도를 늘려야 하는 경우 [e-mail] 및 Google 계정팀에 사용 사례와 요구사항을 문의하세요.

결제

Parallel을 사용한 그라운딩을 사용하면 다음 요금이 부과됩니다.

• Gemini 토큰 소비량: 프롬프트 토큰, 사고 토큰, 출력 토큰 자세한 내용은 가격 책정을 참조하세요.
• Gemini의 데이터로 그라운딩: 자세한 내용은 가격 책정을 참고하세요.
  • Parallel에서 제공하는 입력 토큰에는 추가 요금이 청구되지 않습니다.
• Parallel 검색 API 사용 가격 책정: 자세한 내용은 Parallel 가격 책정 페이지를 참고하세요.