MÓDULO 3.1

🔧 Tool Use no 4.7

Por que o 4.7 chama menos tools, como calibrar busca, e quando forçar leitura de código antes de concluir.

7
Tópicos
35
Minutos
Avançado
Nível
Conceito
Tipo
TOOL CALLS POR TAREFA — 4.6 vs 4.7 (mesmo briefing) 4.6 → 14 tool calls explora sempre 4.7 → 6 tool calls raciocina antes ↑ menos latência, ↑ mais coerência • ⚠ peça Read/Grep explícito em código legado
1

🐢 Menos tools (e por que é bom)

O 4.7 prefere raciocinar com o contexto que tem a disparar Read/Grep. Essa mudança foi explícita da Anthropic: o modelo pondera antes de buscar.

✓ Upside

  • • Menos latência
  • • Mais coerência entre passos
  • • Menos ruído no contexto

✗ Downside

  • • Parece "preguiçoso" em código novo
  • • Pode chutar API que não existe
  • • Precisa instrução explícita
2

📈 Effort × tool use

EffortTool calls típicosQuando usar
low0–2arquivos conhecidos, diff cirúrgico
medium2–5rotina padrão
xhigh6–14busca ampla, codebase novo
max14+exploração investigativa profunda
3

🔓 Quando forçar busca

Três sinais que pedem instrução explícita para usar ferramentas:

4

📝 Prompt canônico proativo

<investigate_before_answering>
Before proposing a fix or generating new code:
1. Use Read, Grep, and Glob liberally to inspect relevant files.
2. Never speculate about code you have not read.
3. Verify function signatures, import paths, and types by reading the source.
4. If a symbol's definition is unclear, grep for it before assuming its shape.
5. Prefer evidence from the codebase over prior knowledge.
</investigate_before_answering>
5

🔍 Read, Grep, Glob

Glob

Busca por nome de arquivo via pattern (**/*.ts).

Use antes de Grep para reduzir escopo.

Grep

Busca por conteúdo com regex.

Use output_mode=content quando precisa ver contexto.

Read

Abre arquivo por caminho absoluto.

Use offset+limit em arquivos grandes.

6

⚠️ Over-trigger em prompts antigos

✗ Legado 4.6

CRITICAL: you MUST use
the Read tool before every
answer, no exceptions.

No 4.7 dispara leitura mesmo quando desnecessária.

✓ Atualizado 4.7

Use Read when you need to
verify a symbol or signature
you don't already have evidence
for in the conversation.

Condicional e proporcional.

7

🧪 Benchmark pessoal

Escolha uma tarefa real e rode duas vezes — com e sem o bloco <investigate_before_answering>. Compare:

  • • Tool calls totais (Read/Grep/Glob)
  • • Turnos humanos
  • • Tokens consumidos (/usage)
  • • Tempo de parede
  • • Qualidade do resultado (subjetiva)

📋 Resumo

Menos tools por default — raciocínio > busca
Effort modula tool use — xhigh para exploração
Bloco investigate — instrução explícita para código novo
Read/Grep/Glob — trio canônico de leitura

Próximo Módulo:

3.2 — Fan-out Paralelo