Knowledge-Base

Resumo

Base de conhecimento dupla: (a) KB interna do tenant (wiki, manuais, documentação, treinamento) e (b) Help Center público white-label que o cliente final publica no próprio site/domínio com a sua marca. RAG nativo, busca semântica, Q&A com IA, multi-fonte (URLs, sitemaps, ZIP, Git, Notion, Confluence), grafo de conhecimento, extração de skills, versionamento, colaboração e bridge cross-plugin para Inbox, Chatbot e Copilot consumirem sem duplicar conteúdo.

Dois modos de uso

Modo 1 — Interno da plataforma

KB privada do tenant/workspace: manuais internos, wiki, playbooks, onboarding, documentação de produto. Consumida pelos agentes do Inbox, pelo Chatbot e pelo Copilot via bridge.php — sem duplicação de conteúdo.

Modo 2 — Help Center público do cliente final (white-label)

O usuário final publica sua própria central de ajuda em URL pública com a marca dele. Views help-center.php e help-article.php renderizam a central. Editor visual em help-center-editor. Categorias, artigos, busca semântica, avaliação ("este artigo foi útil?"), analytics e permissões por audiência. Ideal para SaaS, e-commerce e serviços que precisam de central de ajuda profissional sem depender de Zendesk/Intercom.

Para quem é

• SaaS e e-commerces que publicam central de ajuda white-label aos clientes.
• Times internos que mantêm wiki, manuais e onboarding.
• Suporte e atendimento que alimentam o Inbox e o Chatbot com respostas.
• Consultorias e agências que gerenciam bases por cliente com isolamento.

O que você pode fazer

Bases, Documentos e Categorias

• Aba bases: múltiplas bases por tenant/workspace.
• Aba documents: upload e gestão de arquivos.
• Aba categories: hierarquia navegável.

RAG, Busca Semântica e Q&A

• Aba ask + RAGService: Q&A sobre a base.
• ChunkingService + aba chunking: configuração de fragmentação.
• Busca semântica em todos os documentos.

Multi-Fonte

• Aba sources + MultiSourceService: URLs, sitemaps, ZIPs, Git, Notion, Confluence, bancos de arquivos. Sincronização incremental.

Grafo e Entidades

• Aba graph + KnowledgeGraphService: grafo navegável.
• Aba entities: entidades nomeadas extraídas.
• Aba skills + SkillExtractionService: competências identificadas.

Help Center Público (white-label)

• Views help-center.php e help-article.php.
• Aba help-center-editor: editor visual com rascunho, preview, publicação agendada.
• Domínio próprio, marca do cliente, categorias, busca, avaliação de artigo.

Versionamento, Colaboração e Analytics

• Aba versions + VersioningService: histórico por documento.
• Aba collaboration + CollaborationService: comentários e anotações.
• Aba analytics: consultas, deflection, artigos mais úteis.
• Aba history: trilha de auditoria.

Import / Export

• Aba import-export + ImportExportService: migração de Zendesk, Intercom, arquivos ZIP, Markdown, HTML.

Bridge Cross-Plugin

• bridge.php: Inbox sugere artigos ao agente, Chatbot responde por RAG, Copilot consulta sem duplicar conteúdo.

Como começar

1. Ative o plugin Knowledge-Base.
2. Crie sua primeira base em bases.
3. Faça upload de documentos ou conecte fontes em sources.
4. Configure chunking em chunking se necessário.
5. Teste Q&A em ask.
6. Para Help Center público: abra help-center-editor, escolha marca/domínio, categorize e publique.

Tutoriais

• Publicar Help Center white-label em domínio próprio — marca, categorias, SEO.
• Ingerir sitemap e manter sincronização — multi-source incremental.
• Ativar Q&A no Inbox — bridge com sugestão ao agente.
• Versionamento e reversão de artigo — versions.
• Migrar do Zendesk para o P8W — import.

Integrações com outros plugins

• Inbox — sugere artigos ao agente via bridge.
• Chatbot — responde com RAG.
• AI-Agents / Copilot — consulta docs sem duplicar.
• Search — busca unificada cross-plugin.
• Workspace — base por workspace/squad.
• Insights — analytics de deflection e consultas sem resposta.

Perguntas frequentes

Posso publicar uma central de ajuda para meus clientes? Sim. O Help Center é público por padrão, com editor visual, categorias, busca e avaliação de artigos. Funciona em domínio próprio e com sua identidade visual.

Outros plugins usam a base de conhecimento? Sim. Via bridge interno (bridge.php), Inbox sugere artigos a agentes, Chatbot responde usando RAG e o Copilot consulta documentação sem duplicar conteúdo.

Como funciona o RAG? Documentos são fragmentados (ChunkingService), indexados e consultados por similaridade semântica. O RAGService monta contexto e gera resposta citando fonte.

Quais fontes externas posso conectar? URLs, sitemaps, ZIPs, repositórios Git, Notion, Confluence e bancos de arquivos. Sincronização incremental via MultiSourceService.

Posso ter múltiplas bases no mesmo tenant? Sim. Aba bases suporta N bases (p.ex. base pública, base interna, base por produto).

Como funciona a avaliação do artigo? Cada artigo do Help Center tem "este artigo foi útil?". O score alimenta analytics e identifica artigos que precisam ser reescritos.

Há versionamento? Sim. VersioningService registra cada alteração com autor e timestamp; é possível reverter.

O Help Center suporta domínio próprio? Sim, com isolamento multi-tenant e personalização de marca.

Glossário

• RAG — Retrieval-Augmented Generation, geração com contexto recuperado.
• Chunking — fragmentação de documentos para indexação.
• Deflection Rate — % de visitantes que encontram resposta sem abrir ticket.
• Bridge — ponte interna entre plugins para consumir dados sem duplicar.
• White-label — produto publicado com a marca do cliente final.

Limitações e avisos

• Tradução automática, reescrita de artigos por IA e widget in-app estão no roadmap.
• Domínio próprio exige configuração de DNS pelo cliente final.

Relacionados

• Inbox
• Intelligence
• AI-Agents