Operação do Hub
Visão geral operacional do Simplafy Hub — a plataforma no-code de construção e orquestração de agentes baseada em LangGraph, com módulos, personas e primeiros passos.
Operação do Hub
O Simplafy Hub é a plataforma central no-code para construção, deploy e operação de agentes de IA. Esta página descreve o produto em alto nível, os públicos atendidos, os módulos disponíveis e o caminho recomendado para entrar em operação.
Para integração programática via REST, consulte a referência de API do Hub. Para detalhes de arquitetura, ver o repositório Simplafy-tec/simplafy-hub.
O que é o Hub
O Hub é uma plataforma multi-tenant para criar, configurar e operar agentes conversacionais sem código. Internamente é um monorepo Turborepo composto por:
- Admin web (
apps/web) — console de configuração de agentes, organizações, credenciais e integrações. - API gateway (
apps/api) — gateway REST autenticado por JWT, com Swagger em/docse contrato versionado em/api/v1. - Portal do cliente (
apps/client-portal) — portal white-label consumido pelos usuários finais da organização. - MCP server (
apps/mcp-server) — servidor Model Context Protocol que expõe ferramentas (tools) consumidas pelos agentes. - LangGraph server (
apps/langgraph-server) — runtime Python dos agentes, com consumer WhatsApp e tracing via Langfuse. - RAG server (
apps/rag-server) — serviço de retrieval baseado em LangConnect, FastAPI e pgvector.
A combinação desses serviços entrega um produto único: o cliente cria um agente no admin, conecta credenciais e ferramentas, e o agente passa a operar nos canais configurados (WhatsApp, portal, integrações externas).
A base canônica da API em produção é https://hub.simplafy.com.br/api/v1. O Swagger UI fica em https://hub.simplafy.com.br/docs.
Para quem é
O Hub atende três perfis principais dentro de cada organização cliente:
- Operadores de negócio — configuram agentes, prompts, ferramentas e fluxos de atendimento sem escrever código, usando o admin web.
- Times técnicos e integradores — consomem a API REST do Hub para integrar sistemas internos, automatizar onboarding e construir dashboards. Toda a superfície técnica está documentada via OpenAPI.
- Usuários finais — interagem com os agentes através do portal white-label ou de canais como WhatsApp, sem precisar conhecer a infraestrutura por trás.
A plataforma é multi-tenant por design: cada organização tem isolamento de dados, credenciais e configuração de módulos via OrgPortalConfig.
Módulos principais
Os módulos abaixo cobrem as áreas funcionais expostas pelo Hub. Cada um possui referência detalhada na documentação.
Agentes
Criação, configuração e deploy de agentes LangGraph com prompts versionados em Langfuse, ferramentas MCP e políticas de guardrails.
Conversas e Inbox
Store canônico de mensagens, adapters por canal (Evolution, WhatsApp), visão de thread e filtros de inbox.
CRM e Identidade
Identity foundation para leads e contatos, resolução por telefone/JID/LID e merge runtime entre canais.
Credenciais e Integrações
Cofre de credenciais por organização, CredentialSet por agente e integrações dinâmicas via OpenAPI e GraphQL.
MCP Tools
Ferramentas expostas via Model Context Protocol, com transporte stdio e HTTP, e contexto por organização/agente/deployment.
RAG
Indexação e recuperação de documentos via LangConnect e pgvector, consumida pelos agentes em tempo de execução.
Primeiros passos
O fluxo recomendado para colocar uma organização em operação no Hub é:
Provisionar a organização
Crie a organização no admin web e configure o OrgPortalConfig com os módulos habilitados (enabledModules), branding e blocos do dashboard. O isolamento multi-tenant é aplicado a partir desse registro.
Cadastrar credenciais
No cofre de credenciais, registre as chaves necessárias para os provedores integrados (LLMs, canais, sistemas externos). Os tipos suportados seguem o enum CredentialType:
API_KEY
OAUTH_TOKEN
BEARER_TOKEN
CUSTOMCredenciais são únicas por (organizationId, key) e podem ser sobrescritas por agente via AgentCredentialOverride ou agrupadas em CredentialSet.
Criar o agente
Configure um agente no admin, definindo prompt (versionado em Langfuse), ferramentas MCP habilitadas, modelo LLM e parâmetros de guardrails. O agente herda automaticamente o contexto de organização via metadata._x_oap_org_id.
Conectar canais
Habilite os canais de entrada do agente (WhatsApp via Evolution, portal white-label, integrações externas). Cada canal usa um adapter pure-function que normaliza o payload para o store canônico de mensagens.
Integrar via API
Para automações server-to-server, consuma o gateway REST em https://hub.simplafy.com.br/api/v1 usando JWT. Exemplo de chamada autenticada:
curl -H "Authorization: Bearer <access_token>" \
https://hub.simplafy.com.br/api/v1/agentsA referência completa fica em Swagger UI e na seção API do Hub.
Tokens de acesso têm validade curta (15 minutos). Use o fluxo de refresh (7 dias, com rotação e detecção de reuso) para manter sessões longas. Detalhes em Autenticação.