Rechercher GitHub code avec Genie Code

Genie Code peut rechercher dans des dépôts GitHub lorsque vous le connectez via le connecteur GitHub Databricks natif ou un serveur MCP GitHub personnalisé. Utilisez le connecteur natif pour la plupart des cas. L’accès au référentiel privé nécessite qu’un administrateur d’organisation GitHub installe l’application de connecteur Databricks GitHub.

Utiliser le connecteur natif (recommandé)

Important

Cette fonctionnalité est en version bêta. Pour utiliser des connecteurs de source de données tiers, un administrateur d’espace de travail doit activer la préversion des connecteurs tiers pour les agents . Consultez Gérer les préversions d’Azure Databricks.

Pour connecter Genie One ou Genie Code à GitHub, utilisez le connecteur tiers Databricks. Voir Utiliser des connecteurs natifs pour les sources de données tierces et Connecter Genie One à des outils et sources externes. Pour les référentiels privés, les administrateurs doivent activer l’accès.

Enregistrer un serveur MCP GitHub personnalisé (non recommandé)

Ignorez cette section si votre espace de travail Azure Databricks dispose déjà d’un service MCP sur GitHub Unity Catalog que vous pouvez utiliser. Si vous n’avez besoin que d’accéder aux dépôts publics et aux informations de votre propre compte, utilisez OAuth géré et passez directement à Enregistrer une connexion Unity Catalog en tant que service MCP.

Suivez les étapes ci-dessous pour enregistrer un serveur MCP GitHub personnalisé en tant que service MCP adapté à vos besoins spécifiques en matière de données et de sécurité. Tout d’abord, choisissez comment votre service MCP s’authentifie :

  • OAuth géré : Databricks gère l’application OAuth GitHub et ses identifiants. Ignorez l’étape de l’application GitHub et les étapes du client-secret ci-dessous, puis choisissez le fournisseur géré lors de la création de la connexion.
  • OAuth personnalisé : Créez votre propre application GitHub et fournissez ses identifiants lors de la création de la connexion.

Créer une application GitHub (OAuth personnalisé uniquement)

  1. Créez une application GitHub. Pour les bases de code d’entreprise, un administrateur d’organisation GitHub doit effectuer cette étape.

    • Accédez à Profil > Paramètres > Paramètres du développeur > Applications GitHub et cliquez sur Nouvelle application GitHub.
    • Renseignez les champs demandés. L’URL de rappel doit être https://<your-databricks-workspace-url>/login/oauth/http.html. C’est ainsi que GitHub s’authentifie auprès de votre espace de travail Databricks.
      • L’URL de la page d’accueil n’affecte pas le serveur MCP et peut être définie sur n’importe quelle valeur que vous préférez.
      • Décochez la case Active pour définir l’URL du webhook comme champ facultatif.
    • Accordez à votre application GitHub les autorisations nécessaires pour accéder à votre référentiel et à votre organisation.
    • Cliquez sur Créer une application GitHub.

  2. Dans l’application nouvellement créée, sous Secrets client, cliquez sur Générer une nouvelle clé secrète client. Copiez cette valeur.

Enregistrer une connexion Unity Catalog en tant que service MCP

  1. Créer ou réutiliser une connexion HTTP Unity Catalog pour GitHub. Vous devez avoir les privilèges CREATE CONNECTION sur le schéma pour en créer un. Si vous réutilisez une connexion existante, vous devez avoir USE CONNECTION sur celle-ci. Continuez en enregistrant cette connexion comme service MCP à l’étape suivante. Pour une nouvelle connexion, utilisez l’une des options d’authentification suivantes :

    • OAuth géré : Sélectionnez le type d’auth OAuth utilisateur vers machine par utilisateur et le fournisseur OAuth GitHub. Databricks fournit l’hôte GitHub, le chemin de base et les identifiants OAuth.
    • OAuth personnalisé : sélectionnez le type d’authentification OAuth User to Machine Per User et le fournisseur OAuth Manual configuration. Entrez les valeurs suivantes :
      • Hôte: https://api.githubcopilot.com
      • Étendue OAuth : étendues de votre application. Par exemple : mcp:access read:user user:email repo read:org
      • Secret client et identifiant client : générés dans les étapes ci-dessus de l’application GitHub
      • Point de terminaison d’autorisation : https://github.com/login/oauth/authorize
      • Point de terminaison de jeton : https://github.com/login/oauth/access_token
      • Chemin de base : /mcp
    • Cliquez sur Create connection (Créer la connexion).

  2. Enregistrez un service MCP qui utilise la connexion HTTP. Pour les autorisations requises, voir Serveurs MCP externes.

    • Dans votre espace de travail Azure Databricks, allez dans Catalogue, sélectionnez un schéma et cliquez sur Créer>Service MCP.
    • Saisissez le catalogue, le schéma et le nom du service MCP.
    • Sélectionnez la connexion HTTP que vous avez créée ou réutilisée, sélectionnez les outils à exposer, puis cliquez sur Créer.

  3. Si vous avez choisi OAuth par utilisateur, ouvrez le service MCP dans l’Explorateur de catalogue et cliquez sur Connexion pour autoriser votre compte GitHub.

  4. Accorder à des utilisateurs ou à des groupes EXECUTE sur le service MCP, ainsi que USE CATALOG et USE SCHEMA sur son catalogue parent et son schéma. N’accordez pas aux utilisateurs finaux USE CONNECTION. Voir « Partager un MCP ».

Votre service GitHub MCP est prêt à être utilisé. Ajoutez-le à Genie Code.

  • Dernière mise à jour :