Clicked Gallery

O que é ToolGrad?

Sublinhado num documento técnico real. Explicado pelo Clicked.

Usado numa frase

Engineering Notes · AI Systems

Google's ToolGrad writes the answer before the question, and 99.8% of its practice examples came out usable.

O leitor sublinhou uma palavra na documentação. O Clicked explicou o termo técnico «ToolGrad» em termos simples:

Explicado em três níveis

Os mesmos fatos, outra vibe — Modo slang 😎

O método Clicked

●○○

Overview

ToolGrad é um método do Google Research para criar os exemplos de treino que ensinam um modelo de IA a chamar ferramentas. Tool calling é o modelo escrevendo um pedido para uma ferramenta externa, como uma busca ou um mapa, que o app (o harness, o software em volta do modelo) então executa. O ToolGrad monta primeiro uma cadeia de chamadas que funciona e escreve a pergunta do usuário depois, para encaixar na cadeia. Pegue uma cadeia de duas chamadas: find_pharmacy com aberta agora como único campo, depois get_directions. Só então a pergunta é escrita: qual farmácia perto de mim está aberta agora e como chego lá a pé? O método anterior escrevia a pergunta primeiro e depois procurava chamadas que a respondessem. O Google contou 63,8% dos exemplos dele como aproveitáveis, contra 99,8% dos do ToolGrad. Toda pergunta que o ToolGrad escreve já tem uma cadeia de chamadas que a responde, porque a cadeia foi montada antes.
●○○

Overview

ToolGrad é o truque do Google para criar as perguntas de treino que ensinam uma IA a chamar ferramentas, e o truque é fazer tudo ao contrário. Tool calling é a IA pedindo a uma ferramenta externa, um mapa ou um site de reservas, um serviço que ela não consegue fazer sozinha. Criar perguntas de treino era perguntar primeiro e torcer depois. Você escreve uma pergunta e solta um agente de IA para achar chamadas a ferramentas que a respondam. Em mais de um terço das vezes, 36,2 em cada 100 (100 menos 63,8), ele voltava de mãos vazias. O ToolGrad pula a parte de torcer. Primeiro roda as ferramentas: find_bike_shop, depois check_hours para domingo, depois book_slot, 3 chamadas que já funcionam. Aí escreve a única pergunta que essas 3 chamadas respondem: dá para consertar minha bicicleta neste domingo? 😎

Uma ideia rápida — muitas vezes é tudo de que você precisa.

●●○

Detail

ToolGrad é um método do Google Research para criar os exemplos de treino que ensinam um modelo de IA a chamar ferramentas, e ele monta cada exemplo de trás para frente: primeiro a cadeia de chamadas a ferramentas, depois a pergunta do usuário. Tool calling é o modelo escrevendo um pedido para uma ferramenta externa, como uma busca ou uma agenda, que o app (o harness, o software em volta do modelo) executa antes de devolver o resultado. Um modelo aprende a fazer isso com exemplos de treino durante o treinamento. O ToolGrad roda antes do treinamento, para criar esses exemplos. Quando você usa o app (a inferência), só roda o modelo já treinado. Cada exemplo é uma pergunta, as chamadas certas na ordem certa e a resposta final. Escrever milhares deles à mão é lento demais, então os laboratórios põem uma IA para gerá-los, e é isso que dados sintéticos significa. O método anterior começava pela pergunta. Depois um agente de IA procurava por tentativa e erro chamadas que a respondessem, e quando nenhuma cadeia funcionava, o exemplo era descartado. A conta do Google: 63,8% saíram aproveitáveis, então 36,2 em cada 100 foram desperdiçados. O ToolGrad começa pela cadeia. Ele propõe algumas ferramentas que podem ajudar, testa todas e põe um juiz de IA para escrever uma nota curta sobre qual chamada funcionou melhor. Essa nota é o gradiente textual. Um gradiente é o sinal que, no treinamento, diz para que lado ajustar, e este faz o mesmo trabalho em palavras. A melhor chamada entra na cadeia e o ciclo roda mais uma vez. Quando a cadeia fica completa, a IA escreve a pergunta e a resposta que combinam com ela. Desses exemplos, 99,8% saíram aproveitáveis, e as cadeias ficaram mais longas, 3,4 chamadas contra 2,1. O Google criou 500 exemplos assim e treinou com eles seu modelo aberto Gemma 3 12B (um que qualquer pessoa pode baixar). No BFCL, um teste de tool calling, o modelo marcou 83,1, que são 6,3 pontos acima da nota de antes desse treinamento e o mesmo nível dos 83,2 do Gemini 2.5 Pro na época. Dois limites. A comparação com esses modelos se apoia em um único teste e 500 exemplos. E uma pergunta escrita para encaixar numa resposta pode não soar como algo que uma pessoa perguntaria.
●●○

Detail

ToolGrad é como o Google prepara o material de treino que ensina uma IA a chamar ferramentas, e a receita é ao contrário: chamadas primeiro, pergunta por último. Tool calling é a IA pedindo a uma ferramenta externa, uma busca ou uma agenda, para fazer um serviço, e o app onde ela mora (o harness) rodando essa ferramenta. A IA aprende isso no treinamento, com uma pilha de exemplos, cada um com uma pergunta, as chamadas certas na ordem e uma resposta. Eis por que a ordem importa. Começar pela pergunta é apostar que existe uma resposta. O método antigo perdia muito essa aposta: um agente de IA saía atrás de chamadas que encaixassem na pergunta, e só 63,8 em cada 100 exemplos sobreviviam à caçada. O ToolGrad não aposta. Teste um punhado de ferramentas, ponha um juiz de IA para anotar numa linha qual chamada funcionou de verdade, fique com essa e vai de novo. Essa nota é todo o gradiente textual, uma piscadela para o gradiente (o empurrãozinho do treinamento que diz para onde virar), só que em palavras comuns em vez de matemática. Quando a cadeia fica comprida o bastante, a IA escreve uma pergunta que essa cadeia responde. A cadeia já funciona, então 99,8 em cada 100 exemplos servem, e como o ToolGrad vai somando chamadas, as cadeias têm em média 3,4 chamadas em vez de 2,1. O Google gerou 500 desses, treinou com eles seu Gemma 3 12B de download gratuito, e o modelo pequeno fez 83,1 no BFCL, um teste de tool calling, contra 74,4 do GPT-5 segundo o artigo. Ou seja, 500 exemplos levaram um modelo pequeno e gratuito a passar um modelo de ponta, em um teste, e esse teste único é a letra miúda. Uma pergunta escrita de trás para frente também pode soar estranha, porque foi moldada para caber nas chamadas e não digitada por uma pessoa. 😎

Quer mais? Um clique aprofunda.

●●●

Analogy

ToolGrad é um método para criar os exemplos de treino que ensinam um modelo de IA a chamar ferramentas, e ele monta primeiro a cadeia de chamadas e escreve a pergunta depois. Montar uma palavra cruzada funciona do mesmo jeito. Quem faz a cruzadinha preenche primeiro a grade com palavras e escreve as dicas por último. Toda dica tem resposta, porque a resposta já estava na grade antes de a dica existir. Quem escrevesse primeiro 30 dicas e depois tentasse encaixar respostas na grade ficaria com dicas que nenhuma palavra do tamanho certo consegue cumprir. A grade preenchida é a cadeia de chamadas montada primeiro, e as dicas são as perguntas escritas depois. Quem ficou com dicas impossíveis é o método anterior, que escrevia a pergunta primeiro e descartava os exemplos que não conseguia responder. A comparação vai até aqui: quem faz a cruzadinha preenche a grade de uma vez, enquanto o ToolGrad monta a cadeia chamada por chamada, testando ferramentas e ficando com a que funcionou.
●●●

Analogy

ToolGrad é o jeito do Google de criar treino de tool calling para uma IA na ordem inversa: monta a cadeia de chamadas e depois escreve a pergunta que combina com ela. Preparar uma caça ao tesouro para crianças é a mesma ideia. Você esconde o prêmio e depois volta pela casa escrevendo uma pista para cada lugar que acabou de deixar. Toda pista leva a algum lugar, porque os esconderijos vieram primeiro. Faça ao contrário, rabisque 8 pistas na mesa e depois saia procurando lugares que combinem, e você acaba rodando pela casa com uma pista sobre alguma coisa que faz tique-taque e nada que faça tique-taque. A rota escondida é a cadeia de chamadas montada primeiro, e a pista escrita na volta é a pergunta escrita depois. O pai procurando um lugar que combine com a pista é o método antigo, que jogava fora os exemplos que não conseguia responder. As crianças ainda podem ficar sem achar nada, viu: o ToolGrad promete que a pergunta tem resposta, não que o modelo vai encontrá-la. Onde a comparação quebra: um pai escolhe os esconderijos olhando em volta, enquanto o ToolGrad escolhe cada passo rodando as ferramentas e ficando com a que funcionou. 😎

Conceito novo? Um exemplo do dia a dia faz clicar — novas analogias quando quiser.

Explicações de IA podem conter erros · Não é aconselhamento profissional

Definição formal — O mesmo termo, explicado da forma habitual

ToolGrad é um framework de geração de conjuntos de dados do Google Research (Zhou et al., ACL 2026 Findings) para sintetizar dados de treinamento de uso de ferramentas para grandes modelos de linguagem. Ele inverte o paradigma que parte da consulta, usado por ToolBench e ToolACE, em que uma instrução é gerada e um agente de busca em profundidade (DFS) tenta encontrar um fluxo de API que a satisfaça. O ToolGrad constrói primeiro um fluxo validado, por meio de um ciclo iterativo (proponente de API, executores em paralelo, seletor e atualizador LLM) guiado por gradientes textuais no estilo do TextGrad, e depois sintetiza a consulta do usuário e a resposta correspondentes. Contra a linha de base DFS no conjunto de APIs do ToolBench, ele relata taxa de aprovação de 99,8% contra 63,8%, e 3,4 usos de ferramenta de referência por amostra contra 2,1. O ToolGrad-500, gerado com gemini-2.5-flash-lite, foi usado para o ajuste fino de modelos Gemma 3; a variante 12B obteve 83,1 no total no Berkeley Function Calling Leaderboard (BFCL), contra 83,2 do gemini-2.5-pro na data da publicação.

Quer que o Clicked explique termos como “ToolGrad” direto no seu navegador, inclusive em PDFs?

Adicionar ao Chrome — Grátis

50 explicações grátis · Sem cartão de crédito