Conecte o Genie One a ferramentas e origens 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.

These connections use Databricks-provided MCP connectors, so there's no server to host and no OAuth app para registro. Databricks governs every connection through Unity Catalog and Unity Gateway. The gateway authorizes each tool call against your Unity Catalog permissions, applies políticas integradas and approval requirements, and records usage and audit logs in system tables. Veja Servidores MCP externos.

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.

nota

Para usar esses conectores em um Genie Agent em vez do Genie One, consulte Connect a Genie Agent to external tools and sources.

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.

   To connect additional fontes de dados, click More connections at the bottom of the list. You can create a custom MCP serviço in Unity Catalog. See External MCP servers.

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

The connection is added to your conversation. Chat can now search your documents when answering questions. See Share an 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 ver a lista completa de escopos que cada provedor OAuth gerenciado solicita e a finalidade de cada escopo, consulte Provedores OAuth gerenciados. O conjunto exato de escopos solicitados para uma conexão aparece na tela de consentimento do provedor quando você se conecta.

Para obter orientações de compliance para aplicativos conectados, consulte Requisitos do provedor externo.

Limitações

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, você poderá ver uma tela de App 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 conector pode criar Google Docs, Planilhas e Apresentações, além de editar arquivos do Google Docs criados por ele. Ele não pode editar documentos 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

• The connector can search, read, and draft email, but it can't send email or edit existing messages.
• O conector não pode adicionar arquivos do Drive como anexos nativos do Gmail. Como solução alternativa, inclua links para os arquivos no corpo do email.

Microsoft 365

• Inclui SharePoint, Teams, Outlook e Calendar.
• O conector pode redigir um email do Outlook, mas não pode enviá-lo.
• 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 conector 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 default, o conector Databricks GitHub MCP pode acessar apenas repository públicos. Para dar ao conector acesso de leitura aos seus repository corporativos privados, um administrador da organização do GitHub deve concluir a configuração adicional. Consulte repository privados do GitHub.
• Servidor corporativo GitHub (a versão auto-hospedada do GitHub) não é suportado.

Serviço MCP personalizado

Crie o serviço MCP antes de adicioná-lo a uma conversa de chat. Se o serviço usar OAuth por usuário, cada usuário deverá fazer login antes de usá-lo. Consulte Servidores MCP externos.