Google lança Tool Retrieval na Gemini API em preview
Google lançou o Tool Retrieval na Gemini API, recurso disponível em preview na Interactions API.

Segundo o Google, estamos lançando o Tool Retrieval na Gemini API, disponível em pré-visualização na Interactions API.

Quando um agente se conecta a dezenas ou até centenas de ferramentas, enviar o esquema completo de parâmetros em cada solicitação acumula rapidamente. Isso aumenta a contagem de tokens de entrada, gera latência e reduz a precisão na seleção de ferramentas à medida que a lista de candidatos cresce. O Tool Retrieval permite que o agente mantenha toda a sua biblioteca de ferramentas em espera e carregue os esquemas de parâmetros somente quando a tarefa atual os requer.
Para ativar o Tool Retrieval, adicione uma ferramenta tool_search à sua solicitação e defina defer_loading: true nas ferramentas que deseja adiar. O modelo ainda visualiza o nome e a descrição de cada ferramenta adiada, sabendo o que está disponível, porém os esquemas de parâmetros permanecem fora do contexto. Quando o modelo precisa de uma ferramenta, solicita-a pelo nome, a API carrega o esquema completo e o modelo executa a função, tudo dentro da mesma solicitação.
Dentro dessa única chamada de API, o modelo procura por issue_refund, a API carrega seu esquema e o modelo emite o function_call. As três etapas aparecem em interaction.steps, facilitando a inspeção das ferramentas que o modelo considerou ao depurar nomes ou descrições de ferramentas:
A partir daí ocorre a chamada de função normal: seu código executa o reembolso e devolve um function_result.
Não há índice a ser criado ou hospedado. O Gemini realiza a busca no servidor, de modo que as únicas alterações no seu código são a nova ferramenta e uma flag nas ferramentas que você deseja adiar. É possível manter as ferramentas mais usadas carregadas antecipadamente e adiar as menos frequentes.
O Tool Retrieval também funciona bem com o cache de prefixo. Esquemas adiados permanecem fora do início do prompt, e os esquemas que o modelo carrega são adicionados posteriormente na conversa, mantendo o prefixo em cache constante de uma interação para outra.
O Tool Retrieval também opera com servidores MCP remotos na Gemini API. Defina defer_loading: true em uma ferramenta mcp_server e cada ferramenta que o servidor disponibiliza será carregada sob demanda, permitindo conectar um servidor grande sem listar suas ferramentas individualmente.
Caso você mantenha seu próprio registro de ferramentas, índice de incorporação ou filtro de permissões por usuário, declare a tool_search com "execution": "client" e defina seus parâmetros de busca. A recuperação do lado do cliente adiciona uma ida e volta por busca, pois seu aplicativo executa a consulta. As ferramentas não precisam ser declaradas antecipadamente, permitindo também expor novas ferramentas durante a conversa quando um usuário conecta uma integração:.
A Recuperação de Ferramentas não tem cobrança separada. Os tokens de entrada e saída são cobrados nas tarifas padrão do modelo utilizado. Ao habilitar tool_search, adiciona-se um pequeno bloco fixo de tokens de entrada, e cada esquema carregado pelo modelo é cobrado como entrada durante o restante da conversa, da mesma forma que uma ferramenta declarada antecipadamente. Você economiza tokens quando os esquemas que nunca são carregados superam os que são carregados, situação comum em bibliotecas extensas. Avalie isso em relação ao seu próprio tráfego.
A Recuperação de Ferramentas funciona com os modelos Gemini 3,6 e posteriores, inclusive todos os modelos Gemini 4, na API Interactions.
Fontes
Esta matéria foi redigida com apoio de inteligência artificial a partir das fontes citadas e conferida por verificação automática.
Conteúdo informativo. Não é recomendação de investimento.
Avisar erro nesta matéria

