Escolher o primitivo certo

Você conhece ferramentas, recursos e prompts. Agora, a habilidade é escolher o recurso certo para cada funcionalidade que deseja expor. 🧭

O divisor mais claro é o controle. As ferramentas são controladas pelo modelo, os recursos são controlados pela aplicação e os prompts são controlados pelo usuário.

Se uma funcionalidade faz algo, como enviar uma mensagem ou gravar uma linha, quase sempre ela é uma ferramenta. A ação é a característica principal da ferramenta.

Se o modelo precisa apenas ler algo, como um arquivo, registro ou configuração, use um recurso. Sem efeitos colaterais, apenas contexto.

Se você quer uma maneira repetível de iniciar uma tarefa com um clique, isso é um prompt. O usuário o aciona e preenche algumas entradas.

Buscar o clima atual geralmente se encaixa em uma tool, pois o modelo decide quando precisa de dados recentes e envia o argumento de uma cidade.

O README do seu projeto é um contexto estático que a IA deve visualizar. Esse é um exemplo clássico de recurso, anexado pela aplicação, não executado pelo modelo.

Um comando reutilizável para resumir algo, escolhido pelo usuário em um menu, é um prompt. Ele estrutura a instrução para que todo resumo comece da mesma maneira.

Servidores reais combinam os três: um recurso fornece contexto, um prompt estrutura a solicitação e uma ferramenta executa a ação resultante.

Está em dúvida entre uma ferramenta e um recurso? Pergunte se isso altera alguma coisa. Se sim, é uma tool; se apenas informa, é um recurso.

Antes de programar, liste cada funcionalidade e marque-a como ferramenta, recurso ou prompt. Esse rápido mapeamento mantém seu servidor organizado e previsível.

Muito bem! Pergunte quem controla o recurso e se ele executa uma ação: ferramenta para ações, recurso para dados somente leitura e prompt para solicitações salvas. ✅