03 · Ferramentas e ambiente26 / 62

Tool

Uma função que o programa oferece pro agente chamar. É o único jeito dele enxergar e mexer no mundo.

Onde você esbarra nisso

Quando você pede algo trivial e recebe um "não consigo acessar". Ele não está sendo preguiçoso, está sendo honesto sobre o que tem à mão.

Conecta com

O que é

Ler arquivo, escrever arquivo, rodar comando, buscar na internet, consultar banco. Cada uma dessas é uma ferramenta que alguém decidiu expor.

Duas frases que resumem tudo: ferramenta é como o agente percebe (o resultado que volta é a única janela dele pro mundo) e ferramenta é como o agente age. Sem ferramenta, ele opina.

O que muda pro teu negócio

É a lista que define o que um agente pode e não pode fazer pra você, e ela é finita e conhecida. Isso é ótimo, porque dá pra auditar.

Quando alguém disser que o agente "resolve qualquer coisa", peça a lista de ferramentas. Ela existe, está no código, e ela é o teto real da promessa. Nada fora dela vai acontecer.

Do outro lado, quando ele não consegue fazer algo simples, a causa costuma ser a mesma: não tem ferramenta pra isso. É problema de configuração, não de inteligência.

Fontes

Skill `claude-api` (cache 2026-06-24): definição de ferramenta, chamada em paralelo, e ferramentas que rodam no servidor do fornecedor.

AI Coding Dictionary, verbete "Tool", Matt Pocock. A dupla formulação, ferramenta como percepção e como ação, é dele e é o que torna o conceito ensinável em uma frase.