Pular para o conteúdo principal

Conectar um Genie Agent a ferramentas e fontes MCP

Um Genie Agent pode usar ferramentas MCP (Model Context Protocol) para extrair contexto de e tomar ações em ferramentas e fontes externas. Um autor de agente anexa conectores fornecidos pelo Databricks ou servidores MCP externos registrados no Unity Gateway. Os usuários podem então pedir ao agente para usar essas ferramentas em conversas no modo Agent.

nota

Os Genie Agents eram conhecidos anteriormente como Genie space.

Como os conectores MCP funcionam em um Genie Agent​

Os conectores MCP permitem que um Genie Agent combine sua análise de SQL e de arquivos com os aplicativos externos que sua organização já usa. Por exemplo, uma única conversa pode analisar uma tabela de ventas, extrair o contexto relacionado do Google Drive e redigir um resumo por email. O Databricks rege cada chamada de ferramenta por meio do Unity Catalog e do Unity Gateway. Consulte Governar um MCP.

Os agentes do Genie suportam dois tipos de fontes MCP:

  • Conectores fornecidos pelo Databricks : Conectores que o Databricks gerencia para aplicativos comuns. Os seguintes conectores estão disponíveis:

    • Google Drive : pesquise e crie Documentos, Planilhas e Apresentações Google; edite os Documentos criados por ele.
    • Google : Pesquise, leia e redija email.
    • Google Calendar : Search and create calendar events.
    • Microsoft 365 : pesquise no SharePoint, Teams, Outlook e Calendário; rascunhe um email do Outlook.
    • Atlassian : pesquise e atualize o Jira e o Confluence.
    • Asana : pesquise tarefas, projetos, portfólios, usuários e equipes e crie ou atualize tarefas quando ações de gravação forem permitidas.
    • 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 repository, problemas e solicitações pull.
  • Servidores MCP externos : servidores MCP auto-hospedados ou de terceiros que sua organização registra no Unity Gateway. Consulte Servidores MCP externos.

Requisitos​

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

  • Unity Catalog habilitado em seu workspace.

  • Modo agente disponível na sua região. Consulte Serviços designados do Databricks.

  • Unity Gateway disponível em sua região. Consulte as regiões compatíveis.

  • Usuários apenas com account não podem usar ferramentas MCP. Consulte Direitos de acesso.

  • Cada usuário deve ter uma account em cada ferramenta MCP conectada ou fonte de dados.

  • Para anexar um conector, o autor do agente precisa de EXECUTE no MCP dele, além de USE CATALOG e USE SCHEMA no catálogo pai e no esquema. Conectores que o autor não tem permissão de execução estão indisponíveis. Consulte Compartilhar um MCP.

Adicionar conectores a um Genie Agent​

Para anexar conectores a um Genie Agent:

  1. Abra o seu Genie Agent.
  2. Abra o tab Sources e clique em Add .
  3. Selecione um ou mais serviços MCP. Você pode escolher conectores fornecidos pelo Databricks ou servidores MCP externos registrados no Unity Gateway.

Como os usuários se autenticam em um servidor MCP externo depende de suas credenciais:

  • OAuth por usuário : Cada usuário deve entrar antes que o agente possa usar as ferramentas do servidor.
  • Credenciais compartilhadas : os usuários não fazem login. Se a credencial compartilhada parar de funcionar, o agente informará ao usuário que o proprietário do servidor deve atualizá-la.

Configurar ferramentas​

Depois de anexar 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 de título de ticket obrigatório ou dizer a ele para procurar o perfil de um usuário ao começar de cada conversa.
  • Ative ou desative ferramentas individuais dentro de um conector para definir o escopo de quais ações o agente pode executar.

Use ferramentas MCP em uma conversa​

To use MCP tools in a Genie Agent:

  1. Abra um Genie Agent que tenha conectores MCP anexados.

  2. Certifique-se de que o modo de agente esteja ativado.

  3. Se um conector exigir login, autentique-se nele a partir da lista Fontes ou quando solicitado pelo agente.

    Se sua organização bloquear o login, consulte Configuração adicional de aplicativos de terceiros.

  4. Enviar um prompt que usa o conector.

Você também pode usar ferramentas MCP por meio das APIs do modo Agente. Se um conector exigir login, a resposta da API direciona o usuário para fazer login.

Obter aprovação de admin para conectores​

Os administradores do Slack, Google Workspace, Microsoft 365 ou GitHub podem precisar aprovar ou configurar o aplicativo Databricks antes que os usuários possam entrar. Para os passos de cada provedor, consulte Configuração adicional de aplicativos de terceiros.

Limitações​

Aplicam-se as seguintes limitações:

  • As ferramentas do MCP são executadas apenas no modo de agente. Eles não estão em execução no modo de chat.
  • Um Genie Agent pode ter até 10 conexões MCP, incluindo conectores fornecidos pelo Databricks e servidores MCP externos.
  • Service Principal não podem usar ferramentas MCP.
  • Para obter orientações sobre compliance para aplicativos conectados, consulte Requisitos de provedor externo.

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

Google Drive​

  • Ao autorizar o Google Drive, você poderá ver uma tela de aplicativo não verificado . Clique em Avançado e continue o processo de autorização.
  • O tamanho máximo do arquivo é de 25 MB.
  • Only native Google Workspace files (Docs, Sheets, Slides) are supported. PDFs, images, and other binary formats are not supported.
  • O conector pode criar Google Docs, Sheets e Slides, e editar o Google Docs que ele criou. Ele não pode editar Docs criados fora do conector nem editar Sheets ou Slides existentes.
  • A leitura de um documento muito grande pode ser lenta.
nota

O uso e a transferência de dados de usuário brutos ou derivados recebidos das Google Workspace APIs cumprirão a Política de dados do usuário dos serviços de API do Google, incluindo os requisitos de uso limitado.

Gmail​

  • O conector pode pesquisar, ler e redigir email, mas não pode enviar email ou editar mensagens existentes.
  • O conector não pode adicionar arquivos do Drive como anexos nativos do Gmail. Como alternativa, inclua links para os arquivos no corpo do email.

Microsoft 365​

  • Inclui SharePoint, OneDrive, Teams, Outlook, Calendar e reuniões online.
  • O conector pode redigir rascunhos de email do Outlook, mas não pode enviá-los.
  • O tamanho máximo do arquivo é de 25 MB para arquivos do SharePoint.
  • Os tipos de arquivos do SharePoint compatíveis incluem documentos, planilhas e apresentações integradas do SharePoint, 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)​

  • O Glean é somente de pesquisa. Ele não consegue ler um documento a partir 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 se conectar ao Glean pela primeira vez.
  • Para se conectar a um servidor Glean MCP específico, um administrador do 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​

  • The connector can't edit or delete a message after sending it.

GitHub​

  • As gravações são limitadas a conteúdos de arquivos, problemas e solicitações pull.
  • Por default, o conector Databricks GitHub MCP só pode acessar repository públicos. Para acessar repository privados, ou para fazer alterações como fazer commit de arquivos ou criar issues e pull requests, o proprietário do repository ou um administrador da organização do GitHub deve concluir a configuração adicional. Consulte Habilitar acesso de escrita e acesso de repository privado ao GitHub.
  • O GitHub Enterprise Server (a versão auto-hospedada do GitHub) não é compatível.

Additional recursos​

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