⚙️ Tecnicas: Frameworks e Orquestracao

Framework minimalista e experimental da OpenAI para aprender principios de swarms.

Codigo limpo e legivel — melhor ponto de entrada para entender a mecanica.

Educacional, nao para producao, principios fundamentais

Agente = conjunto de instrucoes + funcoes + modelo — simples assim.

Entender a unidade basica antes de sistemas complexos.

Instructions, functions, model, name

Um agente decide passar o controle para outro agente especializado.

Handoff e o mecanismo central de orquestracao no Swarm.

transfer_to_agent(), context variables, routing

Dicionario de variaveis acessivel por todos os agentes do swarm.

E como agentes compartilham informacao sem acoplamento.

context_variables, passagem por referencia

Swarm com agente de triagem → vendas → suporte tecnico → reembolso.

Caso de uso classico que demonstra todos os conceitos.

Triage agent, specialist agents, routing logic

Como migrar conceitos do Swarm educacional para frameworks de producao.

Transicao natural para CrewAI/LangGraph.

Limitacoes, alternativas, evolucao

Framework role-based que organiza agentes como uma equipe com cargos e responsabilidades.

Maior comunidade (100k+ devs certificados), 1.1 bilhao de tarefas orquestradas.

Agents, Tasks, Crews, Flows

Cada agente tem role, goal, backstory — como um funcionario com cargo definido.

Modelo mental intuitivo para qualquer equipe.

Role, goal, backstory, tools, llm

Tarefas com descricao, agente responsavel e criterio de conclusao.

Tarefas bem definidas = execucao previsivel.

Description, agent, expected_output, context

Ferramentas que agentes podem usar: busca web, leitura de arquivos, APIs.

Agentes sem ferramentas sao limitados.

CrewAI Tools, custom tools, MCP servers

Workflows complexos com condicoes, loops e ramificacoes.

Projetos reais precisam de logica de negocio alem de delegacao simples.

Flow, Router, conditional execution

Limites de seguranca e memoria persistente entre execucoes.

Producao exige controle e continuidade.

Input/output guardrails, short/long-term memory

Framework graph-based da LangChain onde estados fluem por nos e arestas.

Maximo controle sobre fluxo — ideal para workflows complexos.

StateGraph, Nodes, Edges, Checkpointing

Funcoes que recebem estado, processam e retornam estado atualizado.

Cada no pode ser um agente, ferramenta ou logica de negocio.

Node functions, state transformation

Conexoes entre nos — podem ser condicionais (if/else) ou fixas.

E onde a logica de roteamento vive.

Conditional edges, routing, bifurcacao

Salvar estado a cada passo para retomar apos falhas.

Essencial para swarms de longa duracao em producao.

State persistence, recovery, durability

Inserir pontos de aprovacao humana no fluxo do grafo.

Governanca e compliance exigem verificacao humana.

Interrupt, resume, approval gates

Grafos dentro de grafos — supervisor no topo coordenando subgrafos especializados.

Composicao e a forma de escalar complexidade.

Subgraph, supervisor pattern, hierarquia

Instalar Bun, OMO e configurar para Claude, OpenAI, Gemini ou modelos gratuitos.

Setup pratico para comecar a usar swarms hoje.

bunx, opencode.json, global vs por projeto

Escrever `ultrawork` e deixar o swarm executar ate terminar.

Para quando voce sabe exatamente o que quer.

Execucao continua, sem intervencao, todos agentes ativados

Agente planificador faz entrevista detalhada antes de comecar a executar.

Melhor abordagem para projetos novos — contexto completo.

Tab para Prometheus, entrevista, /start-work

Visual Engineering, Deep Research, Quick Changes, UltraBrain — roteamento automatico.

Entender como o orquestrador decide qual agente usar.

Categoria automatica, tipo de tarefa, modelo otimizado

Arquivo .opencode/oh-my-opencode.jsonc para definir modelo de cada agente.

Otimizar custo e desempenho personalizando modelos.

sisyphus→opus, hephaestus→codex, explore→gratuito

Demonstracao end-to-end: entrevista → plano → execucao paralela → revisao → resultado.

Ver o swarm em acao em um caso real.

Workflow completo, auto-correcao, resultado funcional

Framework da Microsoft onde agentes interagem como dialogos entre si.

Abordagem unica — conversacao como mecanismo de coordenacao.

ConversableAgent, GroupChat, colaboracao conversacional

AutoGen + Semantic Kernel combinados no novo framework enterprise da Microsoft.

E para onde o AutoGen esta migrando — importante saber.

State management, type safety, middleware, telemetria

AutoGen executa codigo em containers Docker isolados — seguranca maxima.

Padrao ouro para agentes que geram e executam codigo.

Docker executor, sandboxing, code generation + execution

Multiplos agentes conversam em grupo com manager que controla turnos.

Padrao unico do AutoGen — debate e refinamento entre agentes.

GroupChatManager, turn management, consensus

Agentes podem chamar funcoes externas durante a conversacao.

Estender capacidades dos agentes conversacionais.

register_function, tool_use, return values

Comparacao pratica: conversacional (AutoGen) vs role-based (CrewAI) vs graph (LangGraph).

Escolher o framework certo economiza semanas de trabalho.

Tabela comparativa, criterios de escolha, casos de uso ideais

Protocolo da Anthropic que padroniza como agentes acessam ferramentas e dados externos.

Elimina APIs customizadas — padrao universal para ferramentas.

Tools, data sources, resources, prompts, sampling

Protocolo do Google (agora Linux Foundation) para comunicacao direta entre agentes.

E o padrao emergente mais importante para interoperabilidade.

Agent Cards, task management, streaming, sem lock-in

Protocolo da IBM para dialogo estruturado entre agentes heterogeneos.

Enfase em intencao e semantica — ideal para enterprise.

Intent, structured dialogue, semantic communication

MCP para conectar agente→ferramenta; A2A para conectar agente→agente.

Sao complementares, nao concorrentes.

MCP = vertical (dados), A2A = horizontal (colaboracao)

Setup de MCP servers para conectar agentes a APIs, bancos de dados, servicos.

Hands-on com o protocolo mais adotado.

claude_desktop_config.json, servers, stdio/sse

Cenario onde agentes de diferentes providers colaboram via protocolos abertos.

Preparar-se para o futuro multi-vendor.

Open standards, federation, trust

Agente central roteia tarefas e sintetiza resultados — padrao mais usado.

E o "default" para a maioria dos projetos.

Central routing, result synthesis, governanca

Um agente executa, outro verifica — ideal para alta acuracia.

Reduz erros drasticamente em tarefas criticas.

Gerador + Verificador, dual review, cross-model

Agentes se auto-organizam dinamicamente baseado na tarefa.

Flexibilidade maxima para cenarios imprevisiveis.

Auto-routing, capability matching, emergencia

Agente intermediario resolve conflitos entre agentes especializados.

Essencial quando agentes discordam ou geram resultados conflitantes.

Conflict resolution, consensus, arbitration

Se nao cabe em TASK + FILE + CONSTRAINT em tres bullets, a tarefa e grande demais.

Heuristica pratica para dimensionar tarefas de agentes.

Atomicidade, max 2 arquivos por tarefa, decomposicao

Hierarquia multinivel — supervisor principal coordena supervisores de area.

Escalar para projetos muito grandes.

Hierarchical MAS, meta-orchestration, delegation chains

Framework enterprise-grade focado em producao — diferente do OpenAI Swarm educacional.

Opcao madura para deploy em escala.

Production-ready, multiple swarm types, enterprise

Orquestracao confiavel com estrutura de agencia — agentes como departamentos.

Modelo organizacional intuitivo.

Agency structure, reliable orchestration

Framework focado em comunicacao entre agentes atraves de debate.

Abordagem unica — consenso por argumentacao.

Role-playing, debate, consensus building

SDK da Anthropic para construir agentes customizados com Claude.

Integracao nativa com o melhor modelo para raciocinio.

Agent SDK, tool_use, streaming, subagentes

Comparacao lado a lado de todos os frameworks cobertos.

Referencia rapida para decisoes.

Stars, paradigma, linguagem, complexidade, caso ideal

Arvore de decisao: iniciante? → OpenAI Swarm. Equipe? → CrewAI. Controle? → LangGraph. Enterprise? → Swarms.

Atalho para a decisao mais importante do projeto.

Decision tree, criterios, trade-offs