Google, Gemini 2.5 Pro 그라운딩 API 정식 GA—실시간 웹 검색 RAG 파이프라인 통합
Google DeepMind가 Gemini 2.5 Pro의 Google 검색 그라운딩(Grounding with Google Search) 기능을 API에서 정식 GA로 전환했다. 개발자는 별도 검색 파이프라인 없이 단일 API 호출로 최신 웹 정보를 모델 응답에 직접 주입할 수 있으며, 한국어 쿼리에서도 검색 앵커 및 인용 메타데이터가 함께 반환된다.
무엇이 바뀌었나
Google AI Studio 및 Vertex AI에서 제공되던 Gemini 2.5 Pro의 그라운딩 기능이 2026년 5월 15일부로 프리뷰 딱지를 떼고 정식 GA로 전환됐다. 이제 tools 파라미터에 googleSearch 객체를 추가하는 것만으로 모델이 실시간 검색 결과를 컨텍스트로 활용한다. 응답 객체에는 groundingChunks와 groundingSupports 필드가 포함돼, 각 문장이 어떤 검색 결과에 근거하는지 인용 단위로 추적할 수 있다.
import google.generativeai as genai
model = genai.GenerativeModel(
model_name="gemini-2.5-pro",
tools=[{"google_search": {}}]
)
response = model.generate_content("2026년 5월 기준 한국 기준금리는?")
print(response.candidates[0].grounding_metadata)
개발자·크리에이터에게 왜 중요한가
기존에는 최신 정보를 LLM에 주입하려면 ①검색 API 별도 호출 → ②컨텍스트 청킹 → ③프롬프트 삽입이라는 3단계가 필요했다. 그라운딩 GA 이후에는 이 파이프라인이 API 내부로 흡수되므로 RAG 구축 공수가 대폭 감소한다. 특히 뉴스레터 자동화, 실시간 가격 비교 서비스, 최신 공시 기반 금융 챗봇처럼 데이터 신선도(freshness)가 핵심인 한국어 프로덕트에 즉시 적용 가능하다. 또한 인용 메타데이터 덕분에 환각 검증 로직을 별도 레이어 없이 UI에 직접 노출할 수 있어 신뢰도 높은 B2B 서비스 설계에 유리하다.
요금 및 제한 사항
| 항목 | 내용 | |------|------| | 그라운딩 호출 단가 | 공식 페이지 참조 (검색 쿼리 건당 별도 과금 구조 유지) | | 지원 모델 | Gemini 2.5 Pro (Flash 티어는 별도 일정) | | 일일 무료 한도 | Google AI Studio 무료 플랜: 1,500 req/day | | 응답 내 최대 검색 앵커 수 | 요청당 최대 20개 | | 지역 제한 | 한국(ap-northeast-3) 리전 Vertex AI에서 정식 지원 확인 |
주의: 그라운딩 결과는 Google 검색 색인 기준이므로 내부 문서나 비공개 데이터에는 적용되지 않는다. 사내 지식베이스와 병행할 경우 Vertex AI Search와 하이브리드 구성을 권장한다.
한국 개발자 적용 체크리스트
google-generativeaiSDK를 0.8.0 이상으로 업그레이드- API 키 또는 서비스 계정에
generativelanguage.googleapis.com그라운딩 권한 확인 - 응답의
groundingChunks[].web.uri필드를 프론트엔드 인용 UI에 연결 - 한국어 쿼리 테스트 시
language_code: "ko"힌트를 시스템 프롬프트에 명시하면 검색 품질 향상