AssistentIA — White Paper (v1.0)
Visão Geral
AssistentIA é uma plataforma de chatbot corporativo orientado a conhecimento que permite responder perguntas com base no conteúdo da organização (páginas, documentos e FAQs), preservando isolamento multi‑tenant, governança de fontes, registro de conversas e webhooks para integrações.
> Este white paper é público e descreve o que o produto faz e como é estruturado em alto nível.
Problema que resolvemos
Empresas possuem muito conteúdo disperso (site, PDFs, manuais, políticas). Isso cria:
- tempo alto de atendimento,
- respostas inconsistentes,
- desperdício em perguntas repetitivas,
- dificuldade para manter conteúdo atualizado.
Proposta de valor
AssistentIA:
- consolida e organiza o conteúdo oficial;
- responde em linguagem natural com citações de origem onde aplicável;
- dá controle ao time para governar as fontes (ativar/pausar/reindexar);
- registra conversas e métricas de uso;
- oferece ganchos de integração (webhooks) para fluxos externos;
- suporta escalonamento humano (handoff) quando necessário.
Casos de uso
- FAQ e suporte 24/7 (site, help center, portal do cliente)
- Pré‑vendas e qualificação (captação de leads)
- Onboarding/educação (orientações padronizadas)
- Interno: conhecimento de time/operacional
---
Arquitetura de alto nível (descrição)
> A camada de persistência relacional registra tenants, fontes de conhecimento, conversas, mensagens, webhooks e uso. A camada vetorial indexa o conteúdo para recuperação semântica. O módulo de ingestão mantém as fontes sincronizadas. O motor de resposta combina busca semântica e política de negócio, com possibilidade de handoff humano.
Componentes principais (alto nível):
1. Multi‑tenant (chaves públicas/secretas; allowed origins por tenant).
2. Ingestão de Conteúdo (URLs/FAQ/arquivos) com deduplicação e atualização incremental.
3. Índice Vetorial do conhecimento (recuperação semântica).
4. Chat Runtime com registro de conversas/mensagens.
5. Handoff para agente humano quando regras de negócio/baixa confiança exigem.
6. Webhooks de eventos para integrações leves.
7. Métricas/Quota (uso diário por tenant).
---
Segurança e isolamento
- Isolamento por tenant: cada cliente possui escopos próprios de fontes e conversas.
- Chaves públicas e secretas por tenant para autenticação das integrações.
- Allowed Origins por tenant para restringir domínios do widget.
- Rate limit e camadas de proteção no edge.
- Registro de auditoria essencial (conversas, fontes, alterações).
---
Governança de conhecimento
- Fontes podem ser cadastradas, pausadas, reindexadas ou removidas.
- Reindexações são idempotentes (evitam duplicação).
- Remoção de conteúdo obsoleto durante sincronização.
- Idiomas: armazenamento com metadados de
lang.
---
Integrações
- Widget Web (script único com
data-tenant). - API de Chat (uso interno do widget e integrações autorizadas).
- Webhooks: eventos de conversa/uso/handoff.
- Pagamentos: sessão de pagamento e status (quando aplicável ao plano).
---
Observabilidade e métricas
- Uso diário por tenant (mensagens, tokens/custos estimados).
- Contagem de mensagens por conversa.
- Filas de handoff com status e responsável (quando usado).
---
SLA e limites (público)
- Disponibilidade: orientado a melhor esforço (SLA formal sob contratos business).
- Limites padrão: quotas de mensagens/tokens por tenant com possibilidade de ampliação sob contrato.
- Privacidade: dados do cliente permanecem sob o tenant; integrações seguem políticas acordadas.
---
Roadmap público (resumo)
- V1 (este documento): White paper + especificação pública; ingestão estável; métricas e webhooks básicos.
- V1.1: Consolidação de guias de integração pública e FAQ técnico.
- V1.2: Painéis ampliados de auditoria e tuning não‑intrusivo.
- V2: Opções avançadas (apoio a mais canais, políticas de resposta por persona, conectores adicionais).
---
Limitações conhecidas (transparência)
- Nem todo problema é resolvido por chatbot; dúvidas novas/complexas podem exigir handoff.
- Aprendizado contínuo supervisionado não é automático; requer curadoria.
- Este white paper não constitui contrato; detalhes operacionais ficam em documentos privados e acordos comerciais.
---
Conclusão
AssistentIA entrega um chatbot de base de conhecimento com arquitetura moderna,
pronto para empresas que desejam velocidade com governança. O ecossistema apoia escala e integrações, sem abrir mão do isolamento por cliente.