Por que uma Ferramenta run() Única com Comandos Unix Supera a Chamada de Funções para Agentes de IA

Um desenvolvedor com dois anos de experiência construindo agentes de IA — primeiro como líder de backend na Manus, depois em projetos de código aberto Pinix e agent-clip — concluiu que uma única ferramenta run(command="...") com comandos no estilo Unix funciona melhor do que as abordagens tradicionais de chamada de funções.

A Convergência Unix-LLM

A percepção central é que a decisão de design de 50 anos do Unix — tudo é um fluxo de texto — se alinha perfeitamente com a natureza baseada em texto dos LLMs. Os programas Unix se comunicam por meio de pipes de texto, usam --help para autodescrição, relatam sucesso/fracasso com códigos de saída e comunicam erros por meio do stderr. Os LLMs entendem apenas tokens de texto de forma semelhante. Isso torna a interface baseada em texto do Unix uma opção natural para os LLMs, que essencialmente funcionam como operadores de terminal com ampla exposição a comandos de shell em seus dados de treinamento.

A Abordagem de Ferramenta Única

A maioria dos frameworks de agentes fornece aos LLMs um catálogo de ferramentas independentes como [search_web, read_file, write_file, run_code, send_email, ...], exigindo que o LLM tome decisões de seleção de ferramentas antes de cada chamada. À medida que mais ferramentas são adicionadas, a precisão da seleção cai à medida que a carga cognitiva muda de "o que preciso realizar?" para "qual ferramenta?".

A abordagem alternativa usa uma única ferramenta run(command="...") que expõe todas as capacidades como comandos CLI:

run(command="cat notes.md")
run(command="cat log.txt | grep ERROR | wc -l")
run(command="see screenshot.png")
run(command="memory search 'deployment issue'")
run(command="clip sandbox bash 'python3 analyze.py'")

A seleção de comandos se torna composição de strings dentro de um namespace unificado, em vez de alternância de contexto entre APIs não relacionadas.

Por que os Comandos CLI Funcionam Melhor

Os comandos CLI são o padrão de uso de ferramentas mais denso nos dados de treinamento de LLMs, aparecendo em bilhões de linhas no GitHub (instruções de instalação do README, scripts de build CI/CD, soluções do Stack Overflow). O desenvolvedor observa: "Não preciso ensinar o LLM a usar CLI — ele já sabe."

Compare abordagens para a mesma tarefa:

Tarefa: Ler um arquivo de log, contar as linhas de erro

Abordagem de chamada de função (3 chamadas de ferramenta):
1. read_file(path="/var/log/app.log") → retorna o arquivo inteiro
2. search_text(text=, pattern="ERROR") → retorna linhas correspondentes
3. count_lines(text=) → retorna número

Abordagem CLI (1 chamada de ferramenta):
run(command="cat /var/log/app.log | grep ERROR | wc -l") → "42"

Uma chamada substitui três porque os pipes Unix suportam nativamente a composição. O desenvolvedor enfatiza que isso não é uma otimização especial, mas sim aproveitar o design existente do Unix.