Voltar
Apresentando o Tool Retrieval na API do Gemini

API do Google Gemini Ganha 'Tool Retrieval' para Execução Dinâmica de Funções

Aprofundamento CEVIU

Aprofundamento

O Google lançou oficialmente o Tool Retrieval na API do Gemini, agora disponível na Interactions API. Este recurso permite que modelos de linguagem, ao interagir com uma vasta biblioteca de ferramentas (dezenas ou centenas), carreguem os esquemas de parâmetros dessas ferramentas apenas quando necessário. Para ativar a funcionalidade, o desenvolvedor adiciona uma ferramenta tool_search na requisição e define defer_loading: true nas ferramentas que devem ser carregadas sob demanda. O modelo ainda visualiza o nome e a descrição de todas as ferramentas com carregamento adiado, mas seus esquemas de parâmetros ficam fora do contexto inicial. Quando o modelo precisa de uma ferramenta específica, ele a solicita pelo nome, a API carrega o esquema completo e o modelo executa a função, tudo dentro da mesma requisição.

A busca pelas ferramentas é realizada no servidor do Gemini, eliminando a necessidade de os desenvolvedores criarem e manterem um índice próprio. As modificações no código se limitam à inclusão da nova ferramenta tool_search e à flag defer_loading. O Tool Retrieval também se integra com o cache de prefixo, mantendo os esquemas adiados fora da parte inicial do prompt e adicionando-os apenas quando carregados, preservando o prefixo cacheado. A funcionalidade é compatível com servidores MCP remotos na Gemini API. Há também a opção de recuperação no lado do cliente, onde a aplicação do desenvolvedor realiza a busca por ferramentas. Não há custo adicional para o Tool Retrieval; a cobrança segue a taxa padrão de tokens de entrada e saída. Este recurso está disponível para modelos Gemini 3.6 e posteriores, incluindo todos os modelos Gemini 4, na Interactions API.

O que mudou

Em 19 de novembro de 2026, o CEVIU noticiou que a funcionalidade Tool Retrieval estava disponível em modo de pré-visualização na Gemini Interactions API. Com o lançamento de hoje, 20 de novembro de 2026, o recurso Tool Retrieval é oficialmente lançado e está disponível para uso geral. A principal mudança é a transição de um estado de pré-visualização para a disponibilidade plena, indicando que a funcionalidade agora é estável e recomendada para uso em produção.

Por que isso importa

Para desenvolvedores que criam agentes com a API do Gemini e que utilizam um grande número de ferramentas, o Tool Retrieval resolve um problema crítico de eficiência. Antes, ter que enviar todos os esquemas de parâmetros de dezenas ou centenas de ferramentas em cada requisição aumentava o consumo de tokens, a latência e reduzia a precisão na seleção da ferramenta. Agora, carregar esquemas sob demanda significa prompts mais curtos, menor custo de tokens e respostas mais rápidas, otimizando a performance e a escalabilidade de aplicações complexas. A flexibilidade de escolher entre a recuperação no lado do servidor (gerenciada pelo Google) ou no lado do cliente (para controle personalizado, como permissões) oferece opções robustas para diferentes arquiteturas de sistema.

Linha do tempo

  1. Google impulsiona agentes na Gemini API com novas capacidades assíncronas e integração robusta

  2. Google Turbina Agentes Gerenciados Gemini com Versão 3.6 Flash e Novos Controles

  3. Google Eleva Edição de Vídeo com Gemini Omni 1.1 Flash e Controles Avançados via API

  4. Google Workspace ganha 'skills' para otimizar processos com IA do Gemini

  5. Google Workspace amplia API para gestão de comentários e sugestões, otimizando colaboração

  6. Gemini API ganha Tool Retrieval para gestão eficiente de ferramentas (pré-visualização)

  7. API do Google Gemini Ganha 'Tool Retrieval' para Execução Dinâmica de Funções (lançamento oficial)

Perguntas frequentes

O que é o Tool Retrieval na API do Google Gemini?

O Tool Retrieval é um novo recurso da API do Gemini que permite aos agentes carregar os esquemas de parâmetros das ferramentas apenas quando elas são realmente necessárias, em vez de incluí-los em todas as requisições. Isso otimiza o uso de tokens, reduz a latência e melhora a precisão na seleção de ferramentas por modelos de linguagem.

Como ativar o Tool Retrieval para minhas ferramentas?

Para ativar, você deve adicionar uma ferramenta tool_search à sua requisição e definir o parâmetro defer_loading: true para as ferramentas cujos esquemas você deseja carregar sob demanda. O modelo ainda terá acesso ao nome e à descrição dessas ferramentas, mas o esquema completo só será carregado quando o modelo precisar utilizá-las.

Quais modelos Gemini são compatíveis com o Tool Retrieval e há custo adicional?

O Tool Retrieval funciona com os modelos Gemini 3.6 e posteriores, incluindo todos os modelos Gemini 4, na Interactions API. Não há uma cobrança separada para o uso do Tool Retrieval; os tokens de entrada e saída são faturados pelas taxas padrão do modelo utilizado, com economia potencial ao evitar o carregamento de esquemas não utilizados.

Fontes

Avalie este artigo:
Categoria
CEVIU IA
Publicado
20 de novembro de 2026
Editoria
CEVIU IA

Quer receber mais sobre CEVIU IA?

Conteúdo curado diariamente, direto no seu e-mail.

Conteúdo curado diariamenteDiversas categoriasCancele quando quiser