--- title: Enviando e gerenciando documentos description: >- Formatos e limites, o que cada status significa, como reenviar um arquivo que falhou e como encontrar e remover um documento. sidebar: icon: upload --- Tudo nesta página funciona da mesma forma na base da organização e dentro de um projeto. A única diferença é em qual base o arquivo cai. ## Enviando um arquivo Duas formas de enviar, e ambas fazem a mesma coisa: - **Arrastar e soltar.** Solte os arquivos em qualquer lugar da tela da base de conhecimento. A área fica destacada enquanto você arrasta. - **Adicionar documentos.** O botão no canto superior direito, ou **Escolher arquivos** quando a base ainda está vazia, abre o seletor de arquivos. Você pode enviar vários arquivos de uma vez. Cada um é enviado e colocado na fila separadamente, então um arquivo lento não trava os outros. ### Formatos e limites | Formato | Extensão | Uso típico | | --- | --- | --- | | PDF | `.pdf` | Contratos, escopos de trabalho, propostas | | Word | `.docx` | Briefings, relatórios, políticas internas | | Excel | `.xlsx` | Listas de preços, planilhas de horas, tabelas de tarifas | | Markdown | `.md` | Notas, playbooks, qualquer coisa exportada de uma wiki | | Texto simples | `.txt` | Transcrições, logs, anotações rápidas | Cada arquivo pode ter até **40 MB**. Qualquer arquivo maior, ou em um formato fora da lista, é ignorado com uma mensagem avisando isso. Se você enviar cinco arquivos e dois não forem suportados, os outros três ainda passam. O título do documento vem do nome do arquivo sem a extensão, então `master-services-agreement.pdf` vira "Master services agreement". Nomeie seus arquivos da forma como você quer que eles sejam lidos. :::warning[Um PDF nem sempre é texto] Um contrato escaneado é uma imagem de um contrato. Se o arquivo não tem uma camada de texto, não há nada para extrair e o documento falha. Passe o arquivo por OCR primeiro, ou envie o arquivo digital original em vez do escaneado. ::: ## Lendo a tabela ![A tabela de documentos, com as colunas documento, tamanho, remetente e status](/images/knowledge-base/statuses.webp) Quatro colunas, da esquerda para a direita: **Documento** é o título, com o nome original do arquivo embaixo em fonte monoespaçada para você conseguir diferenciar dois títulos parecidos. **Tamanho** é o quanto o arquivo pesa. O contador acima da tabela soma tudo, o que é a forma rápida de ver quanto você está armazenando. **Enviado por** é quem fez o upload e quando. **Status** é em que ponto do ciclo de vida o arquivo está: | Status | O que significa | | --- | --- | | **Lendo** | O texto está sendo extraído e indexado. Leva alguns minutos | | **Lia leu** | Concluído. A contagem de trechos embaixo é quantas passagens indexadas ele produziu | | **Falhou** | O arquivo não pôde ser lido. O motivo aparece embaixo | A contagem de trechos dá uma noção aproximada de quanto conteúdo há para pesquisar. Um contrato com 128 trechos carrega muito mais detalhes respondíveis do que uma nota com 9 trechos. ## Corrigindo um documento que falhou Abra o menu no final da linha. ![O menu do documento, oferecendo Reprocessar e Excluir documento](/images/knowledge-base/menu.webp) **Reprocessar** coloca o arquivo na fila para ser lido novamente. Só aparece em documentos que falharam, já que não há nada para tentar de novo em um que deu certo. Tente novamente uma vez. Se falhar pela segunda vez, o problema é o arquivo em si e não o processamento, e o motivo na linha geralmente diz qual é: - Nenhum texto legível, o que significa um escaneamento ou um PDF só de imagem. Rode o OCR e envie de novo. - Um arquivo protegido por senha ou corrompido. Envie uma cópia desbloqueada. ## Encontrando um documento A caixa de busca acima da tabela filtra enquanto você digita, buscando tanto no título quanto no nome do arquivo. ![A base de conhecimento filtrada por um termo de busca](/images/knowledge-base/search.webp) Isso é um filtro na lista, não uma busca no conteúdo. Ele responde "nós já enviamos a lista de preços alguma vez?". Para perguntar o que está dentro dos documentos, pergunte para a Lia, ou use `search_knowledge_base` a partir de um cliente MCP conectado. ## Removendo um documento **Excluir documento** no mesmo menu. A confirmação nomeia o arquivo primeiro. ![A confirmação de exclusão, nomeando o documento que está sendo removido](/images/knowledge-base/delete.webp) Excluir é imediato e permanente. O arquivo e seus trechos indexados vão embora, e a Lia para de usá-lo nas respostas dela a partir daquele momento. Não há como desfazer, então se você está substituindo um documento por uma versão mais nova, envie o novo primeiro e exclua o antigo depois. :::tip Manter um contrato desatualizado na base é pior do que não ter contrato nenhum, porque a Lia vai responder com base nele com confiança. Quando um documento é substituído, exclua o antigo no mesmo dia. ::: ## Para onde ir agora Restrinja um arquivo a um projeto em vez de todo o workspace. Como o processamento funciona e o que pertence a cada base.