한 장의 그림으로 이해하기

그림 크게 보기 ↗ (새 탭)
모델·API · 판정 관망
그림을 글로 풀면
검색 입력의 역할 구분
Gemini 001의 일반 검색은 질문과 대상 문서의 작업 유형을 구분합니다.
- 대상
- 문서 검색 기능을 만드는 개발자
- 무엇이 바뀜
- 검색 요청과 대상 문서는 서로 다른 역할을 맡습니다.
- 왜 중요한가
- 같은 설정을 반복하면 입력 역할을 놓칠 수 있습니다.
- 지금 할 일
- 모델 이름과 입력 역할에 맞는 설정을 확인합니다.
- 한계·미확인
- 개념 비유. Gemini API 호출·검색 품질 시험 없음.
- 공식 출처
- ai.google.dev
- 확인일
- 2026-10-06
가상의 사내 문서 검색을 준비한다면
직원이 규정 문서를 찾는 검색 기능을 만든다고 생각해 봅니다. 미리 준비하는 문서 묶음과 사용자가 나중에 입력하는 검색어는 모두 글이지만 맡은 역할은 다릅니다. 그림의 사서는 자료를 준비하고 방문자는 질문으로 자료를 찾습니다. AINOW는 임베딩 생성 기록에 입력 내용만 남기기보다 문서용인지 검색 요청용인지도 함께 표시하도록 제안합니다.
001에서는 일반 검색의 두 역할을 구분한다
임베딩은 입력을 비교에 사용할 수 있는 수치 표현으로 바꾸는 방식입니다. Google 문서에서 gemini-embedding-001은 task_type으로 용도를 지정할 수 있습니다. 일반 검색 요청에는 RETRIEVAL_QUERY, 찾을 대상 문서에는 RETRIEVAL_DOCUMENT를 안내합니다. 질문에 답할 근거를 찾는 QUESTION_ANSWERING 등 별도 유형도 있으므로 모든 질문형 문장을 한 유형으로 단정하지 않고 기능 목적을 먼저 정합니다.
모델을 바꿨다면 같은 설정을 그대로 보내지 않기
현재 문서는 gemini-embedding-2에서 task_type 필드를 사용할 수 없고 작업 지시를 입력 형식으로 전달하도록 구분합니다. 따라서001에서 사용한 설정을 다른 모델에 그대로 옮긴다고 가정하지 않습니다. AINOW는 모델 이름, 문서·질문 역할, 적용 설정을 함께 기록하고 대표 검색어로 결과를 비교하도록 제안합니다. 이번 글에서는 API 호출이나 정확도 비교를 실행하지 않았으며 역할을 맞추는 것만으로 원하는 문서나 올바른 답변이 보장되지는 않습니다.
참고 원문: Google Gemini API 공식 문서 — Embeddings의 모델별 작업 유형 · 원문 게시일 상시 문서(확인일 기준) · 확인일 2026-10-06
AI 작성·자동 검증: 공식 자료와의 대조 및 게시 구조 검사. 사람의 개별 검수와 제품 실행 시험은 수행하지 않았습니다. 그림은 신규 생성한 개념 일러스트입니다.
이 글의 검증 카드
- 자료 버전
- gemini-embedding-001 및 gemini-embedding-2 문서2026-10-06 확인. 이 글의 task_type 설정은001에 한정. 실제 API·검색 품질 시험 없음
- 확인일
- 2026-10-06
- 검증 상태
- 개발자 주장
- 한계·주의
- 개념 비유. Gemini API 호출·검색 품질 시험 없음.
함께 더 정확하게
질문·오류 제보
그림에서 이해되지 않는 부분이나 달라진 내용을 알려 주세요. 관리자가 확인하고 승인한 글만 공개됩니다.
개발에서는 이메일 인증 가입 또는 관리자 발급 계정으로 참여할 수 있습니다. 계정·이용 문의
아직 계정이 없으신가요? 회원가입
공개된 질문·제보
아직 공개된 질문·제보가 없습니다. 궁금한 부분을 먼저 남겨 주세요.