Como equipes conectam Notion, Slack e Google Drive ao Dust para criar assistentes internos de IA personalizados

Equipes corporativas utilizam o Dust para eliminar silos de informação entre Google Drive, Notion e Slack, transformando documentos fragmentados e conversas do dia a dia em assistentes internos de IA altamente responsivos. Em vez de construir pipelines personalizados de geração aumentada por recuperação (RAG) do zero, as organizações conectam suas ferramentas de software existentes ao Dust por meio de integrações gerenciadas, organizam os dados sincronizados em Espaços (Spaces) seguros e configuram agentes especializados equipados com instruções direcionadas e recursos avançados de modelos. Com isso, os colaboradores podem consultar esses assistentes diretamente no Slack ou em um espaço de trabalho web centralizado para obter respostas precisas e fundamentadas em fontes verificadas, sem comprometer a confidencialidade dos dados organizacionais.

Compreendendo a arquitetura do Dust: Conexões, Espaços e Permissões

Para conectar ferramentas corporativas com segurança, os administradores precisam entender como o Dust estrutura a ingestão de dados e a governança de acesso. O Dust separa o mecanismo de ingestão da autorização de usuários por meio de três camadas distintas: Conexões (Connections), Espaços (Spaces) e Assistentes (Assistants).

Conexões versus Espaços

Uma Conexão (Connection) representa a integração técnica entre o Dust e uma plataforma de software de terceiros (como Google Workspace, Notion ou Slack). Configurada por um administrador do workspace, uma conexão gerencia a autenticação de API, os webhooks e a sincronização contínua de dados.

Um Espaço (Space) é um contêiner lógico dentro do Dust que armazena dados e documentos sincronizados. Em vez de despejar todas as informações da empresa em um único repositório desestruturado, os administradores criam Espaços separados para refletir os limites organizacionais. O Dust oferece dois tipos de Espaços:

• Espaços Abertos (Open Spaces): Acessíveis a todos os membros do workspace do Dust. São ideais para materiais corporativos gerais, como manuais do colaborador, documentação de produtos, diretrizes de marca e comunicados públicos.
• Espaços Restritos (Restricted Spaces): Acessíveis apenas a membros específicos da equipe ou grupos de segurança sincronizados a partir de um provedor de identidade (IdP). São reservados para dados confidenciais, como planejamento executivo, contratos jurídicos, registros de recursos humanos ou modelos financeiros.

O modelo de permissões em duas camadas

O Dust adota um modelo de segurança em duas camadas para evitar a exposição não autorizada de dados em fluxos de trabalho automatizados:

1. Acesso do agente aos dados (Agent-to-Data Access): Ao construir um assistente, o criador seleciona quais Espaços o assistente pode pesquisar. O assistente herda o acesso a todos os dados armazenados nos Espaços atribuídos.
2. Acesso do usuário ao agente (User-to-Agent Access): Por padrão, um membro da equipe só pode interagir com um assistente se tiver permissão para acessar todos os Espaços vinculados a ele. Se um assistente fizer referência tanto a um Espaço Aberto quanto a um Espaço Restrito de RH, um funcionário fora do grupo de RH não poderá conversar com esse assistente, prevenindo vazamentos acidentais de dados.

Práticas recomendadas para contas de serviço

Ao estabelecer conexões, evite usar contas pessoais de funcionários. Se um funcionário se desligar da empresa ou se suas credenciais expirarem, os pipelines de dados conectados podem parar de funcionar de forma inesperada. Em vez disso, provisione uma conta de serviço administrativa dedicada — como dust-admin@suaempresa.com — com permissões adequadas de visualização em nível de workspace no Google Workspace, Notion e Slack antes de autorizar as conexões no Dust.

Conectando as principais fontes de dados corporativos

A configuração de integrações no Dust requer credenciais de administrador tanto no Dust quanto no aplicativo de destino. No painel do Dust, navegue até Spaces > Connections para iniciar a configuração de cada plataforma.

Google Drive

Conectar o Google Drive permite que os assistentes pesquisem e extraiam contexto do Google Docs, Sheets, Slides e de arquivos PDF carregados.

1. Autenticação (Authentication): No menu Connections, selecione Google Drive e clique em Connect. Faça login usando sua conta de administrador dedicada e conceda ao Dust acesso somente leitura ao conteúdo do drive do Google Workspace.
2. Definição do escopo de pastas e drives (Scoping Folders and Drives): O Dust permite a seleção granular de pastas. Você pode selecionar drives compartilhados inteiros (Shared Drives, recomendados para departamentos colaborativos) ou pastas aninhadas específicas dentro do Meu Drive (My Drive). Evite sincronizar drives pessoais de usuários ou pastas raiz desorganizadas.
3. Indexação e tempo de sincronização (Indexing and Sync Time): Após a autorização, o Dust começa a indexar o conteúdo dos arquivos e a gerar embeddings vetoriais (vector embeddings). Enquanto documentos baseados em texto do Google Docs são processados rapidamente, drives grandes contendo dezenas de milhares de arquivos ou PDFs extensos podem levar várias horas para concluir a sincronização inicial.
4. Atribuição a Espaços (Assigning to Spaces): Após a conclusão da sincronização de dados, navegue até o Espaço de destino (por exemplo, "Engineering Knowledge" ou "Company General") e adicione as pastas relevantes do Google Drive a esse Espaço.

Notion

A integração com o Notion permite que os assistentes consultem wikis de equipes, rastreadores de projetos, documentos de requisitos de produtos (PRDs) e bancos de dados estruturados.

1. Autorização (Authorization): Selecione Notion no diretório de Connections. A tela de autorização do Notion solicitará que você selecione o workspace do Notion e aprove a integração.
2. Seleção de páginas e bancos de dados (Page and Database Selection): A estrutura de permissões do Notion exige a concessão explícita de acesso da integração do Dust às páginas de nível superior. Selecione as páginas pai ou os bancos de dados de equipe que deseja sincronizar. O Dust indexa automaticamente as subpáginas filhas aninhadas sob as páginas pai autorizadas.
3. Sincronização de bancos de dados relacionais (Syncing Relational Databases): O Dust indexa as propriedades do banco de dados e o conteúdo do corpo da página. Para bancos de dados complexos com relações vinculadas, certifique-se de que todos os bancos de dados referenciados sejam compartilhados com a integração do Dust para manter a integridade dos dados nas respostas dos assistentes.
4. Atualizações contínuas (Continuous Updates): O Dust monitora edições de páginas e atualizações de bancos de dados, atualizando seu índice de busca interno de forma incremental à medida que sua equipe altera a documentação no Notion.

Slack

Integrar o Slack adiciona o contexto de conversas, tópicos de solução de problemas e histórico de comunicados ao ecossistema interno de IA.

1. Instalação do aplicativo Dust Slack (Installing the Dust Slack App): Selecione Slack na exibição Connections e autorize o aplicativo Dust Slack para o workspace do Slack da sua organização.
2. Definição do escopo de canais públicos (Scoping Public Channels): Durante a configuração, escolha quais canais públicos o Dust deve indexar. Dê prioridade a canais com valor de conhecimento contínuo, como #announcements, #product-updates, #customer-feedback ou #engineering-help. Exclua canais com muito ruído, como #random ou #social.
3. Tratamento de canais privados (Handling Private Channels): Por questões de segurança, o Dust não indexa canais privados automaticamente. Para incluir o conhecimento de um canal de projeto privado, um administrador ou proprietário do canal deve convidar o bot manualmente digitando /invite @Dust.
4. Contexto de threads de mensagens (Message Threading Context): O Dust captura os tópicos das conversas para que os assistentes compreendam todo o contexto de perguntas e respostas, em vez de avaliar mensagens isoladas fora de contexto.

Guia passo a passo: Construindo assistentes internos personalizados

Com as fontes de dados conectadas e organizadas em Espaços, você pode criar assistentes de IA personalizados para funções de negócios específicas.

Passo 1: Definir identidade e função

Navegue até a tela inicial do Dust e selecione Create Agent (ou Assistant). Estabeleça atributos claros de identificação:

• Name: Dê ao assistente um nome intuitivo que reflita sua especialização (por exemplo, SalesEnablement, TechDocsBot, PeopleOpsGuide).
• Handle: Defina um identificador curto para menções (por exemplo, @sales-help).
• Description: Forneça um resumo preciso em uma única frase sobre o que o assistente faz. O Dust utiliza essa descrição para rotear perguntas genéricas ao agente mais qualificado quando os usuários consultam o orquestrador padrão @dust.

Passo 2: Escolher o modelo de fundação subjacente

O Dust oferece flexibilidade de modelos, permitindo que os criadores escolham o melhor modelo de fundação para a complexidade e os requisitos de latência do assistente:

Passo 3: Criar instruções do sistema e salvaguardas

O campo de instruções (instructions) rege o comportamento, o tom, a metodologia de raciocínio e as respostas de fallback do assistente. Instruções eficazes seguem um modelo de prompt estruturado:

You are the internal People Operations Assistant for Acme Corp.
Your role is to help employees understand company policies, benefits, and workplace guidelines based exclusively on verified internal documents.

Guidelines:
1. Always base your answers on information retrieved from the connected Notion "People Wiki" and Google Drive "HR Policies" folders.
2. If a policy document does not contain the answer, state clearly: "I cannot find documentation on this topic in our verified HR spaces. Please consult the People team directly in #ask-people."
3. Never speculate or fabricate company rules, leave allowances, or compensation details.
4. When explaining multi-step procedures (e.g., submitting expense reports or requesting parental leave), provide clear numbered steps and cite the title of the source document.

Passo 4: Anexar conhecimento e configurar a recuperação

Na seção Tools & Knowledge do construtor de assistentes:

1. Selecionar fontes de dados (Select Data Sources): Clique em Add Knowledge e escolha os Espaços ou pastas conectadas específicas relevantes para o assistente. Por exemplo, um assistente de suporte ao cliente deve ser vinculado à base de conhecimento do Zendesk, às páginas de solução de problemas do Notion e ao canal #support-resolved do Slack.
2. Adicionar descrições das fontes (Add Source Descriptions): Forneça uma breve nota explicando o conteúdo de cada fonte anexada. Isso ajuda o assistente a decidir qual base de conhecimento consultar primeiro ao responder a perguntas com múltiplas partes.
3. Configurar ferramentas adicionais (Configure Additional Tools): Se desejar, ative recursos auxiliares como navegação na web em tempo real, cálculos de tabelas ou ações personalizadas de API.

Passo 5: Testar e iterar

Utilize o painel de visualização interativo no lado direito do construtor para testar o assistente antes de publicá-lo:

• Testar perguntas padrão (Test Standard Inquiries): Faça perguntas comuns para verificar se o assistente recupera os documentos corretos e os resume com precisão.
• Testar casos extremos e consultas negativas (Test Edge Cases and Negative Queries): Faça perguntas sobre tópicos fora do escopo do assistente para garantir que suas salvaguardas evitem alucinações e disparem devidamente os avisos de fallback.
• Inspecionar trechos recuperados (Inspect Retrieved Chunks): Verifique as citações de referência abaixo da resposta de visualização para confirmar se o Dust está extraindo os trechos de documentos relevantes do Notion, Drive ou Slack.

Implantando assistentes para usuários finais nas ferramentas de trabalho

Construir assistentes no Dust é apenas metade do processo; a adoção generalizada depende de disponibilizá-los nos aplicativos que os membros da equipe já usam diariamente.

Integração com o Slack

O aplicativo Dust Slack leva os assistentes diretamente aos canais de comunicação diários:

• Menções diretas em canais (Direct In-Channel Mentions): Em qualquer canal em que o aplicativo Dust estiver instalado, os usuários podem chamar um assistente específico digitando @dust +AssistantName seguido de sua pergunta (por exemplo, @dust +TechDocsBot How do we configure local staging environments?).
• Respostas em threads (Threaded Answers): O Dust publica sua resposta diretamente na conversa em thread, mantendo a organização do canal e permitindo que todos os participantes tenham acesso ao contexto.
• Assistente corporativo padrão (Default Company Assistant): Consultar @dust sem especificar um agente aciona o assistente corporativo padrão, que pesquisa em toda a documentação aberta da organização.

Workspace web do Dust e colaboração multiagente

Para pesquisas mais profundas, os colaboradores podem usar a interface web do Dust (dust.tt):

• Conversas multiagente (Multi-Agent Conversations): Os usuários podem acionar múltiplos assistentes em um único tópico de discussão. Por exemplo, um gerente de produto pode mencionar @TechDocsBot para explicar uma restrição de arquitetura e, na sequência, acionar @SalesEnablement para traduzir esse detalhe técnico em um benefício voltado ao cliente.
• Citações de fontes (Source Citations): Cada resposta no workspace web inclui citações clicáveis que direcionam os usuários à página exata do Notion, ao parágrafo do Google Docs ou à mensagem do Slack de onde se originou a informação.

Extensão para navegador

A extensão de navegador do Dust permite que os usuários consultem seus assistentes a partir de qualquer página web, permitindo que os membros da equipe consultem políticas corporativas ou o contexto de clientes em aplicativos web sem precisar alternar entre abas.

Governança corporativa, segurança e higiene do conhecimento

Para manter alta precisão nas respostas e proteger a privacidade corporativa ao longo do tempo, as organizações devem implementar uma governança operacional contínua.

Combatendo a síndrome do «pântano de dados»

As respostas de um assistente de IA são tão confiáveis quanto as fontes de conhecimento nas quais ele se baseia:

• Eliminar documentos obsoletos (Prune Stale Documents): Audite periodicamente pastas conectadas do Google Drive e páginas do Notion. Arquive documentos de políticas obsoletos, especificações antigas de produtos e guias desatualizados de procedimentos para evitar que os assistentes citem informações caducas.
• Manter fontes de referência confiáveis (Curate Canonical Sources): Mantenha fontes únicas da verdade para as principais diretrizes. Se as regras de férias existirem em um PDF de 2022 e em uma página do Notion de 2026, remova ou desconecte o documento mais antigo.
• Indexação seletiva do Slack (Selective Slack Indexing): Não conecte canais de bate-papo geral nos quais prevaleçam opiniões não verificadas ou discussões especulativas. Indexe apenas os canais onde são publicadas decisões oficiais e resoluções comprovadas.

Privacidade de dados e padrões de conformidade

Os dados corporativos conectados ao Dust permanecem isolados e protegidos sob rigorosos controles de segurança:

• Zero treinamento de modelos (Zero Model Training): Os contratos do Dust com os provedores de modelos (como Anthropic, OpenAI e Mistral) garantem que os dados corporativos e os prompts de clientes nunca sejam usados para treinar ou fazer fine-tuning de modelos de fundação públicos.
• Auditoria de acesso (Access Auditing): Os administradores corporativos têm acesso aos logs de auditoria do workspace, mostrando quais usuários consultaram quais assistentes e quais fontes de dados foram consultadas.
• Autenticação corporativa (Enterprise Authentication): As organizações podem impor logon único (SSO) baseado em SAML e provisionamento via SCIM por meio de provedores de identidade como Okta ou Google Workspace, garantindo que o desligamento de colaboradores revogue imediatamente o acesso a todos os assistentes e Espaços.