Google은 11월 19일 Tool Retrieval 미리보기를 공개하며 Gemini에 대규모 함수 목록을 노출하는 방식을 바꿨습니다. 개발자는 모든 매개변수 스키마를 반복해서 보내는 대신 모델이 필요로 할 때까지 로드를 미룰 수 있습니다.
발표는 이를 Interactions API의 기능으로 규정합니다. Google은 입력 토큰 부담을 줄이고 도구가 늘어날 때 선택 정확도를 유지하는 방법이라고 설명합니다. 실제 절감과 신뢰성은 앱의 작업 부하에 달려 있습니다.
이름은 보이고 스키마는 대기한다
서버 측 검색은 tool_search를 추가하고 대상 함수에 defer_loading: true를 지정해 활성화합니다. 모델은 지연된 도구의 이름과 설명을 계속 보지만, 매개변수 스키마는 요청될 때까지 컨텍스트에 들어오지 않습니다.
모델이 함수를 고르면 이름으로 요청합니다. API가 스키마를 불러오고 같은 요청 안에서 모델이 함수 호출을 생성합니다. 검색 호출, 검색 결과, 최종 함수 호출은 interaction.steps에 나타나므로 개발자가 확인할 수 있습니다.
Google 예시는 gemini-4-hydrogen에 손상된 주문 A-1042의 40달러 환불을 요청합니다. 모델은 issue_refund를 찾아 주문과 금액을 인수로 출력합니다. 실제 환불 실행과 function_result 반환은 여전히 앱이 담당합니다. 스키마 검색 자체가 송금하거나 거래를 승인하지는 않습니다.
민감한 도구를 가진 에이전트에는 이 경계가 중요합니다. 검색 개선이 앱 권한, 검증, 업무 규칙을 대체하지 않습니다.
서버 검색은 별도 인덱스 운영이 필요 없다
서버 관리 방식에서는 개발자가 검색 인덱스를 직접 운영할 필요가 없습니다. 자주 쓰는 도구는 전체 정의를 먼저 제공하고, 드물게 쓰는 함수만 지연할 수 있습니다. 큰 스키마가 초기 컨텍스트에서 빠져도 이름과 설명은 중요합니다.
원격 MCP 서버에도 적용됩니다. mcp_server에 defer_loading: true를 설정하면 각 도구를 하나씩 나열하지 않아도 필요에 따라 불러옵니다.
Google은 프리픽스 캐시와도 함께 작동한다고 설명합니다. 지연된 스키마는 초기 프롬프트에서 제외되고 로드될 때 대화 뒤에 추가되므로 캐시되는 앞부분이 턴마다 유지됩니다. 그렇다고 나중에 로드한 스키마가 무료가 되는 것은 아닙니다.
클라이언트 검색은 앱의 레지스트리 통제를 유지한다
기존 도구 레지스트리, 임베딩 인덱스, 사용자별 권한 필터가 있는 앱은 클라이언트 실행을 선택할 수 있습니다. "execution": "client"가 설정된 tool_search에 검색 함수와 매개변수를 선언합니다.
모델이 검색을 요청하면 앱이 조회한 뒤 일치하는 함수 스키마를 function_result로 반환합니다. Google의 후속 요청 예시는 previous_interaction_id를 사용해 기존 상호작용과 연결합니다.
조회가 앱에서 실행되므로 검색마다 왕복 한 번이 늘어납니다. 대신 모든 도구를 처음부터 선언할 필요는 없습니다. 대화 중 새 연동이 연결되면 도구를 추가할 수 있고, 반환할 후보는 앱의 레지스트리가 결정할 수 있습니다.
이는 서버 관리 검색과 다른 절충입니다. 검색 통제권을 얻는 대신 앱 처리 단계와 그에 따른 지연·오류 처리가 추가됩니다.
토큰 절감은 로드하지 않은 스키마에 달려 있다
Tool Retrieval에는 별도 사용료가 없습니다. 입력·출력 토큰은 선택한 모델의 표준 요율을 따릅니다. tool_search를 켜면 작은 고정 입력이 추가되고, 불러온 각 스키마는 남은 대화에서 입력으로 과금됩니다.
절감은 끝내 컨텍스트에 들어오지 않는 스키마에서 발생합니다. 큰 목록 중 일부만 쓰는 경우가 거의 모든 스키마를 결국 로드하는 대화보다 유리할 수 있습니다. Google은 실제 트래픽으로 측정하라고 권장하며 보편적인 절감 비율을 제시하지 않습니다.
미리보기는 Interactions API에서 Gemini 3.6 이후 모델과 모든 Gemini 4 모델을 지원합니다. 모든 API 인터페이스를 지원한다는 뜻으로 확대하면 안 됩니다. 개발자가 다음으로 확인할 근거는 지원 조건에서 실제 앱의 토큰 사용량, 도구 선택 행동, 클라이언트 조회 지연입니다.
