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

Pesquisar código no GitHub com Genie Code

O Genie Code pode pesquisar repositórios GitHub quando você o conecta através do conector Databricks GitHub nativo ou de um serviço MCP GitHub personalizado. Use o conector nativo para a maioria dos casos. O acesso ao repository privado requer que um administrador da organização GitHub instale o aplicativo conector Databricks GitHub.

Utilize o conector nativo (recomendado)​

info

Visualização

Este recurso está em versão Beta. Para usar conectores de fontes de dados de terceiros, um administrador workspace deve ativar a pré-visualização de Conectores de Terceiros para Agentes . Veja as prévias do Gerenciador Databricks.

Para conectar o Genie One ou o Genie Code ao GitHub, use o conector de terceiros do Databricks. Consulte Use conectores nativos para fontes de dados de terceiros e Conecte-se a ferramentas e fontes externas. Para repositories privados, os administradores precisam habilitar o acesso.

Habilitar acesso ao repositório privado​

A conexão default do sistema Databricks para o GitHub pode acessar apenas public repositories. Para dar à conexão acesso de leitura a repositórios empresariais privados, um administrador da organização GitHub deve concluir as seguintes etapas:

  1. Instale o aplicativo conector Databricks GitHub em sua organização do GitHub para que ele tenha acesso de leitura aos seus repositórios privados.

  2. Adicione à lista de permissões os IPs de saída serverless Databricks para cloud e região do seu workspace. Para obter a lista de endereços IP, consulte Endereços IP e domínios para Databricks serviço e ativo. Para obter instruções sobre como configurar os endereços IP permitidos para sua organização do GitHub, consulte Gerenciando endereços IP permitidos para sua organização.

Após a conclusão da configuração do administrador, os usuários da sua organização podem acessar private repository usando a conexão do sistema Databricks default.

Criar um servidor GitHub MCP personalizado (não recomendado)​

Ignore esta seção se o seu workspace Databricks já tiver uma conexão com o Catálogo GitHub Unity Catalog disponível para uso. Se você precisar apenas de acesso a repositórios públicos e às informações da sua própria account, pule para o passo 3.

Siga os passos abaixo para criar um servidor GitHub MCP personalizado. Isso permite configurar o servidor de acordo com suas necessidades específicas de dados e segurança.

  1. Na sua account do GitHub, crie um aplicativo GitHub. Para bases de código corporativas, um administrador de organização do GitHub deve concluir este passo.

    • Vá para Profile > Settings > Developer settings > GitHub Apps e clique em New GitHub App .

    • Preencha os campos solicitados. A URL de retorno de chamada deve ser https://<your-databricks-workspace-url>/login/oauth/http.html. É assim que GitHub se autentica com seu workspace Databricks .

      • O URL da página inicial não afeta o servidor MCP e pode ser definido para qualquer valor de sua preferência.
      • Desmarque a caixa de seleção Ativo para tornar o URL do webhook um campo opcional.

    • Conceda ao seu aplicativo GitHub as permissões necessárias para acessar seu repositório e sua organização.

    • Clique em Criar aplicativo do GitHub .

  2. No aplicativo recém-criado, em Segredos do cliente , clique em Gerar um novo segredo do cliente . Copie este valor.

  3. Crie uma nova conexão Unity Catalog para GitHub. Você deve ter privilégios CREATE CONNECTION .

    • Se o seu workspace já tiver um instalado, você pode usar o existente, desde que tenha privilégios USE CONNECTION nele.

    • Preencha estes campos:

      • Tipo de conexão: HTTP

      • Tipo de autenticação: OAuth User to Machine

      • Provedor OAuth: Manual configuration

        • Se você precisar apenas de acesso a repositórios públicos e às informações da sua própria account, selecione Github MCP aqui e ignore o resto dos passos.

      • Hospedar: https://api.githubcopilot.com

      • Escopo OAuth: Os escopos do seu aplicativo. Por exemplo, mcp:access read:user user:email repo read:org

      • Segredo do cliente e ID do cliente: gerados a partir do passo 2

      • endpoint de autorização: https://github.com/login/oauth/authorize

      • endpoint de tokens: https://github.com/login/oauth/access_token

      • Caminho base: /mcp

      • É uma conexão MCP: checked

    • Clique em Criar conexão .

  4. No canto superior direito, clique em Login para entrar em sua conexão. Isso abre uma nova janela solicitando a autorização do aplicativo GitHub para sua account Databricks. Clique em Conectar na account do GitHub à qual deseja se conectar.

Seu GitHub MCP agora está pronto para uso. Adicione-o ao Genie Code como um servidor MCP externo.

Nesta página