Pesquise código do GitHub com código Genie

O Genie Code pode pesquisar em repositórios do GitHub quando o liga através do conector nativo da Databricks para o GitHub ou de um servidor MCP do GitHub personalizado. Usa o conector nativo na maioria dos casos. O acesso a repositórios privados requer que um administrador da organização GitHub instale a aplicação conector Databricks GitHub.

Use o conector nativo (recomendado)

Para ligar o Genie One ou o Genie Code ao GitHub, use o conector de terceiros Databricks. Veja Usar conectores nativos para fontes de dados de terceiros e Ligar o Genie One a ferramentas e fontes externas. Para repositórios privados, os administradores precisam de ativar o acesso.

• O conector nativo utiliza a ligação padrão do sistema Databricks. Para usar um servidor MCP personalizado do GitHub, em vez disso, adicione-o manualmente. Veja Adicionar servidores MCP ao Código Genie manualmente.
• Para melhorar as respostas, adicione contexto pessoal para cada repositório para ajudar as ferramentas de pesquisa do GitHub a compreender a sua base de código.

Registe um servidor MCP personalizado no GitHub (não recomendado)

Salta esta secção se o teu espaço de trabalho no Azure Databricks já tiver um serviço MCP do GitHub Unity Catalog disponível para usares. Se só precisar de acesso a repositórios públicos e à informação da sua própria conta, use OAuth gerido e passe para Registar uma ligação ao Unity Catalog como um Serviço MCP.

Siga os passos abaixo para registar um servidor GitHub MCP personalizado como um Serviço MCP para as suas necessidades específicas de dados e segurança. Primeiro, escolha como o seu Serviço MCP se autentica:

• Managed OAuth: O Databricks gere a aplicação GitHub OAuth e as credenciais. Ignora a aplicação GitHub e os passos do segredo do cliente abaixo, depois escolhe o fornecedor gerido ao criar a ligação.
• OAuth personalizado: Crie a sua própria aplicação GitHub e forneça as suas credenciais quando criar a ligação.

Criar uma aplicação GitHub (apenas OAuth personalizada)

1. Cria uma app do GitHub. Para bases de código empresariais, um administrador de organização GitHub deve completar este passo.

   • Vá a Definições > de Perfil > Definições > de Programador GitHub Apps e clique em Nova Aplicação GitHub.
   • Preencha os campos pedidos. O URL de Callback deve ser https://<your-databricks-workspace-url>/login/oauth/http.html. É assim que o GitHub autentica com o seu espaço de trabalho Databricks.
     • A URL da página inicial não afeta o servidor MCP e pode ser definida para qualquer valor que preferir.
     • Desmarque a caixa de seleção Ativo para tornar o URL de webhook um campo opcional.
   • Conceda à sua aplicação GitHub as permissões necessárias para aceder ao seu repositório e organização.
   • Clica em Criar Aplicação no GitHub.

2. Na aplicação recém-criada, em Segredos do cliente, clique em Gerar um novo segredo do cliente. Copiar este valor.

Registar uma ligação ao Unity Catalog como um Serviço MCP

1. Crie ou reutilize uma ligação HTTP do Unity Catalog para o GitHub. Tens de ter privilégios de CREATE CONNECTION no esquema para criar um objeto. Se reutilizares uma ligação existente, tens de ter USE CONNECTION nela. Continue a registar essa ligação como um Serviço MCP no próximo passo. Para uma nova ligação, utilize uma das seguintes opções de autenticação:

   • OAuth gerido: Selecione o tipo de autenticação OAuth de Utilizador para Máquina por Utilizador e o fornecedor OAuth do GitHub. O Databricks fornece o host do GitHub, o caminho base e as credenciais OAuth.
   • OAuth Personalizado: Selecione o tipo de autenticação OAuth User to Machine Per User e o fornecedor OAuth Configuração manual. Introduza os seguintes valores:
     • Anfitrião: https://api.githubcopilot.com
     • Escopo OAuth: Os escopos da sua aplicação. Por exemplo, mcp:access read:user user:email repo read:org
     • Segredo do cliente e ID do cliente: gerados nos passos acima da aplicação GitHub
     • Ponto final de autorização: https://github.com/login/oauth/authorize
     • Endpoint do token: https://github.com/login/oauth/access_token
     • Caminho base: /mcp
   • Clique em Criar conexão.

2. Registar um Serviço MCP que utilize a ligação HTTP. Para as permissões necessárias, veja Servidores MCP externos.

   • No seu espaço de trabalho do Azure Databricks, vá a Catalog, selecione um esquema e clique em Create>MCP Service.
   • Introduza o catálogo, o esquema e o nome do Serviço MCP.
   • Selecione a ligação HTTP que criou ou reutilizou, selecione as ferramentas a expor e clique em Criar.

3. Se escolheu OAuth por utilizador, abra o Serviço MCP no Explorador de Catálogos e clique em Iniciar sessão para autorizar a sua conta no GitHub.

4. Conceda aos utilizadores ou grupos EXECUTE no Serviço MCP, bem como USE SCHEMA e USE CATALOG no catálogo-mãe e no esquema-mãe. Não conceda aos utilizadores finais USE CONNECTION. Ver Partilhar um MCP.

O seu serviço GitHub MCP está pronto a usar. Adicione isso ao Código Genie.