Base de Conhecimento

A Base de Conhecimento é o núcleo do seu Agente de IA do Quickchat. Ela fornece o contexto necessário para respostas precisas.

Este guia traz uma visão geral, estratégias de construção e dicas de otimização.

Fontes de dados

Você pode adicionar conhecimento nos formatos:

• Artigos de texto
  Conteúdo manual para adições rápidas.

  Dica

  Cubra um único tema por artigo e mantenha abaixo de 4.000 caracteres.

• URLs
  Importe páginas completas, resumos por IA ou múltiplas páginas.
  Cada URL vira um artigo.

  Opções:

  • Página única / URL individual (com IA)
  • Múltiplas páginas
  • Sitemap (sitemap.xml)
  • Todas as páginas / Site inteiro

• Arquivos
  Envie documentos (PDF, Word, PowerPoint, Excel/CSV) e mais (máx. 32 MB); imagens digitalizadas são processadas por OCR. O conteúdo é extraído e indexado automaticamente.

Atualização automática

Os artigos vindos de URL também podem se atualizar sozinhos uma vez por dia, para que a Base de Conhecimento acompanhe a página de origem sem que ninguém precise mexer nela.

Três coisas para saber antes de depender disso:

• É por artigo, não para a conta inteira. Ative a opção nos artigos que você quer manter sincronizados.
• Está disponível apenas nos planos pagos. No plano Free, atualize os artigos manualmente.
• Editar o conteúdo de um artigo à mão desativa a atualização naquele artigo. Isso é intencional, já que uma nova coleta diária sobrescreveria a sua edição na manhã seguinte, mas significa que uma página que você personalizou deixa de acompanhar a origem até você reativar a opção.

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

Manter os artigos de URL atualizados

Os artigos de URL permanecem ligados à respetiva página de origem, para que os possa manter atualizados sem voltar a importá-los manualmente. Existem duas formas de o fazer: Auto-refresh, que é executado automaticamente todos os dias, e atualização manual, que aciona quando precisar. Ambas substituem o conteúdo do artigo pela versão mais recente da página atual e, em seguida, treinam novamente o seu Agente de IA automaticamente.

Auto-refresh

Ative o Auto-refresh para um artigo de URL e o Quickchat verifica novamente a respetiva página de origem uma vez por dia, atualizando o artigo automaticamente sempre que a origem é alterada. Assim, o conhecimento baseado em URL mantém-se sincronizado sem qualquer 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 do lado direito, ou utilize o seletor Auto-refresh do URL na linha do artigo na lista.
• A partir do menu da linha: clique no menu ”…” numa 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 ferramentas de seleção.

Enquanto o Auto-refresh estiver ativado, o artigo é mantido em sincronia com a sua origem e o respetivo conteúdo torna-se apenas de leitura, com o banner “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, pelo que uma atualização posterior nunca substitui as suas alterações.

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

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 utilize Atualizar todas as URLs no canto superior direito para obter novamente todos os artigos baseados em URL de uma só vez.

Uma atualização manual substitui as suas alterações manuais pela página atual, pelo que o Quickchat lhe pede para confirmar antes de substituir artigos que tenha editado. A atualização em massa abrange até 1000 artigos de URL de cada vez.

Dicas para uma base eficaz

Cada artigo/URL/arquivo deve ser autônomo e completo.

Passos recomendados:

Etapas para construir e refinar

1. Defina o objetivo
   Mapeie o papel do Agente e as perguntas a responder. Organize por necessidades do usuário.

   Exemplo e‑commerce:

   • Navegação & Compra: detalhes, comparativos, FAQ
   • Compra: pagamentos, cupons, impostos
   • Entrega: envio, alterações, rastreio

   Exemplo empréstimos estudantis:

   • Antes de solicitar
   • Solicitação
   • Após formar

2. Garanta qualidade

   • Legibilidade
   • Relevância
   • Consistência
   • Somente texto

3. Priorize clareza

4. Seja detalhado

5. Prefira respostas completas a Q&A

6. Inclua URLs no texto
   Ex.:
   “Para cancelar, acesse: https://example.com/cancel-order.”

7. Teste bastante

Problemas comuns

• IA ignora links: certifique‑se de incluí‑los no texto.
• Informação duplicada
• Faltam detalhes
• Datas/preços incorretos

Construir é iterativo. Objetivos claros, estrutura lógica e testes constantes.

Nota

Precisa de ajuda ou integrações sob medida? contact@quickchat.ai.

Busca

A Busca encontra artigos por título e conteúdo.

Como usar

1. Digite na barra Search no topo
2. Resultados aparecem imediatamente

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

Gerencie vários artigos de uma vez.

Seleção múltipla

1. Abra a lista
2. Clique em “…” → Select
3. Marque os artigos desejados
4. Permanecem destacados

Exclusão em massa

1. Clique em Delete
2. Confirme a exclusão permanente

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ê vê 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 o artigo e use + Add Tag no painel de metadados à direita.
• Auto-tag with AI — clique em Auto-tag with AI no mesmo painel. O Quickchat lê o artigo e sugere tags com base no conteúdo dele. Útil para conteúdo importado em massa (Sitemap, All Pages, Intercom), em que marcar centenas de artigos à mão 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 re‑treino nem botão para apertar. Toda alteração na Base de Conhecimento é processada automaticamente em segundo plano, um artigo por vez — e só os artigos que você realmente mexeu são reprocessados, então o restante da sua Base de Conhecimento continua respondendo perguntas o tempo todo.

Isso vale para todas as formas de alterar conteúdo: adicionar ou editar um artigo, excluir um artigo, importar um site ou um arquivo, atualizar uma URL manualmente e 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
Pending	Na fila, aguardando processamento.
Processing	Sendo processado neste momento.
Ready	No ar. Seu Agente de IA está usando este artigo.
Failed	O processamento não foi concluído. Veja abaixo.

Os status se atualizam sozinhos — você não precisa recarregar a página.

Enquanto houver algo em andamento, o topo do app mostra “N articles still processing”. A mensagem some assim que tudo termina. A maioria dos artigos fica Ready 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 Ready, ele está no ar em todos os lugares ao mesmo tempo: no seu widget publicado, em cada canal conectado, na API e no AI Preview. Não há etapa separada de publicação ou implantação, nem uma cópia de rascunho da sua Base de Conhecimento entre você e o seu 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 seu Agente está 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 um artigo falhar

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

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 Retry ao lado da mensagem “N failed to process” no topo do app para reprocessar imediatamente todos os artigos com falha.

Se um artigo continuar falhando, o problema costuma ser o conteúdo de origem: uma página vazia, um arquivo sem texto extraível ou uma URL que não resolve mais. Abra o artigo para conferir o que foi realmente 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

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