Adicionar conhecimento: documentos

Pranav

Pranav

Última atualização em Oct 14, 2026

Descubra

Os documentos ensinam seu assistente sobre o seu produto. Adicione páginas de sites ou arquivos PDF, e o Captain os lê, responde a partir deles e cria FAQs com base neles.

Plano e acesso: Startups, Business ou Enterprise Preços e Planos. Administradores podem adicionar, atualizar e excluir documentos. Cada plano pago inclui até 2.000 documentos. O limite é compartilhado entre todos os assistentes da conta, e cada PDF ou página web rastreada conta como um documento.

Configurar e testar

Antes de começar

  • Um assistente. Veja Criar e conectar um assistente.

  • As páginas do site devem ser públicas. O Captain não pode ler páginas protegidas por login.

  • Os PDFs devem ter até 10MB e conter texto real (imagens digitalizadas podem não ser legíveis).

  • Se o seu site bloqueia rastreadores no robots.txt, permita o Chatwoot primeiro (abaixo).

Adicionar um site ou PDF

  1. Vá para Captain > Documentos.

  2. Clique em Criar novo documento.

  3. Escolha o Tipo de documento:

    • URL: insira o endereço da página. O Captain lê essa página e também as páginas linkadas sob o mesmo caminho. Por exemplo, https://example.com/help cobre todas as páginas que começam com esse endereço.

      • Arquivo PDF: clique em Escolher arquivo PDF e selecione o arquivo.

  4. Opcional: adicione um Nome do Documento (Opcional).

  5. Escolha o assistente e clique em Criar.

O Captain lê e indexa o conteúdo. As páginas encontradas durante o rastreamento são adicionadas como documentos separados.

Permitir que o Chatwoot rastreie seu site

O Chatwoot usa o Firecrawl para ler sites e segue seu robots.txt. Se algumas páginas estiverem bloqueadas, adicione isto em https://seudominio.com/robots.txt:

User-agent: FirecrawlAgent
Allow: /

Verifique se o arquivo está publicado nesse endereço e então adicione ou atualize o documento.

Se o seu robots.txt bloquear o rastreador ao adicionar um site, nenhuma página será adicionada e nenhum erro será exibido. O assistente então dará respostas incompletas ou genéricas.

Teste

  1. Abra o menu do documento e escolha Ver detalhes.

  2. Verifique se Conteúdo rastreado (ou Detalhes do PDF) mostra seu texto e se FAQs relacionadas lista perguntas relevantes.

  3. Faça uma pergunta daquela página no Playground do assistente.

Obter valor

  • Mantenha os documentos atualizados: use Atualizar agora em um documento ou selecione vários e clique em Atualizar. A lista mostra quando cada um foi atualizado pela última vez.

  • Documentos de sites também são atualizados automaticamente: mensalmente em Startups (no dia 1), semanalmente em Business (aos domingos) e diariamente em Enterprise. O processamento pode demorar mais, então uma página pode não ser atualizada exatamente nesse horário. PDFs enviados não são atualizados automaticamente.

  • Um rastreamento de site adiciona até 500 páginas, e nunca mais do que o limite restante de documentos.

  • Prefira fontes focadas, como seu centro de ajuda, em vez de todo o site de marketing.

  • Usado em conversas mostra quais conversas utilizaram um documento.

  • Excluir um documento remove tudo o que o Captain aprendeu com ele.

  • Artigos do Centro de Ajuda não são lidos automaticamente. Para utilizá-los, adicione o endereço do seu Centro de Ajuda como documento de URL. Cada versão de idioma de um artigo é uma página separada, então cada uma conta como um documento.

  • FAQs criadas a partir de um documento ficam disponíveis imediatamente. Elas aparecem em FAQs e não precisam de aprovação.

  • FAQs que o Captain gera sempre estarão no idioma da sua conta. O assistente ainda responde no idioma do cliente.

  • O Captain não remove detalhes pessoais ou confidenciais do que você adiciona. Adicione apenas conteúdo que você está confortável em permitir que o assistente cite para clientes.

Solução de problemas

Sintoma Causa provável O que fazer
Status mostra Falha ao sincronizar com Acesso negado A página precisa de login ou seu site bloqueou o pedido (erro 401 ou 403). Torne a página pública ou permita o acesso em seu site.
Adicionou um site, mas nenhuma página aparece ou respostas são genéricas Seu robots.txt pode estar bloqueando o rastreador. Permita conforme mostrado em Permitir que o Chatwoot rastreie seu site e adicione o documento novamente.
Página não encontrada URL está errada ou a página foi movida Corrija a URL e adicione novamente
Página demorou muito para responder Seu site estava lento Use Tentar atualizar mais tarde
Página retornou conteúdo vazio O conteúdo é carregado apenas por scripts, ou a página está vazia Use uma página com texto simples, ou envie um PDF
atualização travou Uma atualização não foi concluída Use Tentar atualizar
Detalhes do PDF dizem que não foi possível extrair conteúdo legível PDF escaneado ou apenas de imagem Envie um PDF em texto
Banner: Limite de documentos atingido A conta possui 2.000 documentos entre todos os assistentes Exclua documentos que não precisa mais ou veja Preços e Planos

Mais causas: Solução de problemas do Captain.