Passo 8 · Agentic Workflows · Módulo 3 · Agentic Engineering no Cluster Local EN
Cluster Local de IA · Visual Course

Agentic Engineering no Cluster Local

Use o Mac M5 Max como fábrica de pré-processamento para modelos Frontier: barato, privado e sob seu controle.

Objetivos desta lição
  • Entender o cluster local como pré-processador de tarefas para a nuvem.
  • Diferenciar loop engineering de AI Developer Workflows.
  • Mapear 7 fases de desenvolvimento orientado por IA sobre dados multimodais.
  • Justificar por que prototipar antes de especificar.
Leia primeiro (fonte primária)

AGENTS.md no projeto — descreve a diretriz de loop engineering e a arquitetura de publicação do curso.

Leia a versão simples, ou abra a camada técnica em qualquer seção.
1

A grande ideia


O cluster local não substitui a nuvem: ele é uma fábrica de pré-processamento que recebe dados brutos — PDFs, imagens, áudio, prompts longos — e entrega um pacote enxuto e bem estruturado para um modelo Frontier. Quase todo o trabalho pesado acontece em casa; a nuvem só recebe o que realmente precisa de raciocínio de ponta.

Pense em uma refinaria: o petróleo bruto é separado, filtrado e classificado localmente antes de ir para a indústria química de alto valor. Se você enviasse o óleo cru, pagaria caro e demoraria mais.

Por baixo do capô

O fluxo técnico é: ingestão → chunking → OCR/ASR/VLM → embedding → busca semântica → síntese local → validação → chamada à API Frontier. Modelos locais como Qwen3.6-35B-A3B, Gemma-4-26B-A4B e DeepSeek-V4-Flash dividem as etapas; bge-m3 e pgvector cuidam da memória de longo prazo. O resultado é um contexto menor, mais relevante e muito mais barato de enviar para gpt-5.5 ou claude-opus-4.8.

Dados brutos PDF · imagem · áudio Cluster local Qwen3.6-35B-A3B · Gemma 4 · RAG OCR · ASR · chunking · embedding validação executável Frontier API raciocínio de ponta O Mac pré-processa, filtra e valida; a nuvem decide apenas o que exige capacidade máxima.
Cluster local como refinaria de dados para modelos Frontier.
2

Loop engineering vs AI Developer Workflows


Loop engineering é o hábito de aprender, executar, verificar e melhorar uma unidade por vez. Já AI Developer Workflows são processos em que agentes de IA fazem parte da equipe: planejam, codificam, revisam e testam. O cluster local torna ambos viáveis porque barateia cada iteração.

A diferença prática: no loop você verifica antes de continuar; no workflow agentic você delega tarefas a modelos especialistas e só intervém nos gates. Os dois se complementam — e o cluster é o terreno comum onde eles rodam.

Por baixo do capô

Em um workflow agentic, cada etapa pode ser uma chamada a um endpoint local. O orquestrador decide qual modelo executa: mlx_lm.server para texto/código, mlx_vlm.server para visão, mlx_audio para fala. O loop de feedback usa a saída de um worker para montar o prompt do próximo. Tudo fica dentro do Mac, então iterar 50 vezes custa quase zero.

Loop engineering
Reduz o risco: cada passo prova que funciona antes do próximo. Ideal para descobrir o formato certo de saída.
AI Developer Workflow
Escalando a produtividade: vários agentes trabalham em paralelo. Ideal quando o problema já foi decomposto.
3

7 fases de AI-driven development


Para transformar dados brutos em um pacote pronto para Frontier, dividimos o trabalho em sete fases. Cada fase pode ser executada por um agente local diferente, e o resultado de uma alimenta a próxima.

Por baixo do capô

As fases mapeiam para chamadas reais: ingestão (curl ou watcher), classificação (classifier prompt no Qwen3.6-35B-A3B), extração (GLM-OCR-bf16, Qwen3-ASR-1.7B-8bit, mlx_vlm), RAG (bge-m3 + pgvector), geração de hipóteses (/opinion com múltiplos modelos), validação (/auto-validate com testes/shell), e entrega (/fusion para resumo decisão-ready).

Das entradas brutas ao pacote Frontier
  1. Ingerir — colete arquivos, streams, URLs e prompts em um único bucket de trabalho.
  2. Classificar — decida se o item é texto, imagem, áudio, código ou mistura; descarte lixo.
  3. Extrair estrutura — OCR, ASR e VLM transformam tudo em texto semântico.
  4. Enriquecer com RAG — busque documentos e fatos relevantes para reduzir alucinação.
  5. Gerar perspectivas — rode /opinion com modelos locais para obter vários ângulos.
  6. Validar gates — execute /auto-validate: testes, lint, schema, política.
  7. Entregar ao Frontier — envie apenas o contexto sintetizado e as questões de alto valor.
Dica de arquiteto. Se uma fase falhar, não avance. O loop engineering exige que cada gate esteja verde antes de pagar por uma chamada Frontier.
4

Protótipo antes de especificar


Em vez de escrever um PRD de 30 páginas, construa um protótipo descartável em minutos no cluster local. Modelos rápidos e baratos respondem perguntas que você ainda não sabe fazer. Quando o protótipo provar que a direção funciona, você escreve a especificação com dados reais.

Pense em esboço arquitetônico: você faz maquetes baratas antes de contratar a construtura. Especificar sem protótipo é encomendar um prédio sem saber se o terreno aguenta.

Por baixo do capô

Um protótipo agentic pode ser um script Python de 40 linhas chamando mlx_lm.server ou ollama. Use logs simples, sem banco de dados. O objetivo é validar a decomposição das tarefas e o formato da saída. Quando funcionar, substitua o script por um orquestrador robusto — LangGraph, n8n ou um servidor próprio.

Python · protótipo de agente local
import requests

def ask_local(prompt):
    r = requests.post("http://localhost:8080/v1/chat/completions",
        json={"model": "Qwen3.6-35B-A3B",
              "messages": [{"role": "user", "content": prompt}]},
        timeout=120)
    return r.json()["choices"][0]["message"]["content"]

outline = ask_local("Resuma este PDF em 3 tópicos.")
print(outline)
5

Analogia: estagiário de elite


Imagine que o modelo Frontier é o CEO de uma empresa: caro, ocupado e decisivo. O cluster local é o estagiário de elite que chega antes da reunião: lê todos os documentos, destaca os números, marca inconsistências, prepara três opções e só pede a decisão final ao CEO.

Sem o estagiário, o CEO passa a reunião inteira lendo planilhas. Com ele, o CEO decide em cinco minutos. Esse é o papel do cluster local em um workflow agentic: preparar o briefing.

Por baixo do capô

O "briefing" é um objeto bem definido: prompt final, contexto comprimido, referências RAG, hipóteses geradas por /opinion, resultados de /auto-validate e uma recomendação de ação. Quanto melhor for o briefing, menos tokens a nuvem precisa processar. O estagiário local roda 24/7 sem custo por chamada.

Cluster local estagiário de elite pré-processa · valida · resume Modelo Frontier CEO decide com briefing enxuto briefing decisão-ready
O cluster local prepara o briefing; o Frontier só decide.
6

Experimente


Teste o que aprendeu com exercícios rápidos.

Revisão do módulo
Qual é o papel principal do cluster local em agentic workflows?
b está correta. O cluster local filtra, estrutura e valida antes de enviar apenas o essencial à nuvem.
Qual padrão gera várias perspectivas independentes antes da consolidação?
a está correta. /opinion pede a múltiplos modelos ou prompts que gerem ângulos diferentes sobre o mesmo problema.
Por que prototipar antes de especificar?
b está correta. O protótipo barato no cluster prova se a decomposição e o formato de saída funcionam.
Dúvida? Pergunte ao seu professor/agente antes de ir para a próxima lição.