Conecte ferramentas e fontes externas

Conecte fontes de dados externas a uma conversa de chat no Genie One para pesquisar nos documentos e dados da sua empresa ao responder a perguntas. Cada usuário se autentica individualmente. Os tokens OAuth não são compartilhados entre os usuários.

Essas conexões usam conectores MCP fornecidos pelo Databricks, portanto, não há servidor para hospedar nem aplicativo OAuth para registrar. O Databricks rege todas as conexões por meio do Unity Catalog e do Unity Gateway. O gateway autoriza cada chamada de ferramenta em relação às suas permissões do Unity Catalog, aplica políticas integradas e requisitos de aprovação, e registra logs de uso e de auditoria em tabelas do sistema. Consulte Registrar um servidor MCP externo.

As conexões compatíveis incluem:

• Google Drive : pesquise e crie Google Docs, Planilhas e Apresentações; edite os Docs criados por ele.
• Gmail : pesquise, leia e rascunhe email.
• Google Calendar : pesquise e crie eventos de calendário.
• Microsoft 365 : pesquise no SharePoint, Teams, Outlook e Calendário; rascunhe um email do Outlook.
• Atlassian : Pesquise e atualize o Jira e o Confluence.
• Glean (Beta): Pesquise nos aplicativos conectados da sua organização usando o Glean.
• Slack : pesquise mensagens e canais do Slack e envie mensagens.
• GitHub : Pesquise e atualize repositories, issues e pull requests.

Conecte-se a uma fonte de dados externa

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 mais fontes de dados, clique em Mais conexões na parte inferior da lista. Você pode criar uma conexão MCP personalizada no Unity Catalog. Consulte Usar servidores MCP externos.

3. Clique em Entrar e conclua os passos para fazer login.

A conexão foi adicionada à sua conversa. O chat agora pode pesquisar em seus documentos ao responder perguntas. Após a criação de uma conexão, os administradores de metastore e os proprietários da conexão podem gerenciar ou revogar as permissões de usuário nela. Consulte o passo 4. Conceder acesso a um serviço MCP.

nota

As ferramentas de fonte de dados podem nem sempre ser acionadas automaticamente. Se a pesquisa de documentos não começar, tente solicitar explicitamente ao chat para usar a ferramenta, por exemplo, "use o Google Drive" ou "use o SharePoint."

Ações de gravação

Algumas ferramentas MCP conectadas podem realizar ações de gravação no aplicativo de origem, não apenas pesquisar e ler dados. Se uma conexão pode gravar, e quais ações ela pode realizar, depende da ferramenta, dos escopos OAuth aos quais você consente ao se conectar e de suas próprias permissões no aplicativo de origem.

Escopos OAuth

Ao conectar uma fonte de dados externa, o 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 realizar 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 de suas próprias permissões no aplicativo de origem.

O Databricks gerencia as credenciais OAuth para essas conexões. Para obter a lista completa de escopos que cada provedor OAuth gerenciado solicita e a finalidade de cada escopo, consulte Serviços externos com OAuth gerenciado. O conjunto exato de escopos solicitados para uma conexão aparece na tela de consentimento do provedor ao conectar.

Limitações

Para orientações de compliance sobre aplicativos conectados, consulte Limitações do serviço MCP fornecido pela Databricks.

As conexões externas estão disponíveis apenas em regiões onde o Unity Gateway é suportado.

Consulte regiões compatíveis.

Tarefas programadas e autenticação

• O chat não avisa quando a autenticação de uma conexão expira. Você só descobre quando uma chamada de ferramenta falha ou quando abre a lista de conexões. Autentique-se novamente para resolver.
• A alteração das permissões de uma conexão exige que cada usuário se autentique novamente. As tarefas agendadas que usam a conexão falham até que o usuário se autentique novamente.

Google Drive

• Ao autorizar o Google Drive, poderá ser exibida uma tela de 'aplicativo não verificado'. Clique em Avançado e continue o processo de autorização.
• Maximum file size is 25 MB.
• Apenas arquivos nativos do Google Workspace (Docs, Sheets, Slides) são compatíveis. PDFs, imagens e outros formatos binários não são compatíveis.
• O chat pode criar Google Docs, Planilhas do Google e Apresentações, e editar o Google Docs criado por ele por meio do conector. Ele não pode editar Docs criados fora do conector, nem editar Planilhas ou Apresentações existentes.
• Ler um documento muito grande pode ser lento.

nota

O uso e a transferência de dados de usuário brutos ou derivados recebidos das APIs do Google Workspace aderirão à Política de Dados de Usuário dos serviços da API do Google, incluindo os requisitos de Uso Limitado.

Gmail

• O Chat pode pesquisar, ler e redigir email, mas não pode enviar email ou editar mensagens existentes.
• Chat can't add Drive files as native Gmail attachments. Como alternativa, inclua links para os arquivos no corpo do email.

Microsoft 365

• Inclui SharePoint, Teams, Outlook e Calendar.
• Chat can draft Outlook email but can't send it.
• O tamanho máximo do arquivo é de 25 MB para arquivos do SharePoint.
• Os tipos de arquivo SharePoint suportados incluem documentos SharePoint integrados, planilhas e apresentações, bem como formatos comuns baseados em texto, como .txt, .csv, .json, .md e outros. PDFs, imagens e outros formatos binários não são compatíveis.

Glean (Beta)

• Glean é apenas de pesquisa. Ele não consegue ler um documento de um Link direto.
• Um administrador do 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 o ID do tenant ao conectar-se ao Glean pela primeira vez.
• Para se conectar a um servidor Glean MCP específico, um administrador de 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 default (/mcp/default). Usuários não administradores não podem especificar ou alterar o caminho do servidor Glean MCP.

Slack

• O chat não pode editar ou excluir uma mensagem após o envio.

GitHub

• As gravações são limitadas a conteúdos de arquivos, problemas (issues) e solicitações pull (pull requests).
• Por padrão, o conector MCP do Databricks GitHub pode acessar apenas repositórios públicos. Para conceder ao conector acesso de leitura aos seus repositórios corporativos privados, um administrador da organização do GitHub deve concluir uma configuração adicional. Consulte Habilitar acesso a repositório privado.
• Servidor corporativo GitHub (a versão auto-hospedada do GitHub) não é suportado.

Conexão MCP personalizada

• A Databricks recomenda o uso de OAuth machine-to-machine (M2M) ao configurar a conexão. O OAuth U2M requer configuração adicional para registrar a URI de redirecionamento do workspace em um aplicativo OAuth personalizado.
• A conexão deve ser criada antes de ser adicionada a uma conversa de chat.