Gemini API: Tool Retrieval para agentes de IA

O Google lançou em preview o Tool Retrieval na Gemini API. A função carrega schemas de ferramentas sob demanda, reduzindo tokens e latência em agentes.

TLThiago Lopes 20 de novembro de 2026 2 min de leitura 8 0
Gemini API: Tool Retrieval para agentes de IA

O que é o Tool Retrieval

O Google anunciou o Tool Retrieval na Gemini API, disponível em preview na Interactions API. A funcionalidade foi criada para agentes que acessam dezenas ou até centenas de ferramentas.

Em vez de enviar o schema completo de todas as ferramentas em cada requisição, o agente mantém a biblioteca em espera. Ele carrega os detalhes de parâmetros apenas quando a tarefa atual precisa deles.

Por que o modelo de envio completo pesa

Segundo o Google, enviar todos os schemas a cada requisição aumenta a contagem de tokens de entrada e a latência. Com a lista de candidatas crescendo, a seleção correta da ferramenta também tende a piorar.

Com o Tool Retrieval, o modelo continua enxergando o nome e a descrição de cada ferramenta adiada. Assim sabe o que está disponível, mas os parâmetros ficam fora do contexto até serem necessários.

Como funciona a chamada

Para ativar, o desenvolvedor adiciona uma ferramenta tool_search na requisição e define defer_loading como true nas ferramentas que deseja adiar. Segundo a documentação citada pelo Google, o modelo pede a ferramenta pelo nome, a API carrega o schema e o modelo emite a chamada de função, tudo na mesma requisição.

A busca é executada no servidor do Gemini, então não é preciso construir ou hospedar um índice. Também é possível manter as ferramentas mais usadas carregadas desde o início e adiar apenas a cauda longa.

O Google informa que a funcionalidade também funciona com servidores MCP remotos. Ao definir defer_loading em uma ferramenta mcp_server, todas as ferramentas expostas por aquele servidor passam a ser carregadas sob demanda.

Busca no cliente

Para quem mantém registro próprio de ferramentas, índice de embeddings ou filtro de permissões por usuário, a ferramenta tool_search pode ser declarada com execution definido como client. Nesse modo, a busca é feita pela aplicação, o que adiciona uma ida e volta por pesquisa.

Esse modo também permite expor novas ferramentas no meio da conversa, por exemplo quando um usuário conecta uma nova integração.

Impacto prático para quem desenvolve

Segundo o Google, não há cobrança separada pelo recurso. Tokens de entrada e saída seguem a tarifa padrão do modelo usado, e a ativação adiciona um pequeno bloco fixo de tokens de entrada.

Cada schema carregado pelo modelo passa a ser cobrado como entrada até o fim da conversa, da mesma forma que uma ferramenta declarada no início. A economia aparece quando os schemas que nunca são carregados superam os que são. O Google recomenda medir o resultado com o próprio tráfego, e a funcionalidade exige Gemini 3.6 ou posteriores, incluindo todos os modelos Gemini 4.

Sobre este conteúdo

Produzido pelo Radar Tech, o bot pessoal do Thiago Lopes, com apoio de IA e revisado antes da publicação. O texto resume e contextualiza para o público brasileiro a reportagem original abaixo; os fatos e as citações pertencem à fonte.

Fonte original: Google AI

Curtiu? Deixa seu like e passa adiante.

Comentários (0)

proteção anti-robô ativa

Ninguém comentou ainda. Seja o primeiro.

Continue lendo