🔗 Assistentes e Multibots

Comparacao entre manter um unico assistente generalista vs dividir em multiplos bots especializados.

A decisao entre mono-bot e multi-bot impacta custo, complexidade e qualidade das respostas.

Monolito vs microsservicos, limites de contexto, especializacao, trade-offs.

Padroes arquiteturais para orquestrar multiplos bots: hub central, router de intencao, filas async.

Sem arquitetura clara, multibots viram caos. O padrao certo simplifica tudo.

Hub-and-spoke, intent classification, message queue, load balancing.

Bots com system prompts, tools e contexto especificos para cada funcao do negocio.

Bots especialistas entregam 3-5x mais qualidade que generalistas na sua area.

Domain-specific prompts, tool isolation, context window dedicada.

Frameworks open source para construir bots pessoais com multi-agente, skills e integracao Telegram.

Ter seu proprio bot pessoal e o melhor exercicio pratico de multibot.

OpenClaw, ClaudeClaw, Claude Agent SDK, skills system, multi-agent routing.

Conectar bots a multiplos canais de comunicacao com adapter pattern e APIs especificas.

Usuarios estao em canais diferentes. Um bot que so funciona em 1 canal perde alcance.

Telegram Bot API, WhatsApp Business API, adapter pattern, webhook vs polling.

Exercicio pratico: criar um router central com 2 bots especialistas conectados a 1 canal.

Teoria sem pratica nao constroi nada. Este exercicio cria o esqueleto do seu multibot.

Setup router, intent detection, bot dispatch, resposta unificada, teste end-to-end.

Analogia direta: um bot que faz tudo (monolito) vs bots separados por funcao (microsservicos).

O padrao arquitetural que voce escolhe define escalabilidade, custo e manutencao.

Monolito, microsservicos, acoplamento, coesao, contexto compartilhado vs isolado.

Context window finita, system prompt generico, conflito de tools, degradacao de qualidade com escopo amplo.

Reconhecer quando seu bot unico esta no limite evita meses de debugging.

Context overflow, tool confusion, prompt bloat, sinais de que e hora de dividir.

Isolamento de contexto, prompts especializados, processamento paralelo, mix de modelos por custo.

Multi-bot permite usar o modelo certo para cada tarefa: barato para chat, caro para raciocinio.

Isolamento, paralelismo, model mixing, cost optimization, fault isolation.

Framework de decisao: volume, diversidade de tarefas, requisitos de latencia, budget, complexidade de tools.

Nem todo projeto precisa de multibot. Saber quando nao escalar e tao importante quanto saber quando escalar.

Decision matrix, break-even point, complexidade operacional, regra do "3 dominios".

Strangler fig pattern para bots: migrar gradualmente de mono para multi sem downtime.

Reescrever do zero e arriscado. Migracao incremental preserva o que funciona.

Strangler fig, feature flags, shadow mode, canary routing, rollback strategy.

Aplicar o framework de decisao ao seu projeto: mapear dominios, avaliar volume, definir se mono ou multi.

Decisao concreta para o seu SaaS. Saida: documento de arquitetura de bots.

Audit template, domain mapping, recommendation doc, next steps.

Um hub central recebe todas as mensagens e roteia para bots especialistas (spokes). Padrao mais comum.

70% dos sistemas multibot usam hub-and-spoke. E o padrao mais testado e documentado.

Hub central, spokes, single entry point, response aggregation, session management.

Componente que analisa a mensagem do usuario e decide qual bot especialista deve responder.

O router e o cerebro do multibot. Router ruim = experiencia ruim, independente da qualidade dos bots.

Intent classification, LLM router vs regex vs embedding, confidence threshold, fallback.

Desacoplar recebimento de mensagens do processamento. Filas para lidar com picos e tarefas longas.

Sem filas, um bot lento trava todo o sistema. Queues dao resiliencia e escalabilidade.

Redis queues, BullMQ, dead letter queue, retry logic, backpressure.

Distribuir carga entre instancias de bots. Round-robin, weighted, least-connections.

Rate limits de APIs exigem distribuicao inteligente. Um bot pode usar Ollama local, outro OpenRouter.

Load balancing strategies, rate limit awareness, model fallback chains, cost routing.

O que acontece quando um bot especialista falha. Chain de fallback, respostas degradadas, circuit breaker.

Em producao, bots falham. Sem fallback, o usuario recebe erro. Com fallback, recebe resposta menor mas util.

Circuit breaker, fallback chain, graceful degradation, health checks, auto-recovery.

Construir um router que classifica intent e despacha para 3 bots mock com fallback.

O router e a peca mais critica. Dominar ele primeiro simplifica todo o resto.

Router implementation, intent mapping, dispatch logic, fallback handler, logging.

Bot especializado em campanhas, copy, segmentacao, analytics e automacao de marketing.

Marketing e o dominio com maior ROI de automacao. Um bot pode gerar e distribuir conteudo 24/7.

System prompt de marketing, tools de analytics, integracao com plataformas de ads.

Bot que qualifica leads, responde duvidas de produto, agenda demos e acompanha pipeline.

Tempo de resposta e o fator #1 em conversao. Bot de vendas responde em segundos, humano em horas.

Lead qualification, product knowledge base, CRM integration, handoff to human.

Bot que resolve tickets, consulta FAQ, escala para humano quando necessario, coleta feedback.

Suporte e o caso de uso mais maduro de chatbots. 60-80% dos tickets podem ser resolvidos por bot.

RAG para FAQ, ticket creation, escalation rules, sentiment detection, CSAT tracking.

Bot que gera blog posts, social media, newsletters, adapta tom de voz e mantem brand consistency.

Conteudo e o maior gargalo de marketing. Bot de conteudo com brand voice multiplica output 10x.

Brand voice prompt, content calendar, multi-format output, SEO integration.

Bot que monitora sistemas, executa deploys, gerencia infra, reporta status e resolve incidentes.

DevOps com bot reduz MTTR drasticamente. Alertas viram acoes automaticas.

Runbook automation, health monitoring, incident response, ChatOps, deployment triggers.

Escolher 2 dominios, criar system prompts especificos, definir tools e testar com conversas reais.

Pratica concreta de especializacao. Saida: 2 bots funcionais com personalidade e tools proprias.

System prompt design, tool selection, test conversations, quality evaluation.

Categoria de software que permite criar assistentes pessoais completos, rodando local ou em servidor proprio.

Bot pessoal e diferente de chatbot SaaS. Voce controla dados, custo, integracao e privacidade.

Self-hosted, data ownership, local-first, open source vs proprietary.

Framework open source com multi-agent routing (Ollama, OpenRouter, Codex), dashboard e Telegram integration.

Referencia real de como construir um sistema multibot do zero com Node.js e TypeScript.

Router module, agent registry, token tracking, orchestrator toggle, SQLite store.

Bot pessoal construido com Claude Agent SDK, sessions persistentes, skills e MCP tools.

Claude Code como backend de bot pessoal e o setup mais poderoso disponivel hoje.

Claude Agent SDK, session resumption, CLAUDE.md as system prompt, tool permissions.

Sistema de skills modulares: Gmail, Calendar, Obsidian, browser, cada um com triggers automaticos.

Skills transformam um chatbot em assistente pessoal real. Email, agenda, notas, tudo via chat.

Skill registry, trigger words, MCP servers, permission model, skill composition.

Como adicionar novos agentes, criar skills customizadas, ajustar personalidade e configurar scheduling.

O valor de um framework e a extensibilidade. Customizar e o que transforma generico em pessoal.

Plugin architecture, agent YAML config, scheduled tasks, memory system, .env configuration.

Clonar, configurar e rodar um framework de bot pessoal. Testar com Telegram e adicionar 1 skill.

Setup hands-on. Ao final voce tem um bot pessoal rodando no seu computador.

Git clone, .env setup, npm install, BotFather token, first message test.

Widget de chat que se embute em qualquer site. WebSocket ou SSE para streaming de respostas.

Web chat e o canal mais acessivel. Sem instalacao, funciona em qualquer browser.

Widget embed, WebSocket, SSE streaming, iframe vs inline, customization API.

API completa do Telegram: polling vs webhook, inline keyboards, file upload, grupos e canais.

Telegram e a plataforma mais amigavel para bots. API rica, sem custos, documentacao excelente.

BotFather, getUpdates vs webhook, sendMessage, inline keyboard, file handling.

Integrar bot com WhatsApp via Meta Cloud API. Templates, sessoes de 24h, webhook verification.

WhatsApp tem 2B+ usuarios. No Brasil, e o canal #1 de comunicacao com clientes.

Meta Cloud API, message templates, 24h session window, webhook setup, phone number verification.

Camada de abstracao: interface unica para o bot, adapters traduzem para cada canal especifico.

Sem adapter, adicionar um novo canal exige reescrever logica. Com adapter, e plug-and-play.

Adapter pattern, message normalization, channel-specific features, unified response format.

Plataformas no-code/low-code para construir e conectar bots. Quando usar vs quando construir do zero.

Nem sempre faz sentido construir do zero. Plataformas aceleram prototipagem e MVP.

LangBot, Botpress, visual flow builder, custom code nodes, deploy options, pricing.

Conectar o mesmo bot a Telegram + Web Chat usando adapter pattern. Mesma logica, 2 interfaces.

Prova concreta de que adapter pattern funciona. Saida: bot respondendo em 2 canais simultaneamente.

Adapter implementation, Telegram setup, web widget, unified handler, dual testing.

Definir dominios, escolher modelos por bot, mapear intents, desenhar fluxo de mensagens e fallbacks.

Planejamento evita retrabalho. 1 hora de design economiza 10 horas de debug.

System design doc, domain mapping, model selection matrix, message flow diagram.

Implementar router com classificacao de intent usando LLM leve (ex: llama3.2) ou regex patterns.

O router e o primeiro componente a construir. Todo o resto depende dele funcionar bem.

Intent classifier, confidence scoring, dispatch table, logging, router tests.

Criar 2-3 bots especialistas com system prompts, tools e modelos distintos. Registrar no router.

Especialistas sao os workers do sistema. Qualidade aqui define qualidade da experiencia final.

Agent config, system prompt tuning, tool binding, model assignment, response formatting.

Conectar o multibot a pelo menos 1 canal real (Telegram) com adapter para facilitar adicionar mais.

Bot sem canal e bot sem usuario. A integracao com canal real fecha o ciclo.

Channel adapter, Telegram integration, message normalization, response delivery.

Testar o fluxo completo: mensagem > router > especialista > resposta. Cenarios felizes e de erro.

Testes e2e pegam bugs de integracao que testes unitarios nao pegam. Multibot tem muitas interfaces.

Test scenarios, happy path, error path, latency testing, conversation flow tests.

Entregar sistema multibot completo: router + 2 especialistas + 1 canal + fallback + testes passando.

Projeto final da Trilha 5. Saida: sistema multibot funcional que voce pode evoluir.

Checklist de entrega, demo script, documentacao minima, deployment instructions.