Liga-te a ferramentas e fontes externas

Pode ligar fontes de dados externas a uma conversa de chat no Genie One. Isto permite que o chat pesquise documentos e dados da sua empresa ao responder a perguntas. Cada utilizador autentica-se individualmente. Os tokens OAuth não são partilhados entre utilizadores.

As ligações suportadas incluem:

• Google Drive: Pesquisar Google Docs, Sheets e Slides.
• Gmail: Pesquise conteúdo de email.
• Microsoft 365: Pesquise em SharePoint, Teams, Outlook e Calendário.
• Atlassian: Pesquisa em Jira e Confluence.
• Glean: Pesquise entre as aplicações ligadas da sua organização através do Glean.
• Slack: Pesquise mensagens e canais do Slack.

Ligue uma fonte de dados externa

Ligar fontes de dados externas requer que os Third Party Connectors for Agents Beta estejam ativados no seu espaço de trabalho. Ver Gerir as pré-visualizações de Azure Databricks.

1. Na página inicial do Genie One, clique no Ícone Plus no canto inferior esquerdo da barra de pesquisa.

2. Selecione uma fonte de dados.

   Para ligar fontes de dados adicionais, clique em Mais ligações no final da lista. Pode criar uma ligação MCP personalizada no Unity Catalog. Consulte Usar servidores MCP externos.

3. Clique em Iniciar sessão e complete os passos para iniciar sessão.

A ligação é adicionada à tua conversa. O chat pode agora pesquisar os seus documentos ao responder a perguntas. Após a criação de uma ligação, os administradores da metastore e os proprietários da ligação podem gerir ou revogar permissões de utilizador sobre ela. Ver Passo 4. Conceder acesso a um Serviço MCP.

Escrever ações

Algumas ferramentas MCP ligadas conseguem realizar ações de escrita na aplicação de origem, não apenas pesquisar e ler dados. Se uma ligação pode escrever, e que ações pode realizar, depende da ferramenta, do âmbito OAuth a que consente quando se liga, e das suas próprias permissões na aplicação de origem.

Escopos OAuth

Quando liga uma fonte de dados externa, o seu fornecedor pede-lhe que consinta com um conjunto de escopos OAuth. Os âmbitos definem o conjunto máximo de ações que uma conexão pode tentar em seu nome. Cada utilizador consente individualmente, e o conteúdo a que uma ligação pode aceder ainda depende de como a sua organização configura a ligação e das suas próprias permissões na aplicação de origem.

Azure Databricks gere as credenciais OAuth para estas conexões. Para a lista completa de objetivos que cada fornecedor OAuth gerido solicita e o propósito de cada âmbito, veja Serviços externos com OAuth gerido. O conjunto exato de âmbitos solicitado para uma ligação aparece no ecrã de consentimento do fornecedor quando estabelece a ligação.

Limitations

As ligações externas só estão disponíveis em regiões onde o Model Serving é suportado.

Ver regiões suportadas.

Google Drive

• Ao autorizar o Google Drive, pode ver um ecrã de "aplicação não verificada". Clique em Avançado e continue o processo de autorização.
• O tamanho máximo do ficheiro é 10MB.
• Só são suportados ficheiros integrados do Google Docs. PDFs, imagens e outros formatos binários não são suportados.
• Erros de expiração de sessão ou de token podem aparecer na saída do agente. Re-autenticar na ligação para resolver.

Gmail

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

Microsoft 365

• Inclui SharePoint, Teams, Outlook e Calendário.
• O tamanho máximo do ficheiro é de 10MB para ficheiros SharePoint.
• Os tipos de ficheiros SharePoint suportados incluem documentos SharePoint incorporados, folhas de cálculo 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 suportados.

Atlassian

• Inclui Jira e Confluence.
• Um administrador de espaço de trabalho deve configurar a ligação Atlassian antes que utilizadores não administradores possam usá-la.

Glean

• Um administrador da metastore deve primeiro configurar o ID do tenant Glean antes de utilizadores não administradores poderem usar a ligação. O administrador pode introduzir o ID do inquilino ao ligar-se pela primeira vez ao Glean.
• Para se ligar a um servidor MCP Glean específico, um administrador da metastore pode opcionalmente definir o caminho do servidor MCP (por exemplo, /mcp/eng) ao configurar a ligação. Deixe este campo em branco para usar o caminho padrão (/mcp/default). Os utilizadores não administradores não podem especificar ou alterar o caminho do servidor Glean MCP.

GitHub

• Por defeito, o conector GitHub MCP do Databricks só pode aceder a repositórios públicos. Para dar ao conector acesso de leitura aos repositórios privados da sua empresa, um administrador da organização do GitHub tem de concluir passos de configuração adicionais. Ver Ativar acesso a repositórios privados.
• O GitHub Enterprise Server (a versão auto-hospedada do GitHub) não é suportado.

Ligação MCP personalizada

• O Databricks recomenda o uso de OAuth máquina-a-máquina (M2M) ao configurar a ligação. O U2M OAuth requer uma configuração adicional para registar o URI de redirecionamento do workspace numa aplicação OAuth personalizada.
• A ligação deve ser criada antes de a poder adicionar a uma conversa de chat.