Base de Conhecimento

A Base de Conhecimento é o componente central do seu Agente de IA do Quickchat. Ela serve de base para o Agente de IA entender sua empresa, seus produtos e seus serviços. Uma Base de Conhecimento bem estruturada e abrangente permite que seu Agente de IA lide com as dúvidas dos usuários de forma eficaz e forneça respostas precisas.

Este guia traz uma visão geral da Base de Conhecimento, estratégias para construí-la de forma eficaz e dicas para otimizar seu desempenho.

Fontes de dados

A barra de ferramentas no topo da página da Base de Conhecimento permite adicionar conhecimento de qualquer uma destas fontes:

Add Article

Artigos escritos manualmente. Título + corpo com texto formatado. Use esta opção quando quiser ter controle total sobre a redação exata: FAQs, políticas internas, especificações de produtos ou qualquer conteúdo que você normalmente colaria de um documento.

Dica

Mantenha cada artigo focado em um único tema. Artigos longos que abordam vários temas dificultam a recuperação de informações. Dividi-los permite que a IA forneça respostas mais claras.

Add Paragraph

Informações breves e específicas que não precisam de um artigo completo. Os parágrafos são agrupados, por exemplo, em uma pasta chamada “Single Paragraphs”, e tratados como pequenas unidades de conhecimento. Eles são úteis para frases de uma linha, como “O envio leva 3–5 dias úteis” ou “Aceitamos devoluções em até 30 dias”.

Add Website

Importe conteúdo de qualquer URL. Há quatro modos de importação:

• Página Individual: importa uma página da web. Use Opções avançadas → Seletor HTML para restringir a importação a uma parte específica da página, por exemplo, main, #article-body ou .docs-content, quando o restante da página contém navegação, anúncios ou rodapé.
• Múltiplas Páginas: cole uma lista de URLs. Cada uma se torna um artigo próprio.
• Mapa do Site: informe um sitemap.xml. Cada página do mapa do site é importada como um artigo separado. É a melhor opção para sites de documentação e blogs estruturados.
• Todas as Páginas: rastreia todo o site e importa todas as URLs acessíveis do domínio. Use esta opção para importar documentações completas ou blogs de empresas.

As URLs permanecem vinculadas à fonte, para que você possa mantê-las atualizadas automaticamente ou quando precisar. Consulte Manter os artigos de URL atualizados.

Atualização automática

Os artigos criados a partir de uma URL também podem extrair novamente o conteúdo uma vez por dia, para que a Base de Conhecimento acompanhe a página de origem sem intervenção manual.

Três coisas para saber antes de depender desse recurso:

• A configuração é por artigo, não para a conta inteira. Ative-a nos artigos que você quer manter sincronizados.
• Está disponível apenas nos planos pagos. No plano Free, use a atualização manual descrita acima.
• Editar manualmente o conteúdo de um artigo desativa o recurso nesse artigo. Isso é intencional: caso contrário, uma nova extração diária substituiria sua edição na manhã seguinte. Isso significa que uma página personalizada deixa de acompanhar a fonte até que você reative a opção.

Não é possível alterar o intervalo diário.

Upload File

Envie documentos (PDF, Word, PowerPoint, Excel/CSV) e outros formatos. As imagens digitalizadas são processadas por OCR. O texto é extraído e indexado automaticamente. Tamanho máximo do arquivo: 32 MB, ou 1 MB para arquivos de texto (p. ex., txt, md, csv, json). Se um arquivo de texto for maior, divida-o em partes menores e envie-as separadamente.

Shopify MCP

Conecte sua loja Shopify para que a IA responda perguntas com base no catálogo de produtos, nos detalhes dos produtos e nas políticas da loja em tempo real. Cole a URL da loja para configurar a conexão. Nos bastidores, isso configura uma Ação personalizada Shopify MCP. Você também pode gerenciá-la em Ações & MCPs. Consulte Ações personalizadas, incluindo a explicação de por que o status do pedido precisa de uma ação separada.

Artigos do Intercom

Importe em massa todos os artigos da Central de Ajuda do Intercom conectado. Primeiro, conecte o Intercom em Aplicativos externos → Intercom. Executar a importação novamente sincroniza artigos novos e atualizados.

YouTube

Cole uma URL do YouTube para importar a transcrição do vídeo como um artigo. Isso é útil para canais de tutoriais e guias de produtos que você não quer reescrever manualmente.

Manter os artigos de URL atualizados

Os artigos de URL permanecem vinculados à página de origem, para que você possa mantê-los atualizados sem importá-los novamente de forma manual. Há duas maneiras de fazer isso: Auto-refresh, executado automaticamente todos os dias, e atualização manual, acionada quando você precisar. Ambas substituem o conteúdo do artigo pela versão mais recente da página atual e depois retreinam seu Agente de IA automaticamente.

Auto-refresh

Ative o Auto-refresh para um artigo de URL e o Quickchat verificará novamente a página de origem uma vez por dia, atualizando o artigo automaticamente sempre que a fonte mudar. Assim, o conhecimento baseado em URLs permanece sincronizado sem trabalho manual.

Nota

A atualização automática de URL está disponível nos planos pagos.

Como ativar

• Um artigo: abra o artigo e acione o seletor Auto-refresh no painel de metadados à direita, ou use o seletor Auto-refresh do URL na linha do artigo na lista.
• No menu da linha: clique no menu ”…” de uma linha de artigo de URL e escolha Auto-refresh de URL.
• Em massa: selecione vários artigos de URL com as caixas de seleção e clique em Auto-refresh de URLs (N) na barra de seleção.

Enquanto o Auto-refresh estiver ativado, o artigo ficará sincronizado com a fonte e seu conteúdo será somente leitura, com o aviso “Este artigo está sincronizado com a sua origem. Desative o auto-refresh para o editar.” Para editar o texto, clique em Desativar e editar ou desative o Auto-refresh. Editar um artigo de URL desativa o Auto-refresh automaticamente, para que uma atualização posterior nunca substitua suas alterações.

O campo Última Atualização no painel de metadados mostra quando o artigo foi atualizado pela última vez a partir da fonte.

Se uma atualização falhar, a última versão salva permanece no ar e seu AI Agent continua usando-a. Consulte Se uma atualização de URL falhar para entender o status, o motivo e o comportamento das novas tentativas.

Atualização manual

Para obter o conteúdo mais recente agora mesmo, sem esperar pela verificação diária:

• Um artigo: abra-o e clique em Atualizar URL manualmente no painel de metadados, ou escolha Atualizar URL manualmente no menu ”…” da linha.
• Em massa: selecione artigos de URL e clique em Atualizar URLs manualmente (N), ou use Atualizar todas as URLs no canto superior direito para extrair novamente todos os artigos baseados em URL de uma só vez.

Uma atualização manual substitui suas alterações manuais pela página atual, por isso o Quickchat pede confirmação antes de substituir artigos que você editou. A atualização em massa abrange até 1.000 artigos de URL por vez.

Dicas para construir uma Base de Conhecimento eficaz

Cada artigo de texto, URL ou PDF enviado deve ser autônomo e abrangente, cobrindo o tema por completo. Uma Base de Conhecimento bem estruturada garante que o Agente de IA tenha o contexto necessário para responder de forma eficaz.

Leia as dicas abaixo para preparar seu Agente de IA para o sucesso:

Etapas para construir e refinar sua Base de Conhecimento

1. Defina claramente o objetivo
   Defina o papel do seu Agente de IA e os tipos de perguntas que ele responderá. Organize o conhecimento em categorias com base nas necessidades e nos fluxos dos usuários.

   Exemplo de Agente de IA para e-commerce:

   • Navegação e compras: detalhes de produtos, comparações e FAQs.
   • Compra: métodos de pagamento, códigos de desconto e impostos.
   • Entrega: envio, alterações de pedidos e rastreamento.

   Exemplo de Agente de IA para empréstimos estudantis:

   • Antes da solicitação: elegibilidade e condições do empréstimo.
   • Solicitação: guias, termos e instruções passo a passo.
   • Após a formatura: cronogramas de pagamento e adiamentos.

2. Garanta a qualidade dos dados
   A qualidade das respostas da IA depende dos dados enviados. Concentre-se em:

   • Legibilidade: remova informações irrelevantes, tabelas ou cabeçalhos redundantes do conteúdo enviado.
   • Relevância: garanta que o conteúdo responda às perguntas comuns e esteja alinhado às expectativas dos usuários.
   • Consistência: evite informações contraditórias ou desatualizadas e use formatação consistente, por exemplo, para datas e preços.
   • Conteúdo somente em texto: como imagens não são compatíveis, garanta que as informações essenciais sejam apresentadas em texto.

3. Priorize a clareza
   Garanta que cada artigo seja claro, conciso e fácil de acompanhar. Use estruturas lógicas de parágrafos e concentre-se nos detalhes relevantes.

4. Seja abrangente
   Forneça o máximo de detalhes possível para dar ao Agente de IA o conhecimento necessário para lidar com consultas complexas.

5. Use respostas em vez de Q&A
   Concentre-se em fornecer informações abrangentes em vez de pares específicos de perguntas e respostas. O Agente de IA pode extrair os detalhes relevantes conforme necessário.

6. Inclua URLs no texto
   Sempre inclua URLs no texto como referência. Mesmo quando você usa o importador de URLs, inserir links para produtos ou formulários no texto melhora a usabilidade.

   Exemplo:
   Para um Agente de IA de e-commerce, inclua links para formulários como o de cancelamento de pedidos:
   “Para cancelar um pedido, envie uma solicitação aqui: https://example.com/cancel-order.”

7. Teste bastante
   Os testes são essenciais para refinar sua Base de Conhecimento. Simule interações dos usuários para identificar lacunas ou inconsistências e ajuste o conteúdo de acordo.

Problemas comuns

• O Agente de IA ignora links ou não inclui URLs nas respostas
  Garanta que os links relevantes estejam inseridos no texto de cada artigo.
• Informações repetidas ou redundantes
  Evite enviar conteúdo duplicado em vários artigos.
• Faltam detalhes importantes nas respostas
  Considere criar artigos separados para detalhes específicos, como critérios ou casos especiais.
• Datas ou preços incorretos
  Verifique e atualize todos os artigos para manter a precisão.

Construir uma Base de Conhecimento eficaz é um processo iterativo. Comece com objetivos claros, organize o conteúdo de forma lógica e faça testes abrangentes para refinar o desempenho do seu Agente de IA.

Nota

Se precisar de ajuda para configurar sua Base de Conhecimento ou de integrações personalizadas, escreva para contact@quickchat.ai.

Busca

O recurso de busca permite encontrar rapidamente artigos específicos na Base de Conhecimento pesquisando tanto nos títulos quanto no conteúdo.

Como usar a busca

1. Digite palavras-chave ou frases na barra Pesquisar tudo… no topo da interface de gerenciamento da Base de Conhecimento.
2. Os resultados são atualizados imediatamente para mostrar os artigos que contêm o texto digitado no título ou no conteúdo.

Seleção múltipla e exclusão em massa

Os recursos de seleção múltipla e exclusão em massa facilitam o gerenciamento de vários artigos da Base de Conhecimento.

Como usar a seleção múltipla

1. Acesse a lista da Base de Conhecimento.
2. Clique no sinal ”…” ao lado do artigo que você deseja selecionar e clique em Selecionar.
3. Marque as caixas à esquerda dos artigos que você deseja selecionar. É possível selecionar um ou vários artigos ao mesmo tempo.
4. Depois de selecionados, os artigos permanecem destacados para outras ações.

Como realizar a exclusão em massa

1. Depois de selecionar os artigos, clique em Excluir na parte inferior para removê-los.
2. Confirme a ação para excluir permanentemente todos os artigos selecionados.

Tags

As tags ajudam a organizar a Base de Conhecimento e permitem que o Agente de IA restrinja quais artigos consultar para cada pergunta. Você verá as tags na linha de cada artigo e como filtro no topo da lista.

Há duas formas de adicionar tags a um artigo:

• Manualmente: abra um artigo e use + Adicionar Tag no painel de metadados à direita.
• Marcar com AI: clique em Marcar com AI no mesmo painel. O Quickchat lê o artigo e sugere tags com base no conteúdo. Isso é útil para conteúdo importado em massa, como Mapa do Site, Todas as Páginas ou Intercom, quando adicionar tags manualmente a centenas de artigos não é viável.

Use o filtro Tags na barra de ferramentas para restringir a lista aos artigos que correspondem a uma ou mais tags.

Como suas alterações entram no ar

Não existe etapa de retreinamento nem botão para apertar. Toda alteração na Base de Conhecimento é processada automaticamente em segundo plano, um artigo por vez. Somente os artigos que você alterou são reprocessados, por isso o restante da Base de Conhecimento continua respondendo perguntas o tempo todo.

Isso se aplica a todas as formas de alterar o conteúdo: adicionar ou editar um artigo, excluir um artigo, importar um site ou arquivo, atualizar uma URL manualmente e usar a atualização automática diária.

Status do artigo

Cada linha da lista da Base de Conhecimento tem uma coluna Status:

Status	O que significa
Pendente	Na fila, aguardando processamento.
Processando	Sendo processado neste momento.
Pronto	No ar. Seu Agente de IA está usando este artigo.
Falhou	O processamento não foi concluído. Consulte Se um artigo falhar.
Falha na atualização	Seu AI Agent continua usando a última versão salva.

Os status são atualizados automaticamente. Você não precisa recarregar a página.

Enquanto houver algo em andamento, o topo do aplicativo mostrará “N artigos ainda em processamento”. A mensagem desaparecerá assim que tudo terminar. A maioria dos artigos fica Pronto em segundos. Importações grandes demoram mais porque os artigos são processados em lotes.

Quando um artigo está no ar

Assim que um artigo aparece como Pronto, ele está no ar em todos os lugares ao mesmo tempo: no widget publicado, em todos os canais conectados, na API e na Prévia da IA. Não há etapa separada de publicação ou implantação nem uma cópia de rascunho da Base de Conhecimento entre você e o Agente.

Cuidado

Como nada fica em preparação, uma edição chega ao seu Agente de IA no ar assim que o processamento termina. Se o Agente estiver em produção, revise o conteúdo do artigo antes de salvar e execute novamente um dataset de simulação depois para confirmar que a mudança não causou uma regressão.

Se uma atualização de URL falhar

Um artigo de URL com Falha na atualização continua no ar com a última versão salva pelo Quickchat. Passe o cursor sobre o status para ver por que a fonte não pôde ser atualizada, por exemplo, por causa de uma página indisponível, exigência de login, redirecionamento para outro site ou conteúdo ilegível.

O Quickchat repete as tentativas após falhas temporárias. Se a fonte continuar falhando ao longo de 14 dias de tentativas de atualização, as verificações automáticas serão interrompidas para evitar buscar repetidamente uma página permanentemente indisponível. Depois de corrigir a fonte, selecione Atualizar URL manualmente. Uma atualização bem-sucedida elimina a falha e retoma as verificações automáticas. Você também pode selecionar Auto-refresh de URL novamente para reiniciar a janela de novas tentativas.

Se um artigo falhar

Um artigo com o status Falhou simplesmente não é usado pelo seu Agente de IA. O restante da Base de Conhecimento não é afetado, e o Agente continua respondendo com tudo o que está Pronto.

A maioria das falhas é temporária, e o Quickchat tenta novamente por você automaticamente, então elas costumam se resolver sozinhas. Se não quiser esperar, clique em Tentar novamente ao lado da mensagem “N com erro” no topo do aplicativo para reprocessar imediatamente todos os artigos com falha.

Se um artigo continuar falhando, o problema costuma estar no conteúdo de origem: uma página vazia, um arquivo sem texto extraível ou uma URL que não funciona mais. Abra o artigo para conferir o que foi importado ou importe-o novamente a partir de uma fonte que funcione. Se ainda assim falhar, escreva para contact@quickchat.ai.

Todo o resto tem efeito imediato

Somente o conteúdo da Base de Conhecimento passa por processamento. As configurações de Identity, AI Personality, Languages, Actions, respostas na Inbox, Insights e Conversation Rating entram em vigor no momento em que você as salva.