Descrição
A forma como os documentos são nomeados e estruturados impacta diretamente na capacidade da Inteligência Artificial (IA) de localizar e interpretar os conteúdos.
Este artigo apresenta boas práticas de nomenclatura e estrutura de pastas para garantir que a IA da OpenClick identifique corretamente os arquivos armazenados em ambientes como Microsoft SharePoint e OneDrive.
1. Por que isso é importante
A IA depende de três fatores para localizar informações:
-
Nome do arquivo: usado como referência direta para o tema.
-
Estrutura de pastas: indica contexto (por exemplo, “Infra > Dúvidas > Senha”).
-
Conteúdo interno: analisado em conjunto com o nome e o caminho do arquivo.
Uma má organização ou nomes genéricos podem fazer a IA confundir documentos, omitir respostas ou priorizar materiais desatualizados.
2. Boas práticas de nomenclatura
Use nomes claros e padronizados, evitando espaços e caracteres especiais.
Exemplos corretos:
-
Infra_Suporte_Senha.docx
-
Política_Teletrabalho_2025.pdf
-
FAQ_Instalação_VPN_Windows.docx
Evite:
-
documento_final(1).docx
-
Captura.PNG
-
arquivo_teste_novo_versao3.docx
Dica: mantenha a estrutura Tema_Subtema_Detalhe_Ano sempre que possível.
3. Estrutura ideal de pastas
A estrutura hierárquica facilita que a IA entenda o contexto de cada documento.
Exemplo de estrutura recomendada:
BaseConhecimento
┣━━ Infra
┃ ┣━━ Dúvidas
┃ ┣━━ Senha
┃ ┗━━ VPN
┣━━ Marketing
┃ ┣━━ Campanhas
┃ ┗━━ Manuais
┣━━ RH
┃ ┣━━ Políticas
┃ ┗━━ Benefícios
Boas práticas:
-
Evite misturar documentos de áreas diferentes em uma mesma pasta.
-
Crie subpastas para separar conteúdos operacionais de políticas e instruções.
-
Nomeie as pastas de forma descritiva e curta.
4. Cuidados com formatação e compatibilidade
A IA e a API da Microsoft possuem limitações técnicas:
-
Evite nomes com mais de 150 caracteres.
-
Não use acentos ou caracteres especiais (ç, ã, @, %, &).
-
Mantenha o formato de arquivo legível (DOCX, PDF de texto, XLSX).
-
Evite pseudo-PDFs: arquivos que são imagens (screenshots) não são interpretáveis pela IA.
5. Testando a leitura da IA
Após organizar os arquivos:
-
Solicite à IA que busque um documento específico pelo nome.
-
Verifique se ela consegue identificar o conteúdo correto.
-
Caso o resultado esteja incorreto, revise:
-
Nome do arquivo
-
Localização na estrutura
-
Tipo de arquivo (texto legível vs. imagem)
-
6. Dicas complementares
-
Mantenha nomes consistentes entre diferentes versões.
Exemplo: Manual_Instalação_v1.docx, Manual_Instalação_v2.docx. -
Atualize sempre o nome quando o conteúdo for revisado.
-
Centralize documentos de referência em uma única base para evitar duplicações.
Glossário
Pseudo-PDF: Arquivo em formato PDF que contém apenas imagens (sem texto legível).
API: Interface de Programação de Aplicações, usada para conectar sistemas como o SharePoint à IA.
Indexação: Processo no qual a IA analisa e armazena informações de arquivos para consultas futuras.
Hierarquia de pastas: Organização em níveis, usada para agrupar conteúdos relacionados.
Categoria
📂 Integrações e IA com SharePoint/OneDrive
📂 Boas Práticas de Documentação
Revisão e atualização
-
Autor: Thiago Brito
-
Revisão: Equipe OpenClick / IA Clicksmart
-
Última atualização: 04/11/2025