Relatório Arquitetural · Confidencial

Integração Omnichannel Bchat × Health

Uma fundação baseada em Sistemas Multiagentes e no Protocolo MCP para unir atendimento conversacional e transações clínicas com determinação e segurança.

MCPProtocolo de contexto
BullMQEspinha dorsal assíncrona
LiteLLMGateway central de IA
BCHAT × HEALTH Visão Executiva · 01
Contexto e Desafio

A convergência entre conversação e clínica

Plataformas de atendimento omnichannel e ecossistemas de saúde exigem uma fundação que harmonize a fluidez do processamento em linguagem natural com o rigor absoluto das transações clínicas.

DOMÍNIO A

Bchat

Plataforma de comunicação baseada num fork do Chatwoot — canais WhatsApp, Telegram e web.

DOMÍNIO B

Health

Monorepo transacional em PostgreSQL, Drizzle ORM, Fastify, Node.js e Python.

O DESAFIO

Determinismo

Permitir interação via chat de forma segura, assíncrona e altamente determinística em ações sensíveis.

BCHAT × HEALTH Recomendação · 02
Recomendação Principal

Eventos + Filas + MCP + LiteLLM

"A lógica conversacional não deve residir no monorepo transacional de forma acoplada — deve operar sob o padrão de Agent Bot nativo do Chatwoot, separando o processamento de intenções da execução de domínio." — Decisão arquitetural central

Event-driven · filas assíncronas (BullMQ) Protocolo MCP estrito LiteLLM como gateway central Agent Bot desacoplado do monorepo
BCHAT × HEALTH Justificação · 03
Quatro Pilares Fundamentais

Por que esta abordagem

PILAR 01 · MCP

Portabilidade universal

Elimina a dependência de formatos proprietários de function calling. O LiteLLM atua como tradutor universal e injeta as capacidades do Health de forma agnóstica em qualquer modelo fundacional.

PILAR 02 · RESILIÊNCIA

Webhooks assinados → filas

Ingestão via webhooks assinados para infraestrutura de filas. Picos de tráfego, falhas de conectividade ou indisponibilidades de LLMs não resultam em perda de contexto.

PILAR 03 · HITL

Human-in-the-Loop dogmático

O sistema é proibido de persistir alterações em dados clínicos sem gerar um artefato estruturado que exija confirmação explícita e inequívoca do utilizador.

PILAR 04 · GOVERNANÇA

LiteLLM centralizado

Monitorização de custos, prevenção de explosão de contexto e aplicação de rate limits — mitigando falhas em cascata em ecossistemas de agentes autónomos.

BCHAT × HEALTH Avaliação Comparativa · 04
Tecnologias e Abordagens

Seleção tecnológica criteriosa

Tecnologia / AbordagemProblema que resolveEnquadramentoOnde NÃO usarMaturidade
REST / WebhooksEventos em tempo real dos canaisIngestão Bchat→orquestrador; respostas processadasLógica demorada ou IA síncronaALTA
MCPPadronização de tools/recursos/promptsExposição do Health; tradução via LiteLLMVazão puramente determinística sem IAMÉDIA
Function CallingMapeamento NL→código estruturadoRoteado pelo LiteLLM; não exposto ao HealthPortabilidade frequente entre provedoresALTA
Skills / WorkflowsAgrupamento de ações sequenciaisFluxos transacionais no orquestrador (OCR)Chit-chat genéricoMÉDIA-ALTA
Single AgentRoteamento cognitivo centralizadoOrquestrador MVP; classifica intençõesDezenas de ferramentas (alucinação)MÉDIA
MultiagenteEspecialização de domíniosRoteamento avançado (Fase 3)Baixa complexidade determinísticaALTA
A2ANegociação entre entidades de IATroca de contexto Bchat↔auditoria HealthSistema fechado de decisão únicaEMERGENTE
State MachinesSobrevivência a reinícios (Temporal/DBOS)Medicação multi-dias sem processo em memóriaTarefas de milissegundosMÉDIA
BullMQ + Event BusProcessamento assíncrono profundoOrquestração de webhooks, OCR, enviosResposta sub-milissegundoALTA
RAG MédicoGeração ancorada em literaturaDúvidas sobre medicamentos/procedimentosAconselhamento diagnóstico diretoMÉDIA-ALTA
BCHAT × HEALTH Protocolo MCP · 05
MCP · Além do Function Calling

O Health como Servidor MCP

O protocolo abrange clientes, servidores, tools, resources e prompts — delegando o controlo do contexto de volta ao domínio clínico.

TOOLS

Ações transacionais

Inserir um medicamento ou agendar horário via ferramentas bem tipadas e auditáveis.

RESOURCES

Leitura proativa

Histórico consolidado de exames exposto via URIs padronizadas que o LLM lê proativamente.

PROMPTS

Controlo de tom

O Health instrui o orquestrador sobre limites clínicos e tom da conversa atual.

BCHAT × HEALTH Núcleo de IA · 06
O Papel Multifacetado do LiteLLM

Três vertentes vitais de governança

GATEWAY 01

LLM Gateway

Fallbacks transparentes para OpenAI/Anthropic→Ollama local; auditoria de custos contínua.

LITELLM

Tradutor Universal

Consome a especificação MCP e auto-regista tools como function calling compatível OpenAI.

GATEWAY 03

A2A Gateway

Barramento inteligente que padroniza comunicação entre agentes do futuro multiagente.

Risco crítico: gestão inadequada da janela de contexto → falhas em cascata silenciosas disfarçadas de erro de ferramenta MCP.

BCHAT × HEALTH Evolução · 07
Roadmap Arquitetural

Fases de maturidade

FASE 1 · MVP

Single Agent

Orquestrador único + BullMQ + MCP. Escopo delimitado, contexto simples.

FASE 2 · ESCALA

Skills + RAG

Workflows reutilizáveis e RAG médico para respostas seguras ancoradas.

FASE 3 · DOMÍNIO

Multiagente

Agente Clínico, Agendador e Triagem especializados; redução de alucinações.

FASE 4 · RESILIÊNCIA

State Machines

Temporal/DBOS substituem crons frágeis; A2A para auditoria distribuída.

Síntese

Conversação fluida, clínica determinística

MCP para portabilidade, BullMQ para resiliência, LiteLLM para governança e Human-in-the-Loop para segurança — uma arquitetura pronta para o MVP e evolutiva até o multiagente.

Pronto para MVP Roadmap até Fase 4