Conectar-se a ferramentas e fontes externas

Você pode conectar fontes de dados externas a uma conversa de chat no Genie One. Isso permite que o chat pesquise documentos e dados da sua empresa ao responder perguntas. Cada usuário é autenticado individualmente. Os tokens OAuth não são compartilhados entre os usuários.

As conexões com suporte incluem:

• Google Drive: pesquisar Google Docs, Planilhas e Slides.
• Gmail: pesquisar conteúdo de email.
• Microsoft 365: Pesquisar SharePoint, Equipes, Outlook e Calendário.
• Atlassian: Pesquisar Jira e Confluence.
• Glean: pesquise entre os aplicativos conectados da sua organização por meio do Glean.
• Slack: Pesquise mensagens e canais do Slack.

Conectar uma fonte de dados externa

Conectar fontes de dados externas requer que os Conectores de Terceiros para Agentes Beta sejam habilitados em seu workspace. Consulte Gerenciar visualizações do Azure Databricks.

1. Na página inicial do Genie One, clique no ícone de adição no canto inferior esquerdo da barra de pesquisa.

2. Selecione uma fonte de dados.

   Para conectar fontes de dados adicionais, clique em Mais conexões na parte inferior da lista. Você pode criar uma conexão MCP personalizada no Catálogo do Unity. Consulte Usar servidores MCP externos.

3. Clique em Entrar e conclua as etapas para entrar.

A conexão é adicionada à sua conversa. O chat agora pode pesquisar seus documentos ao responder a perguntas. Depois que uma conexão é criada, os administradores do metastore e os proprietários de conexão podem gerenciar ou revogar permissões de usuário nela. Veja o Passo 4. Conceda acesso a um Serviço MCP.

Ações de escrita

Algumas ferramentas MCP conectadas podem realizar ações de escrita na aplicação de origem, não apenas buscar e ler dados. Se uma conexão pode escrever, e quais ações ela pode tomar, depende da ferramenta, do escopo OAuth ao qual você consente quando você se conecta e das suas próprias permissões na aplicação de origem.

Escopos do OAuth

Quando você conecta uma fonte de dados externa, seu provedor solicita que você consinta com um conjunto de escopos OAuth. Os escopos definem o conjunto máximo de ações que uma conexão pode tentar em seu nome. Cada usuário consente individualmente, e o conteúdo que uma conexão pode acessar ainda depende de como sua organização configura a conexão e das suas próprias permissões no aplicativo de origem.

Azure Databricks gerencia as credenciais OAuth para essas conexões. Para a lista completa de escopos solicitados por cada provedor OAuth gerenciado e o propósito de cada escopo, veja Serviços externos com OAuth gerenciado. O conjunto exato de escopos solicitado para uma conexão aparece na tela de consentimento do provedor ao se conectar.

Limitações

As conexões externas só estão disponíveis em regiões em que o Serviço de Modelo tem suporte.

Consulte as regiões com suporte.

Google Drive

• Ao autorizar o Google Drive, você poderá ver uma tela "aplicativo não verificado". Clique em Avançado e continue o processo de autorização.
• O tamanho máximo do arquivo é de 10 MB.
• Há suporte apenas para arquivos internos do Google Docs. PDFs, imagens e outros formatos binários não têm suporte.
• Erros de expiração de conexão ou token podem aparecer na saída do agente. Reautentique na conexão para resolver.

Gmail

• O chat pode pesquisar e ler o conteúdo do email, mas não pode enviar ou modificar emails.

Microsoft 365

• Inclui SharePoint, Teams, Outlook e Calendário.
• O tamanho máximo do arquivo é de 10 MB para arquivos SharePoint.
• Os tipos de arquivo SharePoint com suporte incluem documentos, planilhas e apresentações SharePoint internos, bem como formatos comuns baseados em texto, como .txt, .csv, .jsone .mdoutros. PDFs, imagens e outros formatos binários não têm suporte.

Atlassian

• Inclui Jira e Confluence.
• Um administrador de workspace deve configurar a conexão Atlassian antes que os usuários não administradores possam usá-la.

Glean

• Um administrador da metastore deve primeiro configurar o ID do tenant do Glean antes que usuários não administradores possam usar a conexão. O administrador pode inserir a ID do locatário ao se conectar pela primeira vez ao Glean.
• Para se conectar a um servidor MCP específico da Glean, um administrador da metastore pode opcionalmente definir o caminho do servidor MCP (por exemplo, /mcp/eng) ao configurar a conexão. Deixe este campo em branco para usar o caminho padrão (/mcp/default). Usuários não administradores não podem especificar ou alterar o caminho do servidor MCP do Glean.

GitHub

• Por padrão, o conector do Databricks GitHub MCP pode acessar apenas repositórios públicos. Para conceder ao conector acesso de leitura aos repositórios privados da empresa, um administrador de uma organização do GitHub deve concluir uma configuração adicional. Consulte Habilitar acesso ao repositório privado.
• GitHub Enterprise Server (a versão auto-hospedada do GitHub) não tem suporte.

Conexão MCP personalizada

• O Databricks recomenda o uso do OAuth de máquina para máquina (M2M) ao configurar a conexão. O U2M OAuth requer uma configuração adicional para registrar o URI de redirecionamento do workspace em um aplicativo OAuth personalizado.
• A conexão deve ser criada antes que você possa adicioná-la a uma conversa de chat.