> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lovi.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Conhecimento em Documentos
> Envie fontes de dados para seu agente de IA
Se *Crawlers* são livros da biblioteca pública (a web), **Documentos** são os arquivos privados do seu escritório.
É aqui que você faz upload dos seus manuais confidenciais, listas de preços em Excel ou guias internos em PDF. Você dá ao agente acesso direto a arquivos específicos para que ele se torne um especialista instantâneo no *seu* negócio.
### 📥 O que posso enviar aqui? (Formatos mágicos)
Seu agente é multilíngue e pode ler quase qualquer coisa:
* 📄 **PDF:** Manuais, catálogos, folhetos.
* 📊 **XLSX / CSV:** Tabelas de preços, listas de estoque, bancos de dados simples.
* 📝 **TXT / JSONL:** Notas rápidas, logs ou dados estruturados.
***
### ⚙️ Como gerenciar seus arquivos (A Zona de Upload)
É tão fácil quanto parece:
1. **Arrastar e Soltar:** Arraste seu arquivo para a caixa ou clique para navegar no seu computador.
2. **Processamento:** O sistema lerá ("parseará") o texto para que o agente possa entendê-lo.
3. **Pronto!** Uma vez processado, você verá o arquivo na lista abaixo.
#### Controles da Lista:
* **Nome:** O nome do arquivo. Mantenha claro (ex.: `Precos_2024.pdf` em vez de `doc1.pdf`).
* **Toggle (O Interruptor):** O recurso mais útil.
* 🔵 **ON:** O agente lê e usa este arquivo.
* ⚪ **OFF:** O arquivo é armazenado mas ignorado pelo agente. Perfeito para rascunhos ou versões antigas que você não quer excluir completamente.
* **Lixeira 🗑️:** Remove permanentemente o arquivo da memória do agente.
***
### ⚠️ Regras de Ouro (O que NÃO fazer)
Para manter tudo funcionando sem problemas, tenha isso em mente:
#### 1. Arquivos vazios = Erro 🚫
Se você enviar um PDF que contém apenas imagens escaneadas (sem texto selecionável) ou um arquivo corrompido, verá um erro como `[MARKITDOWN] pdf is empty`.
> **Solução:** Certifique-se de que o PDF contém texto real (OCR) ou que o arquivo Excel tem dados reais.
#### 2. Cuidado com o tamanho (Divida!) ✂️
Há um limite de palavras por arquivo para evitar sobrecarregar o cérebro do agente.
* *Seu manual tem 500 páginas?* Não envie como um único arquivo.
* **Divida:** Envie `Manual_Parte1.pdf`, `Manual_Parte2.pdf`, etc.
* O agente é inteligente e combinará informações de todos os arquivos ativos para dar uma resposta coerente.
***
### 🧠 Como o agente raciocina com isso?
Imagine que você faz upload de três arquivos e os ativa (**ON**):
1. `Manual_Maquina_Lavar.pdf`
2. `Precos_Pecas.xlsx`
3. `Politica_Garantia.txt`
Agora, se um usuário perguntar: *"Quanto custa a peça X e ela está coberta pela garantia?"*
O agente irá:
1. Procurar o preço no **Excel**.
2. Ler as condições no **TXT**.
3. Combinar ambos e responder: *"A peça custa R\$100 e sim, está coberta pela cláusula 3."* 🤯
***
### 🎓 Resumo de Boas Práticas (Cola Rápida)
* **Nomes descritivos:** Ajude o agente (e a si mesmo) a entender o que está dentro. `Cardapio_Casamento.pdf` é melhor que `scan001.pdf`.
* **Atualizações:** Se você enviar uma nova versão (`Precos_V2.xlsx`), lembre-se de desativar (OFF) ou excluir a antiga (`Precos_V1.xlsx`) para que o bot não fique confuso com dois preços diferentes.
* **Dados limpos:** Evite enviar arquivos Excel com milhares de linhas vazias ou PDFs com marcas d'água pesadas. Quanto mais limpo o texto, mais inteligente a resposta.
Comece a preencher o cérebro do seu agente com seus melhores documentos! 📂✨