Rechercher du code GitHub avec Genie Code
Genie Code peut rechercher des repository GitHub lorsque vous le connectez via le connecteur Databricks GitHub natif ou un serveur GitHub MCP personnalisé. Utilisez le connecteur natif dans la plupart des cas. L'accès aux repository privés nécessite qu'un administrateur de l'organisation GitHub installe l'application de connecteur Databricks GitHub.
Utiliser le connecteur natif (recommandé)
Aperçu
Cette fonctionnalité est en Bêta. Pour utiliser les connecteurs de sources de données tierces, un administrateur du Workspace doit activer l'aperçu Connecteurs tiers pour les agents . Consultez Gérer les aperçus Databricks.
Pour connecter Genie One ou Genie Code à GitHub, utilisez le connecteur tiers Databricks. Consultez Utiliser les connecteurs natifs pour les sources de données tierces et Se connecter aux outils et sources externes. Pour les private repository, les administrateurs doivent activer l'accès.
- Le connecteur natif utilise la connexion système Databricks default. Pour utiliser un serveur GitHub MCP personnalisé à la place, ajoutez-le manuellement. Consultez Ajouter des serveurs MCP à Genie Code manuellement.
- Pour améliorer les réponses, ajoutez un contexte personnel pour chaque repository afin d'aider les outils de recherche GitHub à comprendre votre code base.
Enregistrer un serveur GitHub MCP personnalisé (déconseillé)
Ignorez cette section si votre Workspace Databricks dispose déjà d'un service MCP Unity Catalog GitHub que vous pouvez utiliser. Si vous avez uniquement besoin d'accéder à des repositories publics et aux informations de votre propre compte, utilisez l'authentification OAuth gérée et passez directement à Enregistrer une connexion Unity Catalog en tant que service MCP.
Suivez les étapes ci-dessous pour enregistrer un serveur GitHub MCP personnalisé en tant que service MCP pour vos besoins spécifiques en matière de données et de sécurité. Tout d’abord, choisissez le mode d’authentification de votre service MCP :
- OAuth géré : Databricks gère l’application et les identifiants OAuth GitHub. Ignorez les étapes relatives à l’application GitHub et au secret du client ci-dessous, puis choisissez le fournisseur géré lorsque vous créez la connexion.
- OAuth personnalisé : créez votre propre application GitHub et fournissez ses identifiants lorsque vous créez la connexion.
Créer une application GitHub (OAuth personnalisé uniquement)
-
Créez une application GitHub. Pour les bases de code d’entreprise, un administrateur de l’organisation GitHub doit effectuer cette étape.
-
Accédez à **Profil > Paramètres > Paramètres du développeur > Applications GitHub** et cliquez sur **Nouvelle application GitHub**.
-
Remplissez les champs demandés. L' URL de rappel doit être
https://<your-databricks-workspace-url>/login/oauth/http.html. Voici comment GitHub s'authentifie auprès de votre Workspace Databricks.- L'URL de la page d'accueil n'affecte pas le serveur MCP et peut être définie à la valeur que vous préférez.
- Décochez la case à cocher Active pour rendre l'URL du webhook un champ facultatif.
-
Accordez à votre application GitHub les autorisations nécessaires pour accéder à votre repository et à votre organisation.
-
Cliquez sur Create GitHub App .
-
-
Dans l'application nouvellement créée, sous Secrets du client , cliquez sur Générer un nouveau secret du client . Copiez cette valeur.
Enregistrer une connexion Unity Catalog en tant que service MCP
-
Créez ou réutilisez une connexion HTTP Unity Catalog pour GitHub. Vous devez disposer des privilèges
CREATE CONNECTIONsur le schéma pour en créer un. Si vous réutilisez une connexion existante, vous devez y disposer deUSE CONNECTION. Continuez à enregistrer cette connexion en tant que service MCP lors de la prochaine étape. Pour une nouvelle connexion, utilisez l’une des options d’authentification suivantes :-
OAuth managé : sélectionnez le type d'authentification OAuth User to Machine Per User et le fournisseur d'identité GitHub . Databricks fournit l'hôte GitHub, le chemin de base et les identifiants OAuth.
-
Custom OAuth : sélectionnez le type d'authentification OAuth User to Machine Per User et le fournisseur OAuth Manual configuration . Veuillez saisir les valeurs suivantes :
- Hôte :
https://api.githubcopilot.com - Champ d'application OAuth : les champs d'application de votre application. Par exemple,
mcp:access read:user user:email repo read:org - Secret du client et ID client : générés lors des étapes de l’application GitHub ci-dessus
- Endpoint d'autorisation :
https://github.com/login/oauth/authorize - Endpoint de jeton :
https://github.com/login/oauth/access_token - Chemin de base :
/mcp
- Hôte :
-
Cliquez sur Créer une connexion .
-
-
Enregistrez un service MCP qui utilise la connexion HTTP. Pour connaître les autorisations requises, consultez Enregistrer un serveur MCP externe.
- Dans votre workspace Databricks, accédez à Catalog , sélectionnez un schéma, puis cliquez sur Create > MCP Service .
- 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 Create .
-
Si vous avez choisi l’authentification OAuth par utilisateur, ouvrez le service MCP dans l’Explorateur de catalogues et cliquez sur Login pour autoriser votre compte GitHub.
-
Accordez aux utilisateurs ou aux groupes
EXECUTEsur le service MCP, ainsi queUSE CATALOGetUSE SCHEMAsur son catalogue et son schéma parents. N'accordez pas aux utilisateurs finauxUSE CONNECTION. Consultez Étape 4. Accorder l'accès à un service MCP.
Votre service MCP GitHub est prêt à être utilisé. Ajoutez-le à Genie Code.