EM POUCAS LINHAS
- Tool Retrieval adia esquemas de parâmetros dentro de uma interação com ferramentas.
- Decisions API pontua escolhas delimitadas; não executa a ferramenta escolhida.
- A economia de tokens depende do catálogo e precisa ser medida na aplicação.
- Os anúncios não confirmam condições específicas de acesso ou faturamento no Brasil.
O agente precisa escolher uma ação, mas nem sempre precisa ter todos os detalhes de todas as ferramentas no contexto. Essa é a distinção útil entre duas propostas do Google: Tool Retrieval administra quando o esquema de uma ferramenta entra na interação; Decisions API devolve uma avaliação estruturada entre opções definidas pela aplicação. Há uma área de sobreposição — ambas podem participar da seleção de ferramentas —, mas elas não resolvem exatamente o mesmo problema.
O que mudou com o Tool Retrieval
O Google anunciou o Tool Retrieval em 19 de novembro de 2026, em prévia na Interactions API. A novidade é o carregamento sob demanda dos esquemas de parâmetros de ferramentas. Em um catálogo extenso, apresentar antecipadamente cada esquema aumenta o volume de entrada mesmo quando boa parte das funções não será usada. Adiar esses detalhes não significa esconder a existência das ferramentas: o modelo ainda recebe o nome e a descrição das funções adiadas, enquanto os parâmetros ficam fora do contexto até serem solicitados.
Na modalidade descrita pelo Google, o modelo pede a ferramenta pelo nome, a API carrega o esquema completo e o modelo emite a chamada de função na mesma requisição. A execução da função continua a cargo da aplicação, que depois devolve o resultado. Portanto, recuperar o esquema não equivale a executar uma operação nem a conceder autorização para executá-la.
Para configurar esse caminho, o anúncio orienta incluir tool_search e marcar com defer_loading: true as ferramentas cujos esquemas devem ficar em espera. A equipe pode deixar as ferramentas frequentes disponíveis desde o início e adiar as demais. O suporte anunciado é para a Interactions API com modelos Gemini 3.6 ou posteriores, incluindo a família Gemini 4; isso delimita a compatibilidade descrita, não garante acesso a toda configuração em qualquer conta ou região.
Onde ocorre a busca das ferramentas
No modo de busca mantido pelo serviço, o Google afirma que não é necessário construir ou hospedar um índice próprio. É um ponto de partida quando o catálogo declarado à API atende às necessidades do agente. Já uma aplicação com registro próprio, índice de busca ou filtro de permissões por usuário pode optar pela recuperação no cliente, conforme o mesmo anúncio. Nesse caso, a aplicação faz a pesquisa e devolve os esquemas encontrados; o Google informa uma ida e volta adicional por pesquisa no modo cliente.
Essa escolha também afeta o desenho de controles. Se a disponibilidade de uma integração depende do usuário, a aplicação deve decidir quais funções pode expor e quais ações pode executar. O carregamento sob demanda ajuda a administrar contexto, mas não substitui a verificação de permissões ou a validação dos argumentos antes de uma ação com efeito externo.
Quando pedir uma decisão estruturada
A Decisions API foi anunciada separadamente em 11 de novembro de 2026; não faz parte do lançamento do Tool Retrieval. O Google a apresenta como um endpoint para escolhas delimitadas, com aplicações sugeridas em seleção de ferramentas, checagem de políticas, roteamento de modelos e avaliação de contexto. Em vez de disponibilizar esquemas ao agente no momento de uma chamada, a aplicação formula uma pergunta sobre uma entrada compartilhada e recebe uma resposta que pode orientar o próximo passo.
O anúncio descreve perguntas de sim ou não, múltipla escolha e pontuação por rubrica, com um valor de confiança em cada resposta. Para escolher uma ferramenta, a aplicação poderia, por exemplo hipotético, apresentar as opções consultar pedido, encaminhar a atendimento ou não acionar ferramenta para uma solicitação recebida. Ela teria de definir os critérios, interpretar a resposta e decidir como tratar casos ambíguos. A pontuação não concede permissão nem demonstra, por si só, que a escolha estará correta no domínio da aplicação ou em português brasileiro.
O texto do Google diz que o Gemini Decision 1 está disponível pela Gemini API no Google AI Studio e descreve um caminho de prototipagem; integrações de ecossistema estavam em implantação e o suporte no Gemini em Google Cloud era apresentado como futuro. Convém distinguir esse anúncio de uma confirmação de acesso para uma equipe específica.
Escolher um mecanismo — ou combinar etapas?
A pergunta prática é onde está o gargalo. Se o agente já opera com chamadas de função, mas recebe esquemas demais a cada interação, Tool Retrieval trata diretamente desse excesso. Se a aplicação precisa obter uma classificação ou escolha entre alternativas previamente delimitadas — inclusive antes de decidir que fluxo iniciar —, Decisions API é a proposta mais próxima. Ela não carrega automaticamente o esquema da função selecionada dentro da interação do agente.
Também não há, nos anúncios de Tool Retrieval e da Decisions API, uma comparação direta de qualidade de seleção na mesma tarefa nem uma regra que impeça combinar as duas etapas. Uma arquitetura possível seria usar uma decisão delimitada para encaminhar o pedido e, no fluxo que exige ferramentas, recuperar apenas os esquemas necessários. É uma possibilidade de projeto, não um resultado demonstrado pelos anúncios. Para aprofundar a avaliação de escolhas estruturadas, veja também a comparação entre a Gemini Decisions API e modelos de decisão no Hugging Face.
Custos, medição e limites para o Brasil
Segundo o Google, o Tool Retrieval não tem cobrança separada, mas tool_search acrescenta tokens de entrada e cada esquema carregado passa a contar como entrada pelo restante da conversa. A hipótese de economia é condicional: os esquemas que deixam de ser carregados precisam compensar o custo adicional e aqueles que efetivamente entram no contexto. Antes de adotar a solução, compare no tráfego da própria aplicação tokens de entrada, esquemas recuperados, acerto na escolha da ferramenta e tempo até a resposta; no modo cliente, considere também a ida e volta da busca. Os anúncios não fornecem uma medição independente para esse tráfego.
Para equipes no Brasil, os documentos sobre Tool Retrieval e Decisions API não confirmam disponibilidade específica no país nem condições locais de faturamento. Permanecem pendentes a verificação de acesso efetivo e a avaliação com tarefas reais da equipe, inclusive solicitações em português brasileiro. A decisão entre os mecanismos começa pelo papel de cada um na arquitetura; custo e qualidade só podem ser concluídos para uma implantação concreta.
Fontes e referências
- Gemini API tool retrieval for efficient agent scalingblog.google · Consultado em 19/11/2026
- Gemini Decisions API: Fast multimodal decisionsblog.google · Consultado em 19/11/2026