agentcad

O ciclo central roda um script de build123d e devolve JSON estruturado. Você recebe dimensões nos três eixos, volume, contagem de faces e arestas, e um indicador is_valid. Quando o modelo quebra, a resposta inclui o erro e, para formas de falha comuns, uma sugestão de como arrumar. Isso transforma um vago "não funcionou" em algo sobre o que um agente pode agir. Simples, e conta muito.

Cada execução renderiza prévias PNG de quatro ângulos, e você também pode pedir posições de câmera personalizadas. Os renders são 2D e ficam sob uma chave separada das saídas 3D, então nada se mistura. Um render que falha nunca desfaz uma construção boa. Você mantém o arquivo STEP e tenta de novo só a vista que precisa.

Modelos concluídos são exportados para os formatos que cada ferramenta seguinte realmente quer. STEP carrega a geometria precisa para continuar o trabalho em CAD, enquanto STL, GLB e OBJ cobrem impressão 3D e visualizadores web. Cada construção bem-sucedida também grava um arquivo STEP versionado. Nada é sobrescrito.

As checagens estáticas pegam erros de sintaxe, uma chamada show_object() ausente e imports não resolvíveis em menos de 100 ms. Nada roda. Nada é escrito no disco, e nenhum número de versão é consumido. Para um agente que gera dezenas de tentativas, pular as condenadas poupa tempo real.

Um comando de inspeção dedicado gera um relatório de topologia para depurar geometria complicada, e a partir da segunda versão agentcad compara cada resultado com a execução anterior. Juntos, respondem às duas perguntas que mais aparecem: por que este sólido é inválido, e o que mudou desde a última vez.

Os scripts não precisam de uma pilha de imports. As primitivas do build123d, show_object e os auxiliares de edição do próprio agentcad vêm pré-injetados, então o agente escreve box = Box(10, 20, 5) e segue. Menos imports, menos erros. Menos recheio também significa menos lugares para um agente introduzir um erro.

Adicionar agentcad à config MCP de um projeto dá ao Claude Code, ao Cursor ou a qualquer agente compatível acesso direto ao backend CAD. Rodar agentcad init também grava o guia de uso no repositório como bloco AGENTS.md e skill do Claude Code, então o agente pega o fluxo em cada sessão sem você precisar lembrar.