Criando CLIs para Agentes de IA: Princípios de Design do CLI gws do Google

✍️ OpenClawRadar📅 Publicado: March 7, 2026🔗 Source
Criando CLIs para Agentes de IA: Princípios de Design do CLI gws do Google
Ad

Por que o Design CLI Focado em Agentes é Importante

A experiência do desenvolvedor humano (DX) otimiza para descoberta e tolerância a erros, enquanto a DX do agente requer previsibilidade e defesa em profundidade. O artigo argumenta que adaptar CLIs focadas em humanos para agentes é ineficaz, e demonstra isso através do CLI gws do Google para Google Workspace, que foi projetado desde o primeiro dia com agentes de IA como consumidores principais.

Princípios de Design Fundamentais

Payloads JSON Brutos em Vez de Flags Personalizadas: Humanos preferem flags simples como --title "Meu Documento", mas agentes funcionam melhor com payloads JSON diretos que mapeiam para esquemas de API sem perda de tradução.

Exemplo de comparação:

Focado em humanos (10 flags, namespace plano):
my-cli spreadsheet create --title "Orçamento Q1" --locale "en_US" --timezone "America/Denver" --sheet-title "Janeiro" --sheet-type GRID --frozen-rows 1 --frozen-cols 2 --row-count 100 --col-count 10 --hidden false

Focado em agentes (uma flag JSON): gws sheets spreadsheets create --json ' { "properties": {"title": "Orçamento Q1", "locale": "en_US", "timeZone": "America/Denver"}, "sheets": [{"properties": {"title": "Janeiro", "sheetType": "GRID", "gridProperties": {"frozenRowCount": 1, "frozenColumnCount": 2, "rowCount": 100, "columnCount": 10}, "hidden": false}}] }'

O CLI gws usa flags --params e --json para todas as entradas, aceitando payloads completos da API diretamente. A abordagem recomendada é suportar ambos os caminhos no mesmo binário em vez de manter ferramentas separadas.

Ad

Considerações Adicionais

O artigo descreve várias outras considerações de design para CLIs focadas em agentes:

  • Introspecção de Esquema: Esquemas auto-descritivos que agentes podem introspectar em tempo de execução
  • Disciplina de Janela de Contexto: Gerenciar a saída para caber dentro dos limites de contexto do agente
  • Proteção de Entrada: Proteção contra alucinações do agente
  • Habilidades do Agente: Entregar capacidades em vez de apenas comandos
  • Suporte a Múltiplas Superfícies: Trabalhar com MCP, extensões e variáveis de ambiente
  • Barreiras de Segurança: Modos de simulação e sanitização de resposta

CLIs estão se tornando a interface de menor atrito para agentes de IA interagirem com sistemas externos, exigindo saída determinística e legível por máquina em vez de interfaces orientadas para humanos.

📖 Leia a fonte completa: HN AI Agents

Ad

👀 See Also

De Replit para Local: Como um Desenvolvedor Usou Claude para Construir StillHere, um App de Chat Companheiro com IA Impulsionado por API
Tools

De Replit para Local: Como um Desenvolvedor Usou Claude para Construir StillHere, um App de Chat Companheiro com IA Impulsionado por API

Um desenvolvedor criou o StillHere.ink, um aplicativo de chat com IA para conversas no estilo companheiro usando chaves de API pessoais, após migrar do Replit para desenvolvimento local com Claude. O app conta com memória, resumos de diário, RAG, troca de modelos e ferramentas de controle de custos.

OpenClawRadar
Desenvolvedor Cria Linguagem de Programação GALA com Claude Code, Observa que Tipagem Forte Melhora Confiabilidade do Código Gerado por IA
Tools

Desenvolvedor Cria Linguagem de Programação GALA com Claude Code, Observa que Tipagem Forte Melhora Confiabilidade do Código Gerado por IA

Um desenvolvedor criou o GALA, uma linguagem de programação funcional que transpila para Go, usando extensivamente o Claude Code. A linguagem apresenta tipos selados, correspondência de padrões exaustiva, imutabilidade por padrão e mônadas, com o Claude ajudando a implementar inferência de tipos, transformadores de correspondência de padrões e corrigindo mais de 40 bugs.

OpenClawRadar
Servidor MCP Adiciona Memória Persistente com Pontuação de Recuperação ao Claude Code
Tools

Servidor MCP Adiciona Memória Persistente com Pontuação de Recuperação ao Claude Code

Um desenvolvedor criou um servidor MCP chamado engram-mcp que dá ao Claude Code memória persistente entre sessões e projetos, apresentando pontuação automática de recuperação baseada no sucesso dos resultados e detecção de desvio para conhecimento desatualizado.

OpenClawRadar
Automatize a revisão de PRs do GitHub com agentes Claude Code
Tools

Automatize a revisão de PRs do GitHub com agentes Claude Code

Um desenvolvedor criou um agente que processa menções do GitHub, aciona workers do Claude Code para revisar ou corrigir PRs, e só encaminha casos ambíguos para humanos.

OpenClawRadar