Ecossistema híbrido para automação de vendas e suporte

A maioria dos widgets de chat prontos no mercado funcionam como simples autoatendentes com regras rígidas ou exigem configuração manual complexa de cenários para cada versão linguística do site. Além disso, os operadores muitas vezes não veem o que o cliente escreve em tempo real, e os modelos de IA podem travar ou apresentar erros durante picos de carga.

A equipe da AI-Robot Studio desenvolveu o AI-Robot Chat — uma plataforma corporativa de consultoria por IA tolerante a falhas. Trata-se de um complexo de software totalmente pronto com arquitetura aberta, que é implantado em seus servidores, garante total independência de serviços de assinatura de terceiros e assegura resposta instantânea da interface.

Arquitetura técnica e "entranhas" do sistema AI-Robot Chat

1. Ponte de conteúdo dinâmico (Dynamic Decoupled Knowledge Base)

A principal característica arquitetônica do AI-Robot Chat é a separação completa do conhecimento do bot do código do backend. O bot funciona como uma "casca vazia", enquanto todo o conhecimento sobre seus serviços, preços e regras é carregado dinamicamente a partir de arquivos JSON externos (por exemplo, ru.json, es.json) de um servidor remoto.

  • No início e sob solicitação, o serviço kb_service.py baixa os arquivos de conhecimento, limpa-os de tags HTML e converte os blocos estruturados em um contexto de texto plano.
  • O sistema pega um modelo de instrução (System Prompt), insere dinamicamente os conhecimentos limpos no marcador de contexto e adiciona uma indicação estrita do idioma de comunicação no final, evitando confusão em diálogos multilíngues.

2. Frontend rápido e adaptável (Svelte 5 Chat Widget)

A interface do chat foi desenvolvida com o framework Svelte 5, garantindo um tamanho mínimo de bundle e operação instantânea do widget sem retardar o carregamento do seu site principal.

  • Detecção automática de idioma: O widget lê o atributo lang da tag html. Se no seu site (React/Svelte SPA) o idioma mudar sem recarregar a página, o MutationObserver integrado detecta isso instantaneamente, limpa a janela do chat e solicita uma saudação no novo idioma.
  • Conexão híbrida: A REST API é usada para carregar rapidamente o histórico de mensagens e configurações, enquanto os WebSockets assíncronos garantem troca bidirecional instantânea de mensagens e exibição do status «Digitando...» em tempo real.
  • Rich Content: O chat suporta renderização de Markdown (listas, negrito/itálico), exibição de capturas de tela anexadas e upload de arquivos.

3. Núcleo assíncrono de alto desempenho (FastAPI)

A parte do servidor do AI-Robot Chat é construída com FastAPI em Python. Para trabalhar com bancos de dados (Firebase) e planilhas (Google Sheets), utilizamos distribuição assíncrona de threads através do asyncio.to_thread. Enquanto um thread aguarda o registro de logs ou envio de dados para o Google Sheets, o núcleo principal do FastAPI continua atendendo instantaneamente centenas de conexões WebSocket ativas de outros usuários sem atrasos.

Um gerenciador de conexões especial (ws_manager.py) monitora o status dos usuários em tempo real. Se o cliente abrir uma aba do site, o operador vê um indicador verde de presença; se fechar, o indicador se apaga instantaneamente, economizando tempo do gerente.

4. Mecanismo de IA tolerante a falhas: arquitetura «Cascata» (Waterfall AI Engine)

O cérebro do sistema (módulo ai_service.py) é protegido contra falhas dos provedores de IA. Implementamos um modelo de requisições em cascata: se o modelo prioritário (por exemplo, OpenAI) apresentar erro ou não responder em 20 segundos, o bot redireciona automaticamente a solicitação para o Gemini e, em caso de nova falha, para o xAI ou Mistral. O cliente recebe uma resposta ininterrupta, mesmo que um dos serviços de IA esteja globalmente indisponível.

5. Geração inteligente de leads (Function Calling)

A IA não apenas simula uma conversa. Com a tecnologia Function Calling, o bot reconhece semanticamente quando o usuário deixa seus dados de contato (telefone, email, apelido em mensageiro). Nesse momento, o sistema chama instantaneamente a função técnica save_lead, captura os contatos e envia uma notificação instantânea no Telegram para o proprietário do negócio.

6. Painel profissional do operador (NiceGUI & AG Grid)

A interface para gerentes foi desenvolvida com base no NiceGUI e oferece um espaço de trabalho completo:

  • Interceptação instantânea (Human Mode): O gerente visualiza o diálogo do cliente com a IA em tempo real e pode, com um clique, assumir o controle do robô, colocando o chat em modo manual. Indicadores de atividade mostram se algum colega gerente também está visualizando esse chat, evitando confusão.
  • Painel de análise: Exibição de KPIs-chave do negócio em tempo real (quantidade de sessões únicas, diálogos ativos, conversão em leads).
  • Gerenciamento inteligente de banco de dados via AG Grid: A tabela permite filtrar milhares de sessões por países, tags UTM, datas de visitas, páginas de entrada e arquivá-las ou excluí-las em massa. A tabela memoriza as configurações de colunas individualmente para cada gerente.

Principais vantagens do AI-Robot Chat para o seu negócio

  • Autonomia total da base de conhecimento: O bot é treinado com seus arquivos JSON, não exigindo reprogramação ao alterar listas de preços ou condições de serviço.
  • Velocidade máxima de resposta: A arquitetura assíncrona do backend e os WebSockets eliminam qualquer atraso na entrega de mensagens.
  • Transparência absoluta: Você acompanha todo o caminho do cliente — desde a tag UTM da campanha publicitária, endereço IP e cidade até a página onde o usuário abriu o chat.

AI-Robot Chat é uma ferramenta pronta para alta demanda de nível corporativo, que automatiza até 90% do atendimento ao cliente e transforma visitantes do seu site em leads prontos para compra. Entre em contato com os especialistas da AI-Robot Studio para discutir a implementação do AI-Robot Chat no seu site ou a customização da plataforma para seus processos de negócio.