Buscar GitHub código con Genie Code

Genie Code puede buscar repositorios de GitHub al conectarlo a través del conector nativo de Databricks para GitHub o de un servidor MCP de GitHub personalizado. Use el conector nativo para la mayoría de los casos. El acceso al repositorio privado requiere que un administrador de la organización de GitHub instale la aplicación del conector de GitHub de Databricks.

Uso del conector nativo (recomendado)

Important

Esta característica se encuentra en su versión beta. Para usar conectores de origen de datos de terceros, un administrador del área de trabajo debe habilitar los conectores de terceros para agentes en modo de vista previa. Consulte Administrar versiones preliminares de Azure Databricks.

Para conectar Genie One o Genie Code a GitHub, use el conector de terceros de Databricks. Consulta Usar conectores nativos para fuentes de datos de terceros y Conectar Genie One a herramientas y fuentes externas. En el caso de los repositorios privados, los administradores deben habilitar el acceso.

Registra un servidor MCP de GitHub personalizado (no recomendado)

Salta esta sección si tu espacio de trabajo de Azure Databricks ya tiene disponible un servicio MCP de GitHub Unity Catalog para tu uso. Si solo necesitas acceso a repositorios públicos y a la información de tu propia cuenta, usa OAuth gestionado y salta a Registrar una conexión de Unity Catalog como un Servicio MCP.

Sigue los pasos siguientes para registrar un servidor MCP de GitHub personalizado como Servicio MCP para tus necesidades específicas de datos y seguridad. Primero, elige cómo se autentica tu Servicio MCP:

  • Managed OAuth: Databricks gestiona la aplicación OAuth de GitHub y sus credenciales. Omita los pasos siguientes de la aplicación de GitHub y del secreto de cliente, y, a continuación, elija el proveedor administrado al crear la conexión.
  • OAuth personalizado: Crea tu propia aplicación en GitHub y proporciona sus credenciales cuando crees la conexión.

Crea una app de GitHub (solo OAuth personalizado)

  1. Crea una GitHub App. Para las bases de código empresariales, un administrador de una organización de GitHub debe completar este paso.

    • Vaya a Perfil > Configuración > Configuración del desarrollador > Aplicaciones de GitHub y haga clic en Nueva aplicación de GitHub.
    • Rellene los campos solicitados. La dirección URL de devolución de llamada debe ser https://<your-databricks-workspace-url>/login/oauth/http.html. Así es como GitHub autentica con el área de trabajo de Databricks.
      • La dirección URL de la página principal no afecta al servidor MCP y se puede establecer en cualquier valor que prefiera.
      • Desactive la casilla Activo para convertir la dirección URL del webhook en un campo opcional.
    • Conceda a la aplicación GitHub los permisos necesarios para acceder al repositorio y la organización.
    • Haga clic en Crear aplicación de GitHub.

  2. En la aplicación recién creada, en Secretos de cliente, haga clic en Generar un nuevo secreto de cliente. Copie este valor.

Registrar una conexión de Unity Catalog como un servicio MCP

  1. Crea o reutiliza una conexión HTTP de Unity Catalog para GitHub. Debes tener CREATE CONNECTION privilegios sobre el esquema para crear uno. Si reutiliza una conexión existente, debe tener USE CONNECTION en ella. Continúa para registrar esa conexión como un Servicio MCP en el siguiente paso. Para una nueva conexión, utiliza una de las siguientes opciones de autenticación:

    • OAuth gestionado: Selecciona el tipo de autenticación OAuth de usuario a máquina por usuario y el proveedor OAuth de GitHub. Databricks proporciona el host de GitHub, la ruta base y las credenciales OAuth.
    • OAuth personalizado: seleccione el tipo de autenticación OAuth usuario a máquina por usuario y el proveedor de OAuth Configuración manual. Escriba los valores siguientes:
      • Anfitrión: https://api.githubcopilot.com
      • Ámbito de OAuth: los ámbitos de la aplicación. Por ejemplo: mcp:access read:user user:email repo read:org
      • Secreto del cliente e ID del cliente: generados en los pasos de la app de GitHub anteriores
      • Punto de conexión de autorización: https://github.com/login/oauth/authorize
      • Punto de conexión del token: https://github.com/login/oauth/access_token
      • Ruta de acceso base: /mcp
    • Haga clic en Crear conexión.

  2. Registra un servicio MCP que utilice la conexión HTTP. Para los permisos requeridos, véase Servidores MCP externos.

    • En tu espacio de trabajo de Azure Databricks, ve a Catálogo, selecciona un esquema y haz clic en Crear>servicio MCP.
    • Introduce el catálogo, el esquema y el nombre del Servicio MCP.
    • Selecciona la conexión HTTP que creaste o reutilizaste, selecciona las herramientas a exponer y haz clic en Crear.

  3. Si elegiste OAuth por usuario, abre el servicio MCP en el Explorador de Catálogos y haz clic en Iniciar sesión para autorizar tu cuenta de GitHub.

  4. Conceda a los usuarios o grupos EXECUTE en el servicio MCP, además de USE CATALOG y USE SCHEMA en su catálogo y esquema primarios. No concedas a los usuarios USE CONNECTIONfinales. Consulta Compartir un MCP.

Tu servicio MCP de GitHub está listo para usar. Añádelo a Genie Code.

  • Se actualizó por última vez el