Pular para o conteúdo principal
Última atualização em

Conectar um Genie Agent a ferramentas e fontes externas

Um Genie Agent pode usar conectores MCP (Model Context Protocol) fornecidos pelo Databricks para extrair contexto e executar ações em ferramentas e fontes externas durante uma conversa no modo de agente. Um autor do agente anexa os conectores, e cada usuário se autentica neles individualmente. Todas as chamadas de ferramentas têm execução com as permissões do usuário que faz a pergunta.

info

Beta

Esse recurso está em Beta. Para usá-lo, um administrador do workspace deve ativar a opção Connect external tools in Genie Agents na página Previews . Consulte Gerenciar prévias do Databricks.

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.

As ferramentas MCP se enquadram em duas categorias:

  • As ferramentas somente de leitura (pesquisar, buscar e listar) entram em execução automaticamente.
  • As ferramentas de gravação (por exemplo, enviar uma mensagem ou redigir um email) fazem uma pausa e solicitam que o usuário aprove a ação antes de sua execução.

Genie Agents support the following Databricks-provided MCP connectors:

  • 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.
  • 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.

Requisitos​

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

  • Unity Catalog habilitado em seu workspace.

  • O modo agente está disponível na sua região. Consulte Disponibilidade regional.

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

  • Os direitos de acesso ao Workspace e de acesso ao Databricks SQL para cada usuário do agente. Usuários exclusivos de consumo, exclusivos de Databricks SQL e exclusivos de account não podem usar as ferramentas do MCP. Consulte Direitos de acesso.

  • An account in each connected external system for every user of the agent.

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.

Para anexar um conector, você precisa de EXECUTE no Serviço MCP do conector no Unity Catalog, além de USE CATALOG e USE SCHEMA no catálogo pai e no esquema dele. Conectores que você não tem permissão para executar estão indisponíveis. Consulte MCPs fornecidos pela Databricks.

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. Ative o modo Agente na caixa de bate-papo.
  3. Autentique-se no conector a partir do painel Configure . Se o agente precisar de um conector que você não autorizou ou se sua autenticação tiver expirado, o agente solicitará que você faça login.
  4. Envie um prompt que use o conector. Quando o agente chamar uma ferramenta de gravação, escolha Allow once para aprovar a ação única, Always allow in this chat para aprovar essa ferramenta pelo resto da conversa ou Reject para recusá-la.

Para confirmar se um conector funciona, faça uma pergunta que o exija, por exemplo "Search my Google Drive for the Q3 ventas plan." O agente cita o recurso externo usado em sua resposta.

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.
  • Por meio das APIs do modo agente, apenas ferramentas de leitura funcionam e os usuários não podem se autenticar em um conector. Conclua a autenticação e a aprovação de ferramentas de gravação na interface do usuário.
  • 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, Teams, Outlook e Calendário.
  • 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 pode acessar apenas repository públicos. Para conceder 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.
  • 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:

Nesta página