Conectores

Conectores sincronizam continuamente documentos de serviços externos na sua base de conhecimento, para que você nunca precise enviar arquivos manualmente. Conteúdo novo é adicionado, conteúdo alterado é reprocessado e conteúdo excluído é removido — tudo automaticamente.

Conectores disponíveis

O Zoen vem com 49 conectores embutidos:

Adicionando um conector

De dentro de uma base de conhecimento, clique em + New connector no canto superior direito para abrir o seletor de conectores. Escolha um serviço e conclua as etapas de configuração:

Gerenciando conectores

Abra Connected Sources na base de conhecimento para ver todos os conectores ativos. Cada card mostra o status do conector, o horário do último sync e a contagem de documentos, e o próximo sync agendado:

Os botões de ação em cada card de conector:

Editando um conector

Clique no ícone de settings para abrir o modal de edição. Ele tem duas abas:

Settings — altere qualquer campo de config específico da fonte (ex.: trocar o branch do GitHub) e atualize a frequência de sync.

Documents — navegue por todos os documentos que este conector sincronizou e gerencie exclusões (veja Excluindo documentos abaixo).

Histórico de sync

Expanda qualquer card de conector clicando no chevron para ver um log dos syncs recentes:

• Cada linha mostra data/hora e um resumo do que mudou: +N (adicionados, verde), ~N (atualizados, âmbar), -N (excluídos, vermelho), !N (falharam, vermelho), ou No changes
• Um spinner indica um sync em andamento
• Linhas de erro mostram um ícone vermelho e a mensagem de falha

O log mantém as 10 execuções de sync mais recentes.

Excluindo documentos

Às vezes um conector sincroniza documentos que você não quer na base de conhecimento — rascunhos, templates, páginas confidenciais e assim por diante. Você pode excluí-los individualmente.

Para excluir um documento, abra o modal de settings do conector, vá na aba Documents e clique em Exclude ao lado de qualquer documento. Documentos excluídos são ignorados em todo sync seguinte, mesmo se o conteúdo na fonte mudar.

Para reverter uma exclusão, mude para a aba Excluded e clique em Restore — o documento será puxado no próximo sync.

Como o sync funciona

Em cada execução o conector busca documentos na fonte e compara com o que já está armazenado. Só documentos alterados são reprocessados — conteúdo novo é adicionado, conteúdo atualizado é re-chunked e re-embeddado, conteúdo excluído é removido. Um conector sincronizando milhares de documentos só faz trabalho real quando algo de fato muda.

Status do conector

Um conector disabled exige intervenção — reconecte a conta OAuth ou use o botão Resume para reabilitar o sync.

Tratando falhas

Se um único documento falhar (ex.: problema de permissão ou timeout), o sync continua e tenta esse documento na próxima vez. Se um sync inteiro falhar, o conector faz backoff e tenta de novo com atrasos crescentes. Após 10 falhas consecutivas de sync completo, o conector é automaticamente colocado em Disabled para não girar indefinidamente.

Tags de metadados

Conectores podem preencher automaticamente tags com metadados da fonte — por exemplo, um conector Notion pode marcar documentos com Labels e Last Modified; um conector GitHub pode marcar com Repository e File Path. Essas tags ficam disponíveis para busca filtrada no bloco Knowledge.

Você pode desabilitar tipos específicos de tag na configuração ou a qualquer momento nas settings do conector para liberar slots de tag para marcação manual ou outros conectores.

Vários conectores

Você pode adicionar quantos conectores precisar a uma única base de conhecimento. Cada um gerencia seus documentos de forma independente, e todo o conteúdo é pesquisável junto pelo bloco Knowledge. Fique de olho no uso de slots de tag ao combinar conectores que preenchem tags de metadados.