Ligue o Código Genie aos servidores MCP

Ligue o Código Genie a ferramentas externas e fontes de dados através do Protocolo de Contexto do Modelo (MCP). O Genie Code pode usar quaisquer servidores MCP que tenham sido adicionados ao seu espaço de trabalho e para os quais tenha permissão para usar.

Observação

Os servidores MCP são suportados apenas no modo Genie Code Agent.

O que é MCP?

MCP é um standard open source que liga agentes de IA a ferramentas, recursos, prompts e outras informações contextuais. O MCP fornece uma forma padronizada de expor ferramentas, dados e fluxos de trabalho ao Código Genie sem incorporar esse contexto diretamente em prompts ou instruções.

O MCP foi concebido para casos em que o contexto importante já existe, mas é difícil de aceder a partir de um agente de IA, como o Genie Code. O MCP oferece uma forma segura de dar ao Código Génio acesso a contextos como o seguinte:

• Sistemas de documentação: As equipas costumam manter livros de operações ou documentos operacionais em ferramentas como a Confluence. Em vez de copiar secções em prompts, esse conteúdo pode ser exposto uma vez através de um servidor MCP externo e referenciado quando relevante. Os seus documentos também podem já estar no Databricks como um índice de pesquisa vetorial, que o Genie Code pode usar para consultar documentos relevantes.
• Ferramentas e serviços: As equipas da plataforma podem manter APIs ou scripts para configuração, validação ou implementação. O MCP disponibiliza essas capacidades diretamente ao Genie Code.
• Fontes de dados: Se já tem dados no Databricks, pode ligar o Genie Code a um espaço Genie para o ajudar a analisar os dados usando linguagem natural. Para dados armazenados fora dos Databricks, pode dar acesso seguro ao Genie Code através de servidores MCP externos.
• Aplicações personalizadas: Também pode adicionar funcionalidades personalizadas alojadas através das aplicações Databricks. Isto permite-lhe ligar o Genie Code a ferramentas proprietárias, fluxos de trabalho ou integrações criadas especificamente para si ou para a sua organização, tudo gerido de forma segura dentro do seu espaço de trabalho Databricks.

Nestes casos, o MCP substitui o copiar e colar manualmente por uma abordagem estruturada e reutilizável, tornando o contexto correto disponível apenas quando necessário.

Podes ligar o Genie Code a quaisquer servidores MCP no teu espaço de trabalho que tenhas permissão para usar. Os administradores do espaço de trabalho controlam quais os servidores disponíveis, enquanto os utilizadores podem escolher entre essas fontes aprovadas conforme necessário.

Para saber mais sobre servidores MCP em Databricks e como criar o seu próprio, consulte Model Context Protocol (MCP) em Databricks.

Conectar-se a fontes de dados de terceiros

Importante

Este recurso está em versão Beta. Para utilizar conectores de fonte de dados de terceiros, um administrador de espaço de trabalho deve ativar a pré-visualização dos Conectores de Terceiros para Agentes . Ver Gerir pré-visualizações Azure Databricks.

O Genie Code fornece conectores incorporados para fontes de dados empresariais comuns, incluindo Google Drive e SharePoint.

A ligação a estas fontes de dados permite ao Genie Code pesquisar os seus documentos ao responder a perguntas. Cada utilizador autentica-se individualmente, e os tokens OAuth não são partilhados entre utilizadores.

Para ligar uma fonte de dados de terceiros:

1. No seu espaço de trabalho, clique Código Génio no canto superior direito para abrir um chat.
2. Na barra de prompts, clique no , que é o ícone de mais.
3. Ao lado da fonte de dados à qual pretende ligar-se, clique em Conectar.
4. Complete os passos para iniciar sessão.

Depois de autenticar, o Genie Code pode pesquisar os seus documentos ao responder a perguntas. Os administradores da Metastore e os proprietários da ligação podem gerir ou revogar permissões de utilizador na ligação. Veja Partilhar a ligação do servidor MCP.

Observação

As ferramentas de fonte de dados nem sempre ativam automaticamente. Se a pesquisa de documentos não começar, tente pedir explicitamente ao Genie Code para usar a ferramenta, por exemplo "use Google Docs" ou "use SharePoint".

Para ligar outras fontes de dados, adicione-as manualmente ao Código Genie. Veja Adicionar servidores MCP ao Código Genie manualmente.

Limitações do Google Drive

• O tamanho máximo do ficheiro é de 10 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.
• Erros de expiração de sessão ou de token podem aparecer na saída do agente. É necessário reautenticar para resolver.

Limitações do SharePoint

• O tamanho máximo do ficheiro é de 10 MB.
• Os tipos de ficheiros suportados incluem documentos do Office (.docx, .xlsx, .pptx), 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.

Adicionar manualmente servidores MCP ao Genie Code

Para ligar o Código Genie a um servidor MCP, adicione-o nas suas definições do Código Genie:

1. Abrir as definições do Código Genie. No painel Código Génio, clica Definições.
2. Em Servidores MCP, clique no ícone
3. Seleciona os servidores MCP que queres adicionar. Pode selecionar servidores MCP geridos Databricks ou servidores MCP externos:
   • Função do Catálogo Unity: Selecione o esquema da função. Isto permite ao Genie Code usar funções para executar consultas SQL pré-definidas.
     • Para ajuda para adicionar um servidor MCP GitHub, veja criar um servidor MCP GitHub.
   • Pesquisa vetorial: Selecione o esquema para o índice. Isto permite ao Genie Code consultar o índice de pesquisa vetorial para encontrar documentos relevantes.
   • Espaço Génio: Selecione o espaço Génio. O Genie MCP invoca o Genie como ferramenta, permitindo consultar o espaço Genie para analisar dados usando linguagem natural.
   • Servidor MCP externo: Selecione a ligação ao Catálogo Unity para usar como servidor MCP externo. Deve iniciar sessão na ligação antes de poder ser utilizada.
   • Servidor MCP personalizado: Selecione a aplicação Databricks para usar como servidor MCP personalizado. Isto permite-lhe usar quaisquer ferramentas definidas à medida. Aplicam-se os seguintes requisitos:
     • A sua aplicação deve ser implementada no mesmo espaço de trabalho de onde está a tentar ligar-se a ela.
     • O servidor MCP deve ser acedido em https://<server-url>/mcp.
     • A tua aplicação tem de ser sem estado. Por exemplo, defina mcp_app = mcp_server.http_app(stateless_http=True).
     • Se encontrar erros no CORS, pode ser necessário adicionar o URL do seu espaço de trabalho à lista de origens permitidas da sua aplicação. Por exemplo, defina app.add_middleware(CORSMiddleware, allow_origins=ALLOWED_ORIGINS, allow_credentials=True, allow_methods= ["*"], allow_headers= ["*"]).
4. Clique em Salvar.

Depois de serem adicionados, os servidores MCP ficam imediatamente disponíveis para o Genie Code. Podes começar a usá-los no modo Agente sem alterar os teus prompts ou instruções. O Genie Code irá automaticamente usar estes servidores quando relevante.

Atualmente, o acesso ao MCP está limitado a 20 ferramentas em todos os servidores. Podes escolher quais ferramentas e servidores ativar ou desativar nas definições do Código Genie.