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.

registro de um servidor MCP personalizado do GitHub (não recomendado)​

Pule esta seção se o seu workspace do Databricks já tiver um GitHub Unity Catalog MCP serviço disponível para uso. Se você precisar apenas de acesso a repositórios públicos e às informações da sua própria account, use o OAuth gerenciado e vá diretamente para Registrar uma conexão do Unity Catalog como um MCP serviço.

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

  • OAuth gerenciado : A Databricks gerencia o aplicativo e as credenciais do OAuth do GitHub. Pule os passos do aplicativo GitHub e do client-secret abaixo e, em seguida, escolha o provedor gerenciado ao criar a conexão.
  • Custom OAuth : crie seu próprio aplicativo do GitHub e forneça suas credenciais ao criar a conexão.

Criar um aplicativo do GitHub (somente OAuth personalizado)​

  1. Criar um aplicativo do GitHub. Para bases de código corporativas, um administrador da organização do GitHub deve concluir o 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.

Registrar uma conexão do Unity Catalog como um serviço MCP​

  1. Crie ou reutilize uma conexão HTTP do Unity Catalog para o GitHub. Você deve ter privilégios CREATE CONNECTION no esquema para criar um. Se você reutilizar uma conexão existente, deverá ter USE CONNECTION nela. Continue para registro essa conexão como um serviço MCP no próximo passo. Para uma nova conexão, use uma das seguintes opções de autenticação:

    • Managed OAuth : selecione o tipo de autenticação OAuth User to Machine Per User e o provedor OAuth do GitHub . A Databricks fornece o host, o caminho base e as credenciais OAuth do GitHub.

    • Custom OAuth : Selecione o tipo de autenticação OAuth User to Machine Per User e o provedor OAuth Manual configuration . Insira os seguintes valores:

      • 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 nos passos do aplicativo do GitHub acima
      • endpoint de autorização: https://github.com/login/oauth/authorize
      • endpoint de tokens: https://github.com/login/oauth/access_token
      • Caminho base: /mcp

    • Clique em Criar conexão .

  2. Registro um serviço MCP que use a conexão HTTP. Para obter as permissões necessárias, consulte Registro de um servidor MCP externo.

    • No seu workspace do Databricks, vá para Catalog , selecione um esquema e clique em Create > MCP serviço .
    • Insira o catálogo, o esquema e o nome do MCP Serviço.
    • Selecione a conexão HTTP que você criou ou reutilizou, selecione as ferramentas a serem expostas e clique em Criar .

  3. Se você escolheu o OAuth por usuário, abra o MCP serviço no Catalog Explorer e clique em Login para autorizar sua account do GitHub.

  4. Conceda aos usuários ou grupos EXECUTE no MCP serviço, além de USE CATALOG e USE SCHEMA em seu catálogo e esquema principais. Não conceda aos usuários finais USE CONNECTION. Consulte o passo 4. Conceder acesso a um MCP serviço.

O seu serviço MCP do GitHub está pronto para uso. Adicione-o ao Genie Code.

Nesta página