Upload de Documentos

Uma base pode receber conteúdo por quatro caminhos:

• Bloco de Texto, para escrever ou colar um item;
• Arquivo, para extrair o texto de um documento;
• Site, para descobrir e sincronizar páginas de uma URL;
• Importar CSV, para criar vários itens de texto em lote.

Os três primeiros ficam em Bases de Conhecimento → abra a base → Adicionar Item. A importação em lote usa Importar CSV no topo da própria base. É necessário ter a capability bases.write; a capability bases.view permite consultar a base, mas não adicionar ou editar itens.

Adicionar um bloco de texto

A aba inicial da tela Adicionar Item é Bloco de Texto.

1. Em Nome do Item, escreva um nome que identifique o assunto, com até 100 caracteres.
2. Em Conteúdo, escreva ou cole até 100.000 caracteres. O editor aceita Markdown.
3. Selecione Adicionar Item.

O item é criado como Pendente e segue para extração, divisão em trechos e indexação. O nome não serve apenas para organizar a lista: ele acompanha os trechos no índice e pode ajudar a busca. Prefira Política de devolução — Brasil a Documento 1.

Enviar um arquivo

Na aba Arquivo, o SquadOS aceita um arquivo por envio, com no máximo 10 MB.

Conteúdo	Extensões aceitas
PDF	.pdf
Word	.docx
Excel	.xlsx
HTML	.html, .htm
JSON	.json
CSV ou TSV	.csv, .tsv
Markdown	.md, .markdown
Texto simples	.txt

1. Preencha Nome do Item ou escolha o arquivo para usar automaticamente o nome dele, sem a extensão.
2. Arraste o documento para a área de upload ou use o seletor de arquivo.
3. Confira se não apareceu uma mensagem de tamanho, formato ou conteúdo incompatível.
4. Selecione Enviar Arquivo.

O arquivo fica em armazenamento privado. O processador baixa a fonte, extrai sua estrutura, divide o conteúdo e cria o índice pesquisável. Arquivos antigos do Office, apresentações, ebooks, mensagens de email e imagens não entram diretamente: a própria interface orienta converter o material para um formato aceito ou colar o texto.

Depois da extração, o item pode ser aberto em Editar. É possível corrigir tanto o Nome do Item quanto o Conteúdo, inclusive quando a origem foi um arquivo. Salvar Alterações devolve o item a Pendente e inicia uma nova indexação; não é necessário excluir e enviar o documento outra vez.

Caution

A verificação da assinatura do arquivo acontece logo depois da seleção. Se a interface avisar que o conteúdo não corresponde à extensão, não envie: remova a seleção e escolha o arquivo correto. O produto atual não mostra um estado visual enquanto essa leitura curta termina.

Indexar um site

Use a aba Site para transformar páginas públicas de um domínio em itens da base.

1. Informe a URL inicial.
2. Escolha a Frequência de sincronização: Manual, Diária, Semanal ou Mensal.
3. Se necessário, abra Avançado para definir um nome, limitar por prefixo de caminho, excluir caminhos e alterar o máximo de páginas. O valor inicial é 500.
4. Selecione Visualizar páginas.
5. Confira a quantidade encontrada, as páginas que restaram depois das exclusões, o custo em créditos e o saldo da organização.
6. Selecione Confirmar e iniciar crawl.

A confirmação fica indisponível quando nenhuma página efetiva foi encontrada ou quando o saldo não cobre o custo. Uma frequência diferente de Manual cria sincronizações futuras, que também podem consumir créditos. O site precisa estar acessível ao coletor; páginas que exigem JavaScript ou um domínio sem sitemap podem não aparecer no preview.

Importar vários itens por CSV

Em Importar CSV, o arquivo precisa usar:

• ponto e vírgula (;) como separador;
• a primeira linha title;content;
• uma linha por item;
• aspas duplas quando o conteúdo tiver ponto e vírgula ou quebra de linha;
• duas aspas duplas ("") para representar uma aspa dentro de um campo já entre aspas.

Exemplo mínimo:

title;content
"Prazo de devolução";"A devolução pode ser solicitada em até 30 dias."
"Atendimento";"De segunda a sexta, das 8h às 18h."

O modal oferece Baixar Planilha Exemplo e mostra os três primeiros itens válidos no preview. O número do botão de importação indica quantos itens foram reconhecidos. Linhas vazias, sem nome ou sem conteúdo não entram; confira a contagem antes de confirmar.

A importação grava os itens um a um. Por isso, uma falha no meio do arquivo pode produzir um resultado parcial: os sucessos permanecem na base e o modal lista os erros das demais linhas. Antes de tentar novamente, compare a lista para não duplicar o que já entrou.

Note

Na interface em inglês, partes do importador e a planilha de exemplo ainda podem aparecer em português. O contrato do arquivo continua sendo posicional: primeira coluna para o nome e segunda para o conteúdo. Use o cabeçalho canônico title;content e substitua todo o texto do exemplo pelos seus dados.

Entender os estados

Estado	Significado	O que fazer
Pendente	O item aguarda um processador.	Aguarde; editar também retorna o item a este estado.
Processando	A fonte está sendo extraída ou os trechos estão sendo indexados.	Não faça outro upload do mesmo conteúdo.
Processado	A ingestão e a gravação do índice terminaram.	Teste perguntas reais no agente.
Erro	A extração ou a indexação falhou.	Confira a fonte e use as ações de reprocessamento descritas em Organizando Itens da Base.

Processado não garante que qualquer pergunta encontrará a resposta. Ele confirma a ingestão, não a qualidade da recuperação. Para uma validação útil:

1. conecte a base em Agentes → abra o agente → Conhecimento → Bases de conhecimento;
2. salve o agente;
3. faça perguntas com a linguagem real dos clientes;
4. confirme se o trecho recuperado sustenta a resposta;
5. melhore nomes, headings e conteúdo quando a informação estiver indexada, mas difícil de localizar.

Veja o fluxo completo em Conectando a Agentes.

Preparar conteúdo que o agente consiga usar

• Dê ao item um nome específico e coerente com o vocabulário do cliente.
• Use headings para separar assuntos; eles acompanham os trechos indexados.
• Mantenha cada política junto de suas condições, exceções e data de validade.
• Separe documentos extensos quando tratam de assuntos sem relação.
• Remova versões revogadas e duplicatas para evitar respostas contraditórias.
• Depois de uma importação importante, valide a jornada de pergunta e resposta — não apenas o status da tabela.