# Unite.AI — Google Previews On-Demand Tool Retrieval for Gemini API Agents

- Company: Unite.AI (unite.ai)
- Announced: 2026-11-19T18:55:03+00:00
- Category: capability-change
- Coverage: not counted
- Announcement: yes
- Group: announcements
- Source: https://www.unite.ai/google-previews-on-demand-tool-retrieval-for-gemini-api-agents/
- Record: https://forck.live/items/38822-google-previews-on-demand-tool-retrieval-for-gemini-api-agents
- Subject: Reporting
- Models affected: Gemini 4 Argon, Gemini 3.8 Flash, Gemini 3.6 Flash

Google is previewing Tool Retrieval in the Gemini Interactions API, letting agents keep large tool libraries on standby and load full parameter schemas only when a task needs them. Google says sending every full schema inflates input-token counts, adds latency and reduces tool-selection accuracy as the candidate list grows, so deferred tools initially contribute only their name and description. In the default server-side mode, developers add a tool_search tool and set defer_loading: true on selected function tools; Gemini performs the search, so there is no index to build or host, and setting defer_loading on a remote MCP server defers every tool it exposes. Client-side retrieval moves search, ranking and filtering to the developer's application, adding one round trip per search but allowing tools to be introduced mid-conversation; the two modes cannot be combined in one request. Tool Retrieval carries no separate charge, but the setup guide reports early testing produced about 26 tokens per deferred tool, and every loaded schema stays billable as input on later calls. The guide's illustrative example puts 200 tools of 400 tokens each with two loaded at 164,000 input tokens statically versus about 23,650 with retrieval, while a 10-tool library with a 30,000-token context rises from 68,000 to about 92,830 tokens. The guide lists Gemini 4 Argon, Gemini 3.8 Flash and Gemini 3.6 Flash as supported, returns a 400 error for defer_loading on unsupported models, and warns the preview surface may change before general availability.

## Evidence

Verbatim from https://www.unite.ai/google-previews-on-demand-tool-retrieval-for-gemini-api-agents/:

> Tool Retrieval defers full schemas so large tool libraries no longer inflate every request's input tokens.
> 
> Server-side search adds a model call with full context that can outweigh savings for small tool libraries.
> 
> Retrieved schemas cannot be unloaded and the complete tools array must be resent on every request.
> 
> Google announced Tool Retrieval on November 19, 2026, making the feature available in preview in the Gemini Interactions API. It lets agents keep large tool libraries on standby and load full parameter schemas only when the current task requires them.
> 
> Google says the conventional approach becomes unwieldy as agents connect to dozens or hundreds of tools: sending every full schema inflates input-token counts, adds latency and reduces tool-selection accuracy as the candidate list grows. Tool Retrieval initially keeps only each deferred tool’s name and description in context, withholding the schema that defines the function’s arguments until the model asks for it.
> 
> The Interactions API became generally available in June 2026 and is Google’s recommended interface for new projects.

---

Record: https://forck.live/items/38822-google-previews-on-demand-tool-retrieval-for-gemini-api-agents
Catalogue: https://forck.live/llms.txt
Current issue: https://forck.live/feed.md
