Google 검색으로 그라운딩

Google 검색을 사용한 그라운딩은 Gemini 모델을 실시간 웹 콘텐츠에 연결하며 지원되는 모든 언어로 작동합니다. 이를 통해 Gemini가 지식 단절을 넘어 더 정확한 대답을 제공하고 검증 가능한 출처를 인용할 수 있습니다.

그라운딩을 사용하면 다음 작업을 할 수 있는 애플리케이션을 빌드할 수 있습니다.

• 사실에 기반한 정확성 개선: 실제 정보를 기반으로 응답하여 모델 할루시네이션을 줄입니다.
• 실시간 정보 액세스: 최근 이벤트 및 주제에 관한 질문에 답변합니다.

• 인용 제공: 모델의 주장에 대한 출처를 표시하여 사용자 신뢰를 구축합니다.

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3.6-flash",
    input="Who won the euro 2024?",
    tools=[{"type": "google_search"}]
)

print(interaction.output_text)

import { GoogleGenAI } from "@google/genai";

const client = new GoogleGenAI({});

const interaction = await client.interactions.create({
    model: "gemini-3.6-flash",
    input: "Who won the euro 2024?",
    tools: [{ type: "google_search" }]
});

console.log(interaction.output_text);

curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.6-flash",
    "input": "Who won the euro 2024?",
    "tools": [{"type": "google_search"}]
  }'

Google 검색을 사용한 그라운딩 작동 방식

google_search 도구를 사용 설정하면 모델이 정보 검색, 처리, 인용의 전체 워크플로를 자동으로 처리합니다.

1. 사용자 프롬프트: 애플리케이션이 google_search 도구를 사용 설정한 상태로 사용자 프롬프트를 Gemini API로 전송합니다.
2. 프롬프트 분석: 모델이 프롬프트를 분석하고 Google 검색으로 답변을 개선할 수 있는지 확인합니다.
3. Google 검색: 필요한 경우 모델이 하나 이상의 검색어를 자동으로 생성하고 실행합니다.
4. 검색 결과 처리: 모델이 검색 결과를 처리하고 정보를 합성하여 응답을 구성합니다.
5. 그라운딩된 응답: API가 검색 결과에 그라운딩된 최종 사용자 친화적인 응답을 반환합니다. 이 응답에는 인용이 포함된 인라인 annotations가 있는 모델의 텍스트 답변과 검색어 및 추천 검색어가 있는 google_search_call 및 google_search_result 단계가 포함됩니다.

그라운딩 응답 이해

응답이 성공적으로 그라운딩되면 모델의 텍스트 출력에 텍스트 콘텐츠 블록에 직접 인라인 annotations가 포함됩니다. 이러한 주석은 응답의 일부를 출처에 연결하는 인용 정보를 제공합니다.

{
  "steps": [
    {
      "type": "thought",
      "summary": [
        {
          "type": "text",
          "text": "The user is asking for the winner of Euro 2024. I need to search for the result of the Euro 2024 final."
        }
      ],
      "signature": "CoMDAXLI2nynRYojJIy6B1Jh9os2crpWLfB0..."
    },
    {
      "type": "google_search_call",