Upload de Documentos

Existem três formas de adicionar conteúdo a uma base: colar um bloco de texto, fazer upload de um arquivo, ou importar vários itens de uma vez via CSV. Todas geram itens que são processados (chunkificados e indexados) automaticamente em segundo plano.

Adicionar um item (texto ou arquivo)

Na tela da base, clique em + Adicionar Item. Você cai na tela com duas abas: Bloco de Texto (padrão) e Arquivo.

Bloco de Texto

Ideal para FAQs, políticas curtas e blocos de texto que você quer ter controle direto sobre.

1. Preencha Nome do Item (aparece como título do item na lista).
2. Cole ou digite o Conteúdo.
3. Clique em Adicionar Item.

O item entra com status Pendente e é processado em seguida.

Arquivo

Use para enviar documentos prontos. Formatos aceitos: PDF, TXT, CSV, JSON e Markdown, até 10 MB por arquivo.

1. Preencha Nome do Item.
2. Arraste o arquivo na área tracejada ou clique em Escolher arquivo.
3. Clique em Enviar Arquivo.

O conteúdo é extraído automaticamente — você não precisa fazer nada além de aguardar o processamento terminar. Itens vindos de arquivo não são editáveis pelo painel; para mudar o conteúdo, exclua e faça upload de novo.

Importação em lote (CSV)

Para popular uma base rapidamente, use Importar CSV no topo da tela da base. O modal explica o formato esperado:

• separador de colunas: ponto e vírgula (;);
• colunas: title;content;
• aspas duplas para conteúdo com quebras de linha.

O modal traz um botão Baixar Planilha Exemplo que gera um CSV pronto para você editar. Depois de selecionar o arquivo, o modal mostra um preview dos 3 primeiros itens detectados antes de você confirmar.

Antes de enviar

Conteúdo limpo melhora a recuperação e reduz respostas contraditórias. Vale a pena revisar:

• remova páginas irrelevantes;
• prefira textos claros e atualizados;
• separe assuntos muito diferentes em arquivos diferentes;
• evite duplicar o mesmo conteúdo em várias bases.

Boas práticas

• Títulos descritivos. O agente não usa o título na busca, mas você usa para encontrar o item depois.
• Quebre arquivos grandes por assunto. Textos muito longos viram muitos chunks e fragmentam o contexto.
• Atualize ou remova conteúdo antigo. Política revogada vira fonte de erro.
• Teste perguntas reais depois de cada importação importante.

Quando o agente não acha a informação

1. Confirme que a base está conectada ao agente em Ferramentas → Consultar Base de Conhecimento.
2. Verifique se o item está com status Processado (ver Organizando Itens da Base).
3. Reescreva trechos confusos ou genéricos.
4. Acompanhe a aba AutoLearn — perguntas que falharam aparecem lá com sugestões de resposta.