Ligue um Genie Agent a ferramentas e fontes externas

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

Como funcionam os conectores MCP num Agente Genie

Os conectores MCP permitem que um Agente Genie combine a sua análise SQL e de ficheiros com as aplicações externas que a 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 email resumo. O Azure Databricks governa todas as chamadas de ferramenta através do Unity Catalog e do Unity Gateway. Ver Govern an MCP.

As ferramentas MCP dividem-se em duas categorias:

• As ferramentas de apenas leitura (pesquisa, obtenção e listagem) funcionam automaticamente.
• As ferramentas de escrita (por exemplo, enviar uma mensagem ou redigir um email) fazem uma pausa e pedem ao utilizador que aprove a ação antes de esta ser executada.

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

• Google Drive: Pesquise e crie Google Docs, Sheets e Slides; edite os documentos que criar.
• Gmail: Pesquisar, ler e redigir email.
• Google Calendário: Pesquise e crie eventos no calendário.
• Microsoft 365: Pesquisar no SharePoint, no Teams, no Outlook e no Calendário; redigir e-mail no Outlook.
• Atlassian: Procura e atualiza Jira e Confluence.
• Glean (Beta): Pesquise entre as aplicações ligadas da sua organização usando o Glean.
• Slack: Pesquise mensagens e canais do Slack e envie mensagens.
• GitHub: Pesquisar e atualizar repositórios, problemas e pedidos de integração.

Requirements

Os seguintes requisitos aplicam-se ao agente e aos seus utilizadores:

• Unity Catalog ativado no teu espaço de trabalho.
• Modo agente disponível na sua região. Consulte Databricks Designated Services.

• Unity Gateway disponível na sua região. Ver regiões suportadas.

• Tanto os direitos de acesso ao Workspace como aos Databricks SQL para cada utilizador do agente. Os utilizadores apenas de consumidor, os utilizadores apenas do Databricks SQL e os utilizadores apenas de conta não podem usar ferramentas MCP. Consulte Direitos de acesso.
• Uma conta em cada sistema externo ligado para cada utilizador do agente.

Adicionar conectores a um Agente Genie

Para anexar conectores a um Genie Agent:

1. Abre o teu Genie Agent.
2. Abre o separador Fontes e depois clica em Adicionar.
3. Selecione um ou mais Serviços MCP.

Para anexar um conector, precisa de EXECUTE no Serviço MCP do conector no Unity Catalog, além de USE CATALOG e USE SCHEMA no respetivo catálogo pai e esquema. Conectores para os quais não tens permissão para executar não estão disponíveis. Ver MCPs fornecidos pelo Databricks.

Configurar ferramentas

Depois de ligares um conector, configura 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, pode instruir o agente sobre um formato obrigatório de título do ticket ou dizer-lhe para consultar o perfil de um utilizador no início de cada conversa.
• Ative ou desative ferramentas individuais dentro de um conector para definir quais as ações que o agente pode realizar.

Utilize ferramentas MCP numa conversa

Para usar ferramentas MCP num Genie Agent:

1. Abre um Genie Agent que tenha conectores MCP ligados.
2. Ativa o modo Agente na caixa de chat.
3. Autentique-se no conector a partir do painel Configurar. Se o agente precisar de um conector que não autorizaste, ou se a tua autenticação tiver expirado, o agente pede-te para iniciar sessão.
4. Envia um prompt que use o conector. Quando o agente chamar uma ferramenta de escrita, escolha Permitir uma vez para aprovar a ação única, Permitir sempre neste chat para aprovar essa ferramenta para o resto da conversa, ou Rejeitar para a recusar.

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

Limitations

Aplicam-se as seguintes limitações:

• As ferramentas MCP funcionam apenas em modo Agente. Eles não funcionam no modo Chat.
• Através das APIs do modo Agente, só funcionam ferramentas de leitura, e os utilizadores não conseguem autenticar-se num conector. Conclua a autenticação e a aprovação da ferramenta de escrita na interface.
• Para orientações de conformidade para aplicações conectadas, consulte Requisitos de fornecedores externos.

As secções seguintes descrevem limitações para conectores específicos.

Google Drive

• Ao autorizar o Google Drive, pode ver um ecrã Aplicação não verificada. Clique em Avançado e continue o processo de autorização.
• O tamanho máximo do ficheiro é de 25 MB.
• Apenas os ficheiros nativos do Google Workspace (Docs, Sheets, Slides) são suportados. PDFs, imagens e outros formatos binários não são suportados.
• O conector pode criar Google Docs, Sheets e Slides, e editar os Google Docs que criou. Não pode editar documentos criados fora do conector, nem editar Sheets ou Slides existentes.
• Ler um documento muito grande pode ser lento.

Gmail

• O conector pode pesquisar, ler e rascunhar emails, mas não pode enviar emails nem editar mensagens existentes.
• O conector não pode adicionar ficheiros Drive como anexos nativos do Gmail. Como solução alternativa, inclua ligações para os ficheiros no corpo do email.

Microsoft 365

• Inclui SharePoint, Teams, Outlook e Calendário.
• O conector pode criar um rascunho de email do Outlook, mas não pode enviá-lo.
• O tamanho máximo do ficheiro é de 25 MB 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.

Glean (Beta)

• O Glean serve apenas para pesquisa. Não consegue ler um documento a partir de um link direto.
• 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.

Slack

• O conector não pode editar nem apagar uma mensagem depois de a enviar.

GitHub

• A escrita está limitada aos conteúdos dos ficheiros, issues e pull requests.
• 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. Ativar acesso de escrita no GitHub e acesso a repositórios privados.
• O GitHub Enterprise Server (a versão auto-hospedada do GitHub) não é suportado.

Recursos adicionais

Consulte os seguintes recursos para informações relacionadas:

• Ligue o Genie One a ferramentas e origens externas
• MCPs fornecidos por Databricks
• Provedores OAuth geridos
• Servidores MCP externos
• Governação da IA com o Unity Gateway