Ligar os Seus Dados
Nesta página
A pesquisa só é tão boa quanto os dados que lhe fornece
O poder da Pesquisa Empresarial depende diretamente da qualidade e da abrangência das fontes ligadas. Uma implementação que indexe apenas a unidade partilhada da direção produzirá respostas pobres. Os utilizadores concluirão que a ferramenta não funciona, quando o problema real é o âmbito. Esta lição segue a ordem real de um projeto: inventário, ligação, ajuste da indexação e, finalmente, manutenção.
Comece por um inventário baseado em quatro perguntas. Questione as próprias equipas, não apenas a TI. Que ferramentas é que as pessoas usam realmente no dia a dia, incluindo a TI sombra? Onde reside o conhecimento crítico — documentação técnica, procedimentos, políticas internas? Que conteúdo é que os colaboradores pesquisam com mais frequência? Que dados são suficientemente sensíveis para exigir restrições de acesso? As respostas definem a sua ordem de prioridades. Essa ordem quase nunca coincide com a facilidade técnica: ligue primeiro as fontes que contêm o conhecimento mais solicitado e atualizado.
De seguida, verifique os pré-requisitos. São idênticos para todos os conectores. Precisa de direitos de administrador na plataforma de origem — como o Google Workspace Admin ou o SharePoint Admin, por exemplo —, de uma conta de serviço ou aplicação OAuth dedicada à Pesquisa Empresarial, de permissões de leitura nos espaços a indexar e da aprovação da sua equipa de segurança. A aprovação de segurança é o fator que mais frequentemente compromete os prazos. Solicite-a durante a fase de inventário, não no dia anterior à entrada em produção.
Ligar as principais fontes
A ligação ao Google Drive utiliza OAuth 2.0 com uma conta de serviço do Google Workspace. Siga estes passos:
- Criar uma conta de serviço na Consola do Google Cloud
- Ativar a API do Google Drive para essa conta
- Ativar a delegação em todo o domínio no Google Workspace Admin
- Configurar os âmbitos de leitura necessários
- Introduzir as credenciais na consola da Pesquisa Empresarial
O conector indexa então documentos do Google Docs, Sheets, Slides, PDFs e outros formatos armazenados no Drive, respeitando automaticamente as permissões de partilha definidas no Google.
Para um ambiente Microsoft 365, a lógica é idêntica, mas a autorização flui através do Azure. Registe uma aplicação no Azure Active Directory, conceda-lhe as permissões do Microsoft Graph Sites.Read.All e Files.Read.All, obtenha o consentimento do administrador e, em seguida, configure o conector com as credenciais dessa aplicação. Isto indexa sites do SharePoint, bibliotecas de documentos e ficheiros do OneDrive, herdando fielmente as permissões do SharePoint.
A ligação ao Confluence é mais rápida: crie um token de API da Atlassian com permissões de leitura, especifique os espaços a indexar ou escolha todo o site e defina a frequência de sincronização. Se a sua organização o utiliza como wiki principal, priorize esta ligação — é quase sempre a fonte mais rica de documentação técnica e procedimentos internos.
O Slack requer uma aplicação dedicada no espaço de trabalho. Adicione os âmbitos OAuth channels:history e channels:read, instale a aplicação e selecione os canais. Resista à tentação de indexar tudo. Foque-se nos canais de projeto, suporte e documentação. Deixe de lado os canais informais; estes adicionam ruído sem fornecer conhecimento acionável.
Ajustar a indexação
A sincronização inicial pode demorar várias horas, dependendo do volume, e sobrecarrega os seus sistemas de origem durante todo esse tempo. Agende-a fora das horas de ponta. Posteriormente, a Pesquisa Empresarial deteta alterações automaticamente. Os novos documentos são indexados minutos após a sua criação. Os documentos modificados são reindexados automaticamente. Os documentos eliminados desaparecem na próxima sincronização. As alterações de permissões propagam-se aos resultados. Configura a frequência por conector: em tempo real via webhooks, a cada quinze minutos, hourly ou daily.
A filtragem é a segunda alavanca para a qualidade. Inclua ou exclua pastas para indexar apenas os espaços relevantes. Filtre por tipo de ficheiro para descartar imagens, vídeos ou ficheiros grandes sem valor textual. Filtre por antiguidade, mantendo apenas documentos dos últimos dois anos, por exemplo. Exclua padrões de nomenclatura para ignorar ficheiros temporários, rascunhos e arquivos. Negligenciar esta configuração tem um custo preciso: uma política de vendas desatualizada que permaneça indexada acabará por produzir uma resposta errada que parece perfeitamente fundamentada. Este é o pior cenário, pois nada alerta o leitor.
A relevância depende também dos metadados. Um documento com um título descritivo classifica-se melhor do que um ficheiro chamado “v2_final”. As etiquetas e rótulos existentes enriquecem a indexação. As descrições das páginas do Confluence ou dos ficheiros do Drive são aproveitadas. A informação do autor ajuda a ponderar a fiabilidade. Por fim, a forma como os utilizadores formulam as perguntas é tão importante quanto a configuração. Incentive perguntas completas em vez de palavras-chave isoladas. Mostre às suas equipas que “Qual é o procedimento de integração para programadores de back-end?” produz um resultado completamente diferente de “integração”. Partilhe internamente alguns exemplos de consultas eficazes.
Monitorização a longo prazo
A consola de administração apresenta o estado da indexação: número de documentos indexados por fonte, data da última sincronização, erros de indexação e documentos com falha, volume de pesquisa e taxa de satisfação. Consulte-a mensalmente. Verifique se os conectores permanecem ativos. Investigue as falhas — geralmente permissões revogadas ou ficheiros corrompidos. Ajuste os filtros com base no feedback. Ligue novas fontes à medida que a adoção cresce. Um conector avariado não dispara nenhum alerta visível para os utilizadores. As respostas simplesmente pioram e ninguém estabelece a ligação.
Pontos-chave
- Comece por um inventário das fontes de dados e priorize os itens mais pesquisados
- Cada conector requer uma conta de serviço com permissões de leitura
- A indexação incremental mantém os resultados atualizados automaticamente
- A filtragem e as exclusões refinam a relevância
- A monitorização contínua garante a qualidade e a atualidade dos resultados