구글, 제미나이 API에 '도구 검색' 도입…필요한 도구만 불러온다
구글이 19일(현지시간) 제미나이 인터랙션 API에 '도구 검색(Tool Retrieval)'을 미리보기로 추가했다. 에이전트가 도구 스키마를 보류해 두고 필요할 때만 불러오는 방식으로, 별도 요금은 없으며 제미나이 3.6 이후 모델과 제미나이 4 전 모델을 지원한다.
구글이 19일(현지시간) 제미나이 API에 '도구 검색(Tool Retrieval)' 기능을 미리보기로 추가했다. AI 에이전트가 수십~수백 개 도구를 연결해 두되, 작업에 필요한 도구의 상세 정의만 그때그때 불러오게 하는 기능이다. 제미나이 API 제품 매니저 루시아 로허와 구글 딥마인드 연구원 노라 카스너가 구글 공식 블로그를 통해 발표했다.

핵심 정리
- 요청에 tool_search 도구를 넣고 나머지 도구에 defer_loading: true를 지정하면, 모델은 필요할 때까지 도구 이름과 짧은 설명만 본다.
- 별도 요금은 없지만 서버 쪽 검색 한 번마다 모델 호출이 추가로 일어나 입력 토큰 단가로 과금된다.
- 인터랙션 API(v1beta)에서만 쓸 수 있고 제미나이 3.6 이후 모델, 제미나이 4 전 모델을 지원한다.
제미나이 API 도구 검색, 어떻게 작동하나
도구를 많이 연결한 에이전트는 보통 요청마다 모든 도구의 매개변수 스키마를 통째로 보낸다. 구글 개발자 문서는 "함수 선언 수십 개가 요청마다 수만 토큰을 차지할 수 있다"며, 후보 도구가 늘수록 도구 선택 정확도도 떨어진다고 설명했다.
도구 검색을 켜면 보류된 도구는 이름과 설명만 문맥에 남는다. 모델이 특정 도구가 필요하다고 판단하면 이름으로 요청하고, API가 스키마를 불러온 뒤 모델이 함수를 호출한다. 이 과정이 한 번의 요청 안에서 끝난다.
검색은 구글 서버에서 돌아가므로 개발자가 별도 색인을 만들거나 운영할 필요가 없다. 원격 MCP 서버에 defer_loading을 지정하면 그 서버가 제공하는 도구 전체가 필요할 때만 불러와진다.
자체 도구 목록이 있다면 '클라이언트 검색'
자체 도구 목록을 운영하는 팀은 검색 도구를 "execution": "client"로 선언할 수 있다. 앱이 직접 검색해 맞는 스키마를 돌려주는 방식이라 검색마다 왕복 통신이 한 번 늘어난다. 대신 대화 도중 새 도구를 붙일 수 있다.
요금과 제약
토큰은 호출한 모델의 표준 단가로 과금된다. 보류된 도구는 이름과 짧은 설명만 입력 토큰에 잡히고, 매개변수 스키마는 실제로 불러올 때부터 과금된다. 다만 서버 쪽 검색은 모델을 한 번 더 호출하는 만큼 그 토큰이 따로 집계된다.
구글도 한계를 숨기지 않았다. 문서는 "안정적인 도구 20개 미만"이면 기존처럼 한꺼번에 싣는 방식이 낫고, 도구가 적거나 문맥이 매우 길어 매 턴 검색이 일어나면 기존 방식이 "더 저렴할 수 있다"고 적었다. 토큰 절감률이나 정확도 개선 수치는 공개하지 않았고, 각자 트래픽으로 측정해 보라고 권했다.
지원 모델은 제미나이 4 카본·네온·하이드로젠·아르곤과 제미나이 3.8 플래시·3.6 플래시다.
맥락: 앤트로픽이 1년 앞서 내놓은 방식
설계는 앤트로픽이 2025년 11월 24일 클로드용으로 공개한 '도구 검색 도구(Tool Search Tool)'와 매우 닮았다. 같은 defer_loading: true 표시를 쓴다. 앤트로픽은 발표문에서 MCP 서버 5개, 도구 58개를 연결하면 대화 시작 전부터 약 5만5000토큰이 쓰인다고 밝혔고, 예시에서 토큰 사용량이 85% 줄었다고 했다. 내부 MCP 평가 정확도는 클로드 오퍼스 4가 49%에서 74%로, 오퍼스 4.5가 79.5%에서 88.1%로 올랐다고 회사는 설명했다.
전망
도구 검색은 아직 미리보기 단계로, 구글 문서는 정식 출시 전에 API 형태가 바뀔 수 있다고 밝혔다. 실제 에이전트 업무에서 비용·정확도를 독립적으로 측정한 결과가 다음 관심사다.
자주 묻는 질문
도구 검색에 추가 요금이 붙나? 별도 요금은 없다. 서버 검색 호출에 쓰인 토큰을 포함해 표준 토큰 단가가 적용된다.
generateContent에서도 쓸 수 있나? 아니다. v1beta 버전의 인터랙션 API에서만 지원한다.
언제는 안 쓰는 게 낫나? 구글은 자주 바뀌지 않는 도구가 20개 미만이거나, 긴 문맥 탓에 매 턴 검색이 일어나는 경우 기존 방식을 권한다.
참고 자료
- Introducing Tool Retrieval in the Gemini API — 구글(2026년 11월 19일)
- Tool retrieval — 제미나이 API 문서, 구글(2026년 11월 21일 확인)
- Introducing advanced tool use for Claude — 앤트로픽(2025년 11월 24일)
댓글 0
현재 댓글 작성이 비활성화되어 있습니다.