Fontes de dados

Nota: Uma Fonte de dados é um único conteúdo (arquivo, URL ou texto) que existe em um Datastore. Pense nos armazenamentos de dados como pastas e nas fontes de dados como os arquivos individuais dentro deles.

---

​

🔢 Índice

1. Understanding Datasources
2. Types of Datasources
3. Adding Datasources
4. Managing Datasources
5. Viewing and Editing
6. Best Practices

---

​

1. Compreendendo as fontes de dados

​

O que é uma fonte de dados?

Uma Fonte de dados é uma unidade individual de conteúdo que contribui para sua base de conhecimento. Cada fonte de dados contém informações que seus funcionários de IA podem consultar ao responder a consultas. Relacionamento: Organização └─ Armazenamento de dados (por exemplo, “Documentos de suporte ao cliente”) ├─ Fonte de dados 1 (por exemplo, “Manual do Produto.pdf”) ├─ Fonte de dados 2 (por exemplo, “Página de perguntas frequentes”) └─ Fonte de dados 3 (por exemplo, “Política de Devolução”)

​

Fonte de dados x armazenamento de dados

---

​

2. Tipos de fontes de dados

​

Fontes de dados baseadas em arquivo

Carregue documentos do seu computador: Formatos Suportados:

• PDF (.pdf)
• Palavra (.docx, .doc)
• Texto (.txt)
• Marcação (.md)
• Planilhas (.xlsx, .xls, .csv)
• Apresentações (.pptx, .ppt)

Características:

• Armazenado permanentemente no ZappWay
• Processado uma vez no upload
• Pode ser baixado mais tarde
• Versionamento através de re-upload

​

Fontes de dados baseadas em URL

Importe conteúdo de sites: Tipos:

• Página única da web
• Artigo do blog
• Página de documentação
• Página do produto
• Artigo da base de conhecimento

Características:

• Instantâneo do conteúdo obtido no momento da importação
• Pode ser atualizado/reprocessado
• Não atualiza automaticamente (é necessária atualização manual)
• Somente páginas públicas (sem autenticação)

​

Fontes de dados baseadas em texto

Conteúdo inserido manualmente: Casos de uso:

• Respostas rápidas às perguntas frequentes
• Políticas curtas
• Instruções personalizadas
• Informações temporárias
• Trechos e notas

Características:

• Mais rápido de criar
• Fácil de editar in-line
• Não é necessário upload de arquivo
• Ideal para conteúdo curto

---

​

3. Adicionando fontes de dados

​

Da página de detalhes do armazenamento de dados

Passos:

1. Navigate to desired datastore
2. Click “Add Datasource” button
3. Choose datasource type:
   • File Upload
   • Website URL
   • Text Entry
4. Follow type-specific steps below

​

Adicionando arquivos

Upload de arquivo único:

1. Select “File Upload”
2. Click “Choose File” or drag-and-drop
3. Select file from your computer
4. File uploads automatically
5. Processing begins immediately

Upload de vários arquivos:

1. Select “File Upload”
2. Click “Choose Files” or drag multiple files
3. All files are queued
4. Each processes independently
5. Track individual progress

Operações suportadas:

• Arrastar e soltar: arraste arquivos diretamente para a área de upload
• Upload em lote: selecione vários arquivos de uma vez
• Acompanhamento do progresso: upload em tempo real e status de processamento

​

Adicionando sites

URL único:

1. Select “Website”
2. Enter full URL (including https://)
3. Choose import mode:
   • Single Page: Import only this URL
   • Crawl Site: Follow links automatically
4. Configure options (if crawling):
   • Max pages to crawl
   • URL patterns to include/exclude
5. Click “Add”

Opções de rastreamento explicadas:

• Profundidade máxima: quantos cliques de profundidade para seguir os links
  • Profundidade 0: somente a página que você especificou
  • Profundidade 1: página especificada + páginas vinculadas
  • Profundidade 2: Acima + páginas vinculadas a essas páginas
• Padrões de URL: controle quais páginas serão importadas
  • Incluir: /docs/* (somente páginas de documentação)
  • Excluir: /blog/* (pular postagens do blog)

​

Adicionando Texto

Entrada manual:

1. Select “Text Entry”
2. Enter a descriptive name
3. Type or paste content in text area
4. Optionally use Markdown formatting
5. Click “Save”

Opções de formatação:

• Texto Simples: Sem formatação
• Markdown: títulos, listas, negrito, itálico
• HTML: Formatação avançada (avançada)

Práticas recomendadas:

• Mantenha as entradas de texto focadas (tópico único)
• Use títulos claros para estrutura
• Incluir palavras-chave relevantes
• Fornece contexto completo

---

​

4. Gerenciando fontes de dados

​

Visualização de lista de fontes de dados

Informações exibidas: Cada cartão de fonte de dados mostra:

• Ícone de tipo: arquivo, URL ou indicador de texto
• Nome: título ou nome do arquivo da fonte de dados
• Status: Estado de processamento
• Tamanho/Comprimento: Tamanho do arquivo ou contagem de caracteres
• Data adicionada: carimbo de data/hora de upload/criação
• Menu Ações: visualizar, editar e excluir opções

​

Status da fonte de dados

Tipos de status:

​

Visualizando detalhes da fonte de dados

Clique em qualquer fonte de dados para ver:

• Visualização completa do conteúdo: Leia o texto processado
• Metadados:
  • Nome do arquivo original (se aplicável)
  • URL de origem (se aplicável)
  • Data e hora do upload
  • Tamanho do arquivo
  • Contagem de caracteres/palavras
• Informações de processamento:
  • Número de pedaços criados
  • Tempo de processamento
  • Histórico de status
• Estatísticas de uso:
  • Número de vezes referenciado pela IA
  • Armazenamentos de dados conectados
  • Carimbo de data e hora do último acesso

​

Editando fontes de dados

O que pode ser editado:

• Nome: atualize o nome da fonte de dados
• Conteúdo de texto: modifique fontes de dados baseadas em texto
• URL: Atualizar endereço do site (aciona reprocessamento)

Conteúdo do arquivo (deve ser reenviado) Configurações de processamento Data de criação Etapas para editar: Clique no nome da fonte de dados ou no botão “Editar” Modificar campos permitidos Clique em “Salvar alterações” O reprocessamento ocorre se o conteúdo for alterado Reprocessamento de fontes de dados Quando reprocessar: O conteúdo do site foi atualizado Precisa atualizar a fonte de dados baseada em URL O processamento falhou inicialmente Quer aplicar uma nova estratégia de chunking Como reprocessar: Detalhes da fonte de dados aberta Clique no botão “Reprocessar” Confirmar ação Aguarde a conclusão do processamento Observação: o conteúdo original é buscado novamente para fontes de dados de URL. Excluindo fontes de dados Aviso: a exclusão é permanente e não pode ser desfeita. A fonte de dados é removida imediatamente de todos os funcionários de IA conectados. Passos: Localize a fonte de dados na lista Clique no botão “Excluir” (ícone da lixeira) Confirme a exclusão no modal A fonte de dados foi removida permanentemente Exclusão em massa: Selecione várias fontes de dados (caixas de seleção) Clique em “Excluir selecionados” Confirmar exclusão do lote Todas as fontes de dados selecionadas são removidas

5. Viewing and Editing Content Preview Available for All Types:

Texto Processado: Visualize o conteúdo extraído Formato original: Baixe o arquivo fonte (se aplicável) Visualização de pedaços: veja como o conteúdo foi segmentado Recursos de visualização: Pesquisa: Encontre palavras-chave na fonte de dados Destaque: Destaque de palavras-chave no conteúdo Copiar: Copia seções de texto Baixar: Baixe o arquivo original Visualizador de pedaços O que são pedaços? Pedaços são os segmentos em que sua fonte de dados é dividida para recuperação de IA. Cada pedaço é otimizado para pesquisa semântica. Visualizando pedaços: Detalhes da fonte de dados aberta Clique na guia “Exibir pedaços” Procure todos os pedaços gerados Veja os limites e a sobreposição dos blocos Informações do pedaço: ID do bloco (para depuração) Pré-visualização do conteúdo Contagem de tokens Posição no documento original Casos de uso: Verifique se o conteúdo foi dividido corretamente Solucionar problemas de informações ausentes Entenda como a IA verá o conteúdo Visualizador de metadados Metadados disponíveis: Propriedades do arquivo: Nome do arquivo original Tipo/extensão de arquivo Tamanho do arquivo Carimbo de data e hora do upload Informações da fonte: URL (se aplicável) Domínio Data do rastreamento Título da página Processamento de dados: Duração do processamento Número de pedaços Modelo de incorporação usado Data do índice

6. Best Practices File Preparation Before Uploading:

Verificação de qualidade: Certifique-se de que o texto seja selecionável (não imagens) Verifique se há erros de OCR em documentos digitalizados Verifique se o conteúdo está completo Formatação: Use títulos claros Incluir índice (para documentos longos) Estrutura com seções lógicas Nomenclatura: Use nomes de arquivos descritivos Incluir números de versão Adicione datas se for urgente Exemplo de bons nomes: Produto_Manual_v2.1_Jan2025.pdf Return_Policy_Updated.docx API_Reference_Latest.pdf Práticas recomendadas para URLs Escolhendo URLs: ✅ Bons URLs: Páginas de documentação direta URLs específicos de artigos/postagens de blog Páginas de conteúdo estático Sites bem estruturados ❌ Evite: URLs que exigem login Aplicativos com muito JavaScript Páginas que mudam frequentemente (sites de notícias) Páginas de resultados de pesquisa dinâmicas Dicas de rastreamento: Comece com pequenos rastreamentos (teste com 10 a 20 páginas) Use padrões de URL para filtrar conteúdo Evite rastrear sites inteiros e grandes Rastreie novamente periodicamente para obter atualizações Organização de conteúdo Estratégia 1: Por tipo de documento Agrupe fontes de dados semelhantes: Todos os PDFs juntos Todas as páginas da web juntas Todas as entradas de texto juntas Estratégia 2: por tópico Organize por assunto: Documentação do produto A Documentação do produto B Políticas gerais Estratégia 3: Por Frescor Priorize por frequência de atualização: Atualizado com frequência (atualização mensal) Conteúdo estável (atualização anual) Arquivo (apenas referência) Manutenção Tarefas regulares: Semanalmente: Verifique se há fontes de dados com falha Reprocessar URLs importantes Remova conteúdo desatualizado Mensal: Audite todas as fontes de dados Atualizar documentos controlados por versão Verifique se as informações críticas estão atualizadas Trimestral: Atualização de conteúdo principal Excluir fontes de dados não utilizadas Reorganize se necessário Controle de versão: Incluir números de versão nos nomes Manter apenas a versão atual (excluir a antiga) Alterações do documento nas descrições Use convenções de nomenclatura consistentes ✅ Referência rápida Adicionando fontes de dados TipoMelhor paraVelocidadeUpload de arquivoDocumentos, manuaisRápido (1-5 min)URL do siteConteúdo da Web, blogsMédio (2-10 min)Entrada de textoFatos rápidos, perguntas frequentesInstantâneo Limites de tamanho de arquivo Máximo por arquivo: 50 MB (típico) Recomendado: menos de 20 MB para processamento mais rápido Para arquivos grandes: divida em vários arquivos menores Formatos Comuns Melhor compatibilidade: PDF (baseado em texto) .docx .txt/.md .csv/.xlsx Última atualização: março de 2026 Versão: 1.0 Plataforma: fontes de dados ZappWay