Resumo
O Google lançou em 19 de novembro de 2026 o Tool Retrieval na Gemini API, em prévia na Interactions API. O recurso mantém a biblioteca de ferramentas de um agente em espera e carrega os esquemas de parâmetros só quando a tarefa pede, o que reduz tokens e latência. Funciona com Gemini 3.6 e posteriores, sem cobrança separada.
Gemini API ganha o Tool Retrieval em prévia na Interactions API, anunciado pelo Google em 19 de novembro de 2026. Para quem desenvolve agentes com dezenas de ferramentas, o recurso deixa de enviar todos os esquemas de parâmetros a cada requisição.
Como o Tool Retrieval segura os esquemas fora do prompt
A ativação exige adicionar uma ferramenta tool_search à requisição e marcar com defer_loading como verdadeiro as ferramentas que ficarão em espera. O modelo continua vendo nome e descrição de cada uma, mas os esquemas de parâmetros ficam fora do contexto. Quando precisa de uma delas, pede pelo nome, a API carrega o esquema e o modelo chama a função, tudo na mesma requisição.
A busca roda no servidor do Gemini, então não há índice para construir nem hospedar. Os três passos aparecem em interaction.steps, o que ajuda a depurar nomes e descrições de ferramentas. O recurso também funciona com servidores MCP remotos: ao marcar uma ferramenta mcp_server com defer_loading, todas as ferramentas que o servidor expõe passam a ser carregadas sob demanda.
“O Tool Retrieval deixa o agente manter a biblioteca completa de ferramentas em espera e carregar os esquemas de parâmetros só quando a tarefa atual precisa”, explicaram Lucia Loher e Nora Kassner.
Preço, modelos compatíveis e a opção de busca no cliente
Segundo o anúncio do Google, o Tool Retrieval não tem cobrança separada. Tokens de entrada e saída seguem a tabela padrão do modelo usado. Ligar o tool_search soma um bloco fixo e pequeno de entrada, e cada esquema carregado conta como entrada pelo resto da conversa. A economia aparece quando os esquemas nunca carregados superam os carregados, caso comum em bibliotecas grandes.
O recurso funciona com Gemini 3.6 e modelos posteriores, incluindo todos os Gemini 4, na Interactions API. Quem mantém registro próprio de ferramentas, índice de embeddings ou filtro de permissão por usuário pode declarar o tool_search com execução no cliente, ao custo de uma ida e volta extra por busca. Os esquemas carregados entram mais tarde na conversa, e isso preserva o prefixo em cache entre os turnos.
O que você acha? Você vai adiar o carregamento das ferramentas dos seus agentes para economizar tokens? Para acompanhar mais, acesse nossa editoria de Conteúdo com Inteligência Artificial e os vídeos do canal no YouTube.
Perguntas Frequentes
O que é o Tool Retrieval da API do Gemini e para que serve?
Tool Retrieval é um recurso em prévia na Interactions API do Gemini que mantém a biblioteca de ferramentas de um agente em espera. Os esquemas de parâmetros só entram no contexto quando a tarefa exige, o que reduz tokens de entrada e latência. O modelo vê apenas nome e descrição das ferramentas adiadas até pedir uma delas.
Como ativar o Tool Retrieval na API do Gemini passo a passo?
Gemini API ativa o Tool Retrieval com duas mudanças na requisição: adicionar uma ferramenta do tipo tool_search e definir defer_loading como verdadeiro nas ferramentas que ficarão em espera. A busca roda no servidor, sem índice próprio. Servidores MCP remotos também aceitam a marcação, e suas ferramentas carregam sob demanda no mesmo fluxo.
Quanto custa o Tool Retrieval e quais modelos do Gemini aceitam?
Tool Retrieval não tem cobrança separada: tokens de entrada e saída seguem o preço padrão do modelo chamado. O tool_search adiciona um pequeno bloco fixo de entrada, e cada esquema carregado conta até o fim da conversa. O recurso funciona com Gemini 3.6 e posteriores, incluindo todos os modelos Gemini 4.