한 장의 그림으로 이해하기

그림 크게 보기 ↗ (새 탭)
모델·API · 판정 관망
그림을 글로 풀면
목록과 본문 주소 구분
URL context에 목록 주소만 전달했다면 필요한 별도 본문 주소도 명시하고 조회 결과를 확인합니다.
- 대상
- Gemini API로 여러 웹 문서를 비교하는 개발자
- 무엇이 바뀜
- 지정한 URL의 내용과 그 안에 연결된 페이지는 다릅니다.
- 왜 중요한가
- 누락된 자료를 비교에 포함했다고 착각할 수 있습니다.
- 지금 할 일
- 필요한 본문 URL과 응답의 조회 상태를 대조합니다.
- 한계·미확인
- 개념 비유입니다. 공개 접근 조건이 있으며 API 실행 시험은 하지 않았습니다.
- 공식 출처
- ai.google.dev
- 확인일
- 2026-09-26
선반을 가리키는 것과 책을 건네는 것
가상의 팀이 여러 제품의 사용 조건을 비교하려고 자료실 목록 주소 하나를 전달했다고 생각해 봅니다. 답변이 자연스러워도 각각의 상세 문서를 읽었다는 증거는 되지 않습니다. 그림에서 독자가 고치는 행동은 질문을 길게 반복하는 것이 아니라, 비교에 필요한 본문 책을 직접 골라 건네는 일입니다.
요청한 주소의 범위를 확인하기
Gemini의 URL context는 URL을 문맥으로 제공하는 도구입니다. 공식 안내는 전달한 주소의 내용을 가져오며 그 페이지 안의 연결 링크를 자동으로 모두 읽지는 않는다고 설명합니다. 목록에 필요한 정보가 이미 있으면 활용할 수 있지만, 별도 상세 페이지의 내용까지 필요하다면 그 주소를 명시해야 합니다. 이 설명은 URL context의 범위이며 모든 AI 브라우징 도구의 동작을 일반화한 것이 아닙니다.
조회 확인과 내용 검토를 따로 남기기
사용 전 도구를 지원하는 모델과 요청 형식을 확인합니다. 공식 문서의 Interactions 응답에는 URL 조회 시도와 상태를 담은 url_context_result, 출처 연결을 위한 url_citation 설명이 있습니다. 현재 쓰는 API와 SDK의 실제 필드에 맞춰 요청 주소·조회 상태·답변의 근거를 대조하는 방식을 제안합니다. 로그인 뒤의 자료처럼 공개 접근이 안 되는 페이지는 이 방식의 입력으로 전제하지 않습니다. 조회 성공도 내용의 정확성·최신성을 보증하지 않습니다. 이번 글에서는 실제 Gemini 요청을 실행하지 않았습니다.
참고 원문: Google Gemini API 공식 문서 — URL context · 원문 게시일 상시 문서(확인일 기준) · 확인일 2026-09-26
AI 작성·자동 검증: 공식 자료와의 대조 및 게시 구조 검사. 사람의 개별 검수와 제품 실행 시험은 수행하지 않았습니다. 그림은 신규 생성한 개념 일러스트입니다.
이 글의 검증 카드
- 자료 버전
- URL context 상시 문서, 마지막 수정2026-09-23 UTC 표기·2026-09-26 확인. 명시한 URL과 nested links 구분, Interactions 응답 설명 기준. 실제 API 시험 없음
- 확인일
- 2026-09-26
- 검증 상태
- 개발자 주장
- 한계·주의
- 개념 비유입니다. 공개 접근 조건이 있으며 API 실행 시험은 하지 않았습니다.
함께 더 정확하게
질문·오류 제보
그림에서 이해되지 않는 부분이나 달라진 내용을 알려 주세요. 관리자가 확인하고 승인한 글만 공개됩니다.
개발에서는 이메일 인증 가입 또는 관리자 발급 계정으로 참여할 수 있습니다. 계정·이용 문의
아직 계정이 없으신가요? 회원가입
공개된 질문·제보
아직 공개된 질문·제보가 없습니다. 궁금한 부분을 먼저 남겨 주세요.