Gemini API용 URL 컨텍스트 도구 정식 출시

2025년 8월 18일
Alisa Fortin Product Manager

새로운 기능으로 가득한 URL 컨텍스트 도구가 오늘부터 확장된 프로덕션에 사용할 수 있도록 준비 완료되었습니다. 개발자는 이 도구를 사용해 콘텐츠를 수동으로 업로드하는 대신 URL 형식으로 모델에 추가 컨텍스트를 제공할 수 있습니다. 이를 통해 더욱 강력하고 상황에 맞는 생성형 AI 애플리케이션을 활용할 수 있습니다.

기본적으로, Gemini 모델은 정적 기술 자료를 갖고 있으며 인터넷에 직접 액세스하지는 않습니다. Google 검색으로 그라운딩 기능은 웹에 Gemini 모델을 연결하여 실시간 검색을 광범위하게 할 수 있습니다. 보다 심층적인 분석을 위해, URL 컨텍스트 도구검색 스니펫 이상의 기능을 제공하여 모델이 특정 웹페이지의 전체 콘텐츠를 수집하고 추론할 수 있도록 합니다. Google 검색을 사용하여 검색하고 URL 컨텍스트 도구를 사용하여 분석하는 이 강력한 조합은 정교한 다단계 작업의 토대가 됩니다.


확장된 콘텐츠 지원으로 더욱 다재다능해진 기능

이번 출시를 통해 URL 컨텍스트 도구는 프롬프트의 근거로 삼을 수 있는 콘텐츠 유형을 크게 확대했고 덕분에 더 다양한 범위의 응용 분야에서 더 유연하게 사용할 수 있게 되었습니다. 지원 대상에는 다음이 포함됩니다.

  • PDF 지원: 이제 PDF에 대한 직접 링크를 제공할 수 있습니다. 이를 통해 Gemini는 텍스트를 추출할 뿐만 아니라 테이블과 테이블 내부의 전체 구조를 이해할 수 있어 근거 자료로 활용하기 위한 보고서, 논문, 매뉴얼에 온전히 접근할 수 있습니다.

  • 이미지 지원: URL 컨텍스트 도구가 이제 PNG, JPEG, BMP 및 WebP 형식을 포함한 이미지를 처리하고 분석할 수 있습니다. 이를 통해 Gemini의 멀티모달 기능을 활용하여 시각 정보를 이해하고 차트와 다이어그램 등을 분석할 수 있는 가능성을 열어 줍니다.

  • 웹 및 데이터 파일: 표준 웹페이지(HTML), 구조화된 데이터(JSON, XML, CSV), 텍스트 파일(일반 텍스트, RTF, CSS, JavaScript)에 대한 강력한 지원을 지속적으로 제공합니다.


프로덕션 스케일에 맞춰 준비 완료

이런 확장된 기능을 애플리케이션에서 사용할 수 있도록 URL 컨텍스트 도구가 이제 업데이트된 제한 및 가격으로 확장된 프로덕션 사용을 위한 준비를 마쳤습니다. 요금 제한은 이제 사용자가 선택한 특정 Gemini 모델에 따라 달라지고, 훨씬 더 큰 규모로 활용할 수도 있습니다. 모델의 표준 요금을 기준으로 상황에 따라 추가된 입력 토큰에 대해 요금이 부과됩니다. 이를 통해 비용을 명확하게 예측할 수 있습니다.


새로운 사용 사례 활용

URL 컨텍스트 도구는 개발자를 위해 다양한 에이전트 워크플로를 제공합니다. 현재 구축할 수 있는 사용 사례에는 다음이 포함됩니다.

  • 고객 상호 작용 맞춤설정: 고객의 웹페이지를 AI 채팅 에이전트에 연동시켜 문의 사항에 대해 정확하고 관련성 높은 답변을 제공할 수 있도록 합니다.

  • 문서 비교: 여러 보고서, 기사 또는 PDF를 분석하여 차이점을 식별하고 추세를 추적합니다.

  • 콘텐츠 합성 및 생성: 여러 소스 URL의 정보를 결합하여 정확한 요약본, 블로그 게시물 또는 보고서를 생성합니다.

  • 코드 및 문서 분석: GitHub 리포지토리 또는 기술 문서를 참조해 코드를 설명하거나, 설정 지침을 생성하거나, 기술적 질문에 답변합니다.


URL 컨텍스트 사용 사례

개발자들이 URL 컨텍스트 도구로 놀라운 앱을 개발하는 사례를 이미 많이 보고 있습니다. 두 가지 실제 사례를 소개하겠습니다.

Gemini CLI: Gemini CLI는 터미널에서 직접 Gemini에 대한 액세스 권한을 제공하는 오픈소스 AI 에이전트입니다. Gemini CLI는 웹페이지 요약, 주요 정보 추출 또는 다른 언어로의 번역과 같은 사용 사례에서 개발자가 웹 콘텐츠와 빠르고 쉽게 상호 작용할 수 있도록 웹 가져오기 명령을 위해 URL 컨텍스트 도구를 사용합니다.

Web fetch tool in Gemini CLI
Gemini CLI의 웹 가져오기 도구

Gladly.ai: 고객 서비스 플랫폼인 Gladly는 URL 컨텍스트 도구를 사용하여 고도의 맞춤형 고객 경험을 만듭니다. Gladly의 AI 플랫폼을 기반으로 개발된 에이전트는 고객의 웹사이트에 대한 링크를 제공함으로써 최신 제품 정보, 프로모션, 지원 기사에 액세스하고 이를 이해하여 고객의 문의에 보다 정확하고 관련성 높은 답변을 제공할 수 있습니다.


지금 시작하세요

URL 컨텍스트 도구로 개발을 시작할 준비가 되셨나요? 다음은 시작하는 데 도움이 되는 예시입니다.

from google import genai
from google.genai.types import Tool, GenerateContentConfig
client = genai.Client()
 
model_id = "gemini-2.5-flash"
tools = [
     {"url_context": {}},
 ]
 
 
response = client.models.generate_content(
    model=model_id,
    contents="What are the top 3 recent announcements from the Gemini API according to https://ai.google.dev/gemini-api/docs/changelog",
    config=GenerateContentConfig(
        tools=tools,
    )
)
for each in response.candidates[0].content.parts:
   print(each.text)
Python

URL 컨텍스트 설명서로 이동하여 자세히 알아보고 코드 샘플을 확인하세요. 미니 데모 앱을 통해 도구의 작동 방식을 확인해 보거나 Google AI Studio의 'Tools'에서 URL 컨텍스트 토글을 찾아 직접 사용해 보세요.

여러분이 무엇을 개발하실지 정말 기대됩니다!