Conecte um Genie Agent a ferramentas e fontes externas

Um Agente Genie pode usar conectores MCP (Model Context Protocol) fornecidos pelo Databricks para extrair contexto e realizar ações em ferramentas e fontes externas durante uma conversa em modo Agente . Um autor do agente anexa os conectores e cada usuário autentica-os individualmente. Cada chamada de ferramenta é executada com as permissões do usuário que faz a pergunta.

Importante

Esse recurso está em Beta. Para usá-lo, um administrador de espaço de trabalho deve ativar as ferramentas MCP no Genie Agents a partir da página de Prévias . Consulte Gerenciar visualizações do Azure Databricks.

Note

Os Agentes Genie eram anteriormente conhecidos como Genie Spaces.

Como funcionam os conectores MCP em um Genie Agent

Conectores MCP permitem que um Agente Genie combine seu SQL e análise de arquivos com as aplicações externas que sua organização já utiliza. Por exemplo, uma única conversa pode analisar uma tabela de vendas, extrair contexto relacionado do Google Drive e redigir um e-mail resumo. O Azure Databricks governa cada chamada de ferramenta através do Unity Catalog e do Unity Gateway. Veja Governar um MCP.

As ferramentas MCP se dividem em duas categorias:

  • Ferramentas somente leitura (pesquisa, busca e lista) são executadas automaticamente.
  • Ferramentas de escrita (por exemplo, enviar uma mensagem ou redigir um e-mail) pausam e pedem ao usuário que aprove a ação antes que ela seja executada.

Os Agentes Genie suportam os seguintes conectores MCP fornecidos pelo Databricks:

  • Google Drive: Buscar e criar Google Docs, Sheets e Slides; editar Docs que ele criou.
  • Gmail: Pesquisar, ler e rascunhar e-mails.
  • Google Calendário: Pesquise e crie eventos no calendário.
  • Microsoft 365: Pesquise em SharePoint, Teams, Outlook e Calendário; rascunhe o e-mail do Outlook.
  • Atlassian: Busque e atualize Jira e Confluence.
  • Glean (Beta): Pesquise entre os aplicativos conectados da sua organização usando o Glean.
  • Slack: Pesquise mensagens e canais do Slack e envie mensagens.
  • GitHub: Pesquisar e atualizar repositórios, issues e pull requests.

Requirements

Os seguintes requisitos se aplicam ao agente e seus usuários:

  • Tanto o acesso ao Workspace quanto as permissões de acesso ao Databricks SQL para cada usuário do agente. Usuários somente consumidores, somente do Databricks SQL e somente da conta não podem usar ferramentas MCP. Consulte os direitos de acesso.
  • Uma conta em cada sistema externo conectado para cada usuário do agente.

Adicionar conectores a um Genie Agent

Para conectar conectores a um Agente Genie:

  1. Abra seu Genie Agent.
  2. Abra a guia Fontes e clique em Adicionar.
  3. Selecione um ou mais Serviços MCP.

Para anexar um conector, você precisa de EXECUTE no serviço MCP do conector no Catálogo do Unity, além de USE CATALOG e USE SCHEMA em seu catálogo principal e esquema. Conectores que você não tem permissão para rodar não estão disponíveis. Veja MCPs fornecidos pelo Databricks.

Configurar ferramentas

Depois de conectar um conector, configure como o agente o utiliza:

  • Adicione uma descrição clara que explique como e quando o agente deve usar as ferramentas do conector. Por exemplo, você pode instruir o agente sobre um formato obrigatório de título de ticket ou pedir para ele consultar o perfil de um usuário no início de cada conversa.
  • Ative ou desative ferramentas individuais dentro de um conector para definir quais ações o agente pode realizar.

Use ferramentas MCP em uma conversa

Para usar ferramentas MCP em um Genie Agent:

  1. Abra um Genie Agent que tenha conectores MCP conectados.
  2. Ative o modo Agente na caixa de chat.
  3. Autentique-se no conector no painel Configurar. Se o agente precisar de um conector que você não autorizou, ou se sua autenticação expirou, o agente pede para você fazer login.
  4. Envie um prompt que use o conector. Quando o agente chamar uma ferramenta de escrita, escolha Permitir uma vez para aprovar a ação única, Sempre permitir neste chat para aprovar essa ferramenta pelo restante da conversa, ou Rejeitar para recusá-la.

Para confirmar que um conector funciona, faça uma pergunta que o exija por exemplo: "Pesquise no meu Google Drive pelo plano de vendas do terceiro trimestre." O agente cita o recurso externo que usou em sua resposta.

Limitations

As seguintes limitações se aplicam:

  • As ferramentas MCP rodam apenas no modo Agent. Eles não rodam no modo Chat.
  • Através das APIs do modo Agente, só as ferramentas de leitura funcionam, e os usuários não podem se autenticar em um conector. Conclua a autenticação e a aprovação da ferramenta de escrita na interface.
  • Para orientações de conformidade para aplicações conectadas, veja Requisitos de fornecedores externos.

As seções a seguir descrevem limitações para conectores específicos.

Google Drive

  • Ao autorizar o Google Drive, você pode ver uma tela de aplicativo Não Verificado . Clique em Avançado e continue o processo de autorização.
  • O arquivo pode ter no máximo 25 MB.
  • Há suporte apenas para arquivos nativos do Google Workspace (Docs, Planilhas, Slides). PDFs, imagens e outros formatos binários não têm suporte.
  • O conector pode criar Google Docs, Sheets e Slides, e editar o Google Docs que criou. Ele não pode editar documentos criados fora do conector, nem editar Sheets ou Slides existentes.
  • Ler um documento muito grande pode ser lento.

Note

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 do Usuário dos serviços de API do Google, incluindo os requisitos de Uso Limitado.

Gmail

  • O conector pode buscar, ler e rascunhar e-mails, mas não pode enviar e-mails nem editar mensagens existentes.
  • 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 e-mail.

Microsoft 365

  • Inclui SharePoint, Teams, Outlook e Calendário.
  • O conector pode rascunhar emails do Outlook, mas não pode enviá-los.
  • O tamanho máximo do arquivo é de 25 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.

Glean (Beta)

  • Glean é somente para pesquisa. Ele não pode ler um documento a partir de um link direto.
  • 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.

Slack

  • O conector não pode editar ou excluir uma mensagem após enviá-la.

GitHub

  • As gravações são limitadas ao conteúdo dos arquivos, problemas e solicitações de pull.
  • 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. Veja Habilitar acesso de escrita no GitHub e acesso a repositórios privados.
  • GitHub Enterprise Server (a versão auto-hospedada do GitHub) não tem suporte.

Recursos adicionais

Consulte os seguintes recursos para obter informações relacionadas:

  • Última atualização em