Os connectors sincronizam continuamente documentos de serviços externos para a sua base de conhecimento, então você nunca precisa enviar arquivos manualmente. Conteúdo novo é adicionado, conteúdo alterado é reprocessado e conteúdo excluído é removido — tudo automaticamente.
Connectors disponíveis
O Studio traz 60 connectors nativos:
| Categoria | Connectors |
|---|---|
| Produtividade | Notion, Confluence, Asana, Linear, Jira, Jira Service Management, Monday, Trello, ClickUp, Google Calendar, Google Sheets, Google Forms, Microsoft Excel, Typeform |
| Armazenamento em nuvem | Google Drive, Dropbox, OneDrive, SharePoint, Box, Amazon S3, SFTP |
| Documentos | Google Docs, Google Slides, Mintlify, WordPress, Webflow, DocuSign |
| Desenvolvimento | GitHub, GitLab, Azure DevOps, Sentry |
| Comunicação | Slack, Discord, Microsoft Teams, Reddit, X, YouTube |
| Gmail, Outlook | |
| CRM | HubSpot, Salesforce |
| Suporte | Intercom, ServiceNow, Zendesk, Zoho Desk |
| Gestão de incidentes | incident.io, Rootly, PagerDuty |
| Dados | Airtable |
| Anotações | Obsidian |
| Reuniões | Zoom, Google Meet, Gong, Grain, Granola, Fathom, Fireflies |
| Recrutamento | Greenhouse, Ashby |
| Compliance | Google Vault |
Adicionar um connector
Dentro de uma base de conhecimento, clique em + New connector no canto superior direito para abrir o seletor de connectors. Escolha um serviço e conclua as etapas de configuração:
Autenticar
A maioria dos connectors usa OAuth — selecione uma credencial existente no dropdown ou clique em Connect new account para autorizar pelo serviço. Os tokens são renovados automaticamente.
Outros connectors usam API keys ou personal access tokens. O modal de configuração indica qual credencial cada connector espera — por exemplo:
| Connector | Onde obter a chave |
|---|---|
| Obsidian | Instale o plugin Local REST API e copie a chave das configurações dele |
| Fireflies | Gere na página Integrations da sua conta Fireflies |
| Typeform | Personal access token nas configurações da sua conta Typeform |
| Azure DevOps | Personal access token com os escopos Wiki (Read), Work Items (Read) e Code (Read) |
| YouTube | Chave da YouTube Data API, no Google Cloud Console |
| Amazon S3 | Secret Access Key (o Access Key ID, a região e o bucket são informados como campos de configuração) |
| Sentry | Auth token com os escopos project:read e event:read |
| PagerDuty | Chave da REST API, em Integrations → API Access Keys |
| SFTP | Senha ou chave privada não criptografada, mais o fingerprint SHA-256 obrigatório da host key (host, porta, usuário e caminho raiz são informados como campos de configuração) |
| Mintlify | API key — opcional para sites de documentação públicos, que sincronizam via llms.txt |
Se você rotacionar uma API key no serviço externo, atualize-a também no Studio — tokens OAuth se renovam sozinhos, mas API keys não.
Configurar
Cada connector tem campos específicos da fonte que controlam o que é sincronizado. Exemplos:
- Notion — sincronize um workspace inteiro, um banco de dados específico ou a árvore de uma única página
- GitHub — informe um repositório, um branch e, opcionalmente, um filtro por extensão de arquivo
- Confluence — informe o seu domínio Atlassian e, se quiser, filtre por space key ou tipo de conteúdo
- Azure DevOps — escolha o que sincronizar (páginas de wiki, work items, arquivos do repositório ou tudo), com filtros opcionais de tipo/estado de work item, uma consulta WIQL personalizada e filtros de repositório/branch/caminho
- Amazon S3 — aponte para um bucket com um prefixo de chave opcional e uma lista de extensões permitidas personalizável; stores compatíveis com S3 (Cloudflare R2, MinIO) funcionam via endpoint customizado
- YouTube — sincronize um canal (por
@handleou ID) ou uma playlist, com filtro opcional de data de publicação e a opção de excluir Shorts - Sentry — filtre issues por consulta de busca (por exemplo,
is:unresolved), ambiente e janela de tempo; Sentry auto-hospedado funciona via host customizado - Obsidian — informe a URL do seu vault (
https://127.0.0.1:27124por padrão) e, se quiser, restrinja a um caminho de pasta - Fireflies — filtre por e-mail do anfitrião ou limite o número de transcrições sincronizadas, se quiser
A configuração é validada ao salvar — se um repositório não existir ou um domínio estiver inacessível, você vê o erro na hora.
Escolher a frequência de sincronização
| Frequência | Observações |
|---|---|
| Every hour | Melhor para fontes que mudam rápido |
| Every 6 hours | Bom equilíbrio para a maioria das fontes |
| Daily (padrão) | Adequado para conteúdo que muda pouco |
| Weekly | Para fontes estáveis, atualizadas raramente |
| Manual only | Sincroniza somente quando você aciona manualmente |
Frequências menores que uma hora exigem um plano Max ou Enterprise.
Configurar metadata tags (opcional)
Se o connector suportar metadata tags, você vê caixas de seleção para cada tipo de tag disponível (por exemplo, Labels, Last Modified, Notebook). Todas vêm ativadas por padrão — desmarque as que você não precisa.
Os slots de tag são compartilhados por todos os documentos de uma base de conhecimento. Veja Tags para mais detalhes.
Connect & Sync
Clique em Connect & Sync para salvar o connector e disparar a primeira sincronização. Os documentos começam a aparecer conforme são processados.
Gerenciar connectors
Abra Connected Sources na base de conhecimento para ver todos os connectors ativos. Cada card mostra o status do connector, o horário da última sincronização e a contagem de documentos, além da próxima sincronização agendada:
Os botões de ação em cada card de connector:
| Botão | Ação |
|---|---|
| ↻ (Refresh) | Dispara uma sincronização manual imediata. Fica indisponível durante a sincronização ou quando o connector está desativado; após cada disparo manual há um intervalo de 5 minutos |
| ⚙ (Settings) | Abre o modal de edição para alterar a configuração da fonte ou a frequência de sincronização |
| ⏸ / ▶ (Pause / Resume) | Pausa as sincronizações agendadas sem remover o connector. Resume funciona tanto no estado pausado quanto no desativado |
| 🗑 (Delete) | Remove o connector. Aparece um modal de confirmação com a opção de excluir também todos os documentos sincronizados |
| ∨ (Chevron) | Expande para mostrar o histórico de sincronizações |
Editar um connector
Clique no ícone de configurações para abrir o modal de edição. Ele tem duas abas:
Settings — altere qualquer campo de configuração específico da fonte (por exemplo, trocar o branch do GitHub) e atualize a frequência de sincronização.
Documents — navegue por todos os documentos que este connector sincronizou e gerencie as exclusões (veja Excluir documentos abaixo).
Histórico de sincronizações
Expanda qualquer card de connector clicando no chevron para ver o log das sincronizações 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 uma sincronização em andamento
- Linhas de erro exibem um ícone vermelho e a mensagem de falha
O log guarda as 10 sincronizações mais recentes.
Excluir documentos
Às vezes um connector sincroniza documentos que você não quer na sua base de conhecimento — rascunhos, modelos, páginas confidenciais e assim por diante. Você pode excluí-los um por um.
Para excluir um documento, abra o modal de configurações do connector, vá até a aba Documents e clique em Exclude ao lado do documento. Documentos excluídos são ignorados em todas as sincronizações seguintes, mesmo que o conteúdo mude na fonte.
Para reverter uma exclusão, vá até a aba Excluded e clique em Restore — o documento será trazido de volta na próxima sincronização.
Como a sincronização funciona
Em cada execução, o connector busca os documentos na fonte e compara com o que já está armazenado. Apenas documentos alterados são reprocessados — conteúdo novo é adicionado, conteúdo atualizado passa por novo chunking e novos embeddings, e conteúdo excluído é removido. Um connector que sincroniza milhares de documentos só faz trabalho real quando algo realmente muda.
Conteúdo removido de circulação
Conteúdo que ainda existe na fonte, mas não está mais em circulação, é tratado como excluído e removido da sua base de conhecimento. Isso vale para uma página arquivada no Confluence, uma tarefa em um projeto arquivado do Asana, um item arquivado do CMS do Webflow, um artigo de conhecimento desativado no ServiceNow, uma planilha na lixeira do Google Drive, uma mensagem movida para os Itens Excluídos do Outlook e um incidente cancelado no incident.io.
Isso evita que os agentes citem conteúdo que o seu time já retirou de circulação. Restaurar o item na fonte o traz de volta como um novo documento na próxima sincronização.
Status do connector
| Status | Significado |
|---|---|
| Active | Funcionando normalmente, dentro do agendamento |
| Syncing | Uma sincronização está em andamento |
| Paused | As sincronizações agendadas estão suspensas; a sincronização manual continua disponível |
| Error | A última sincronização falhou; haverá nova tentativa na próxima execução agendada, com backoff |
| Disabled | A sincronização foi pausada automaticamente após 10 falhas consecutivas |
Um connector desativado precisa de intervenção — reconecte a conta OAuth ou use o botão Resume para reativar a sincronização.
Tratamento de falhas
Se um único documento falhar (por exemplo, um problema de permissões ou um timeout), a sincronização continua e tenta esse documento novamente na próxima vez. Se uma sincronização inteira falhar, o connector recua e tenta de novo com atrasos crescentes. Depois de 10 falhas consecutivas de sincronização completa, o connector passa automaticamente para Disabled, para não ficar tentando indefinidamente.
Metadata tags
Os connectors podem preencher tags automaticamente com metadados da fonte — por exemplo, um connector do Notion pode marcar documentos com as Labels e a data de Last Modified; um connector do GitHub pode marcar documentos com Repository e File Path. Essas tags ficam então disponíveis para busca filtrada no bloco Knowledge.
Você pode desativar tipos específicos de tag durante a configuração ou a qualquer momento nas configurações do connector, liberando slots de tag para marcação manual ou para outros connectors.
Os slots de tag são compartilhados por todos os documentos de uma base de conhecimento. Se vários connectors preencherem tags, todos consomem do mesmo conjunto de 17 slots.
Vários connectors
Você pode adicionar quantos connectors precisar a uma mesma base de conhecimento. Cada um gerencia seus documentos de forma independente, e todo o conteúdo é pesquisável em conjunto pelo bloco Knowledge. Fique atento ao uso dos slots de tag ao combinar connectors que preenchem metadata tags.