Tutoriel : découvrir et utiliser les compétences Unity Gateway
Bêta
Cette fonctionnalité est en version Bêta. Les administrateurs de compte peuvent gérer l'accès à cette fonctionnalité depuis la page Aperçus de la console du compte. Consultez Gérer les aperçus au niveau du compte.
Connectez votre agent de codage aux compétences que votre équipe a publiées dans Unity Catalog, puis découvrez-les et utilisez-les depuis n'importe quelle session d'agent. Tout le monde pointe vers les mêmes schémas régis, vous réutilisez donc ce qui existe au lieu de le reconstruire. Pour créer et publier vos propres compétences, voir Créer et partager des compétences Unity Gateway.
Vous utilisez une compétence de deux manières : download-la sur le disque afin qu’elle se charge à chaque session, ou chargez-la en direct depuis le serveur MCP Databricks Skills pour obtenir systématiquement la dernière version publiée.
Exigences
- Un workspace Databricks compatible avec Unity Catalog, et votre URL de workspace (par exemple,
https://my-company.cloud.databricks.com). - Python 3.12+ et uv sur votre machine (utilisés pour installer la CLI Unity Gateway).
- Un agent de codage compatible MCP (MCP, le Model Context Protocol, est la norme ouverte que les agents utilisent pour se connecter aux outils).
USE CATALOG,USE SCHEMAetREAD VOLUMEsur les compétences que vous souhaitez utiliser. Votre administrateur Databricks les accorde. Si une commande échoue avec une erreur de permission, demandez-les à votre administrateur sur le schéma de votre équipe.
Connectez-vous au registre de compétences Databricks
Installez la CLI Unity Gateway et utilisez-la pour connecter votre agent de codage au registre de compétences de votre workspace Databricks.
La CLI Unity Gateway vous connecte à votre Workspace et enregistre le serveur MCP Databricks Skills (databricks-skill-registry) que votre agent utilise pour lister, charger et download des compétences.
Demandez à votre agent d’installer et de connecter la CLI Unity Gateway pour vous :
Install the :re[UG] CLI from its Git source and connect my coding agent to Databricks:
1. Run: uv tool install git+https://github.com/databricks/unity-gateway
2. Run: ug configure --agents <your-agent> --workspaces https://<workspace-host>
3. Run: ug configure skills
Use <your-agent> = my coding agent (claude, codex, gemini, opencode, or copilot) and
<workspace-host> = my workspace URL host (for example, my-company.cloud.databricks.com).
A browser will open during step 2 for me to sign in.
Pour le faire vous-même, exécutez les mêmes commandes dans votre terminal :
uv tool install git+https://github.com/databricks/unity-gateway
ug configure --agents <your-agent> --workspaces https://<workspace-host>
ug configure skills
Remplacez <your-agent> par le nom de l’agent de codage que vous utilisez (par exemple, claude, codex, gemini, opencode ou copilot), et <workspace-host> par l’hôte de l’URL de votre workspace. Un navigateur s’ouvre pendant ug configure pour vous permettre de vous connecter. Redémarrez votre agent par la suite (ug <your-agent>) afin qu’il charge les nouveaux outils.
Découvrir les compétences
Posez votre question à votre agent en langage clair ; il appellera l'outil correspondant sur le serveur MCP databricks-skill-registry. Vous ne voyez que les compétences que vous êtes autorisé(e) à utiliser.
Lister un schéma pour voir toutes les compétences qu’il contient :
List the Databricks skills in acme.sql_skills.
L’agent appelle l’outil MCP list_skills et rapporte le contenu du schéma.
Utiliser des compétences
Il existe trois façons d'utiliser une compétence que vous avez trouvée :
- Charger une compétence une fois : pour cette session uniquement. Rien n’est enregistré. Idéal pour une utilisation ponctuelle.
- download a skill : pour chaque session. Télécharge sur le disque afin qu'il se charge automatiquement à chaque session et fonctionne hors ligne. Idéal pour la poignée que vous utilisez quotidiennement. Les copies sont ponctuelles ; download pour obtenir les mises à jour.
- Charger un schéma en direct : toujours le plus récent. Définit le périmètre du serveur MCP à un schéma entier afin que chaque compétence qu’il contient reste disponible et à jour, sans rien stocker localement. Idéal pour un ensemble volumineux et en évolution rapide, mais nécessite une connexion.
Dans chaque cas, le prompt correspond à ce que vous demandez à votre agent, suivi de l’outil qu’il appelle ou de la commande qu’il exécute.
Charger une compétence une fois
Use acme.sql_skills.databricks-sql-guide to review this query.
L’agent appelle l’outil MCP load_skill pour charger les instructions de la compétence dans le contexte, et get_skill_files si la compétence regroupe des fichiers de support.
Download une compétence
Download acme.sql_skills.databricks-sql-guide with the :re[UG] CLI so I have it every session:
run ug configure skills --location acme.sql_skills --skill databricks-sql-guide.
ug configure skills --location acme.sql_skills --skill databricks-sql-guide # one skill
ug configure skills --location acme.sql_skills --skill databricks-sql-guide,dbt-conventions # several skills
ug configure skills --location acme.sql_skills # a whole schema
--location est le schéma qui contient les compétences ; --skill restreint le download à une liste de noms de compétences séparés par des virgules au sein de celui-ci. Omettez --skill pour download toutes les compétences du schéma.
Redémarrez votre agent par la suite (ug <your-agent>). Les compétences téléchargées se trouvent dans vos dossiers de compétences locaux (.claude/skills/ et .agents/skills/) et se chargent à chaque session. Essayez-en une sans nommer de commande ; l’agent fait correspondre la tâche à la compétence et la suit :
Using our SQL guide skill, write a query on samples.nyctaxi.trips for average fare by trip distance.
samples.nyctaxi.trips existe dans chaque Workspace ; cela fonctionne donc sans aucune configuration.
Une compétence download est une copie ponctuelle. Relancez le download pour obtenir une version plus récente, ou chargez le schéma en direct (ci-dessous) pour toujours disposer de la dernière version.
Charger un schéma en direct (facultatif)
Définit la portée du serveur MCP Databricks Skills sur un schéma afin que chaque compétence qu’il contient soit exposée en tant qu’ outil actif .
Load the skills in acme.sql_skills live so I always get the latest version:
run ug configure skills --location acme.sql_skills --mcp.
ug configure skills --location acme.sql_skills --mcp
Redémarrez votre agent ensuite (ug <your-agent>) afin que les compétences du schéma se chargent. Chaque compétence dans acme.sql_skills apparaît alors comme un outil actif nommé skill_acme.sql_skills.<skill>. Lorsqu’une tâche correspond à la description d’une compétence, l’agent la charge à la demande ; publiez une nouvelle version et tous les membres de la connexion l’obtiennent immédiatement. Cela s’associe bien à un schéma qu’une équipe centrale maintient synchronisé depuis Git.
Le chargement en direct fonctionne sur un schéma entier à la fois. Vous ne pouvez pas le limiter à une seule compétence. Pour utiliser une seule compétence sans charger son schéma complet, chargez-la plutôt pour une utilisation ponctuelle.
Pour les agents pris en charge, la CLI Unity Gateway configure la connexion pour charger automatiquement les compétences en direct. D’autres agents peuvent exposer leur propre paramètre « always load » (ou équivalent) que vous devrez activer.
Référence
La CLI Unity Gateway est open source. Pour obtenir la référence complète et actuelle des commandes, consultez le repository de la CLI Unity Gateway. Les commandes utilisées dans ce tutoriel apparaissent en ligne dans les étapes ci-dessus.
Outils de compétences (votre agent les appelle sur le serveur MCP databricks-skill-registry une fois connecté) :
Outil | Usage |
|---|---|
| Lister les compétences dans un schéma |
| Charger les instructions d’une compétence dans la session actuelle |
| Récupérer des fichiers groupés spécifiques à partir d’une compétence |
Étapes suivantes
- Prise en charge des compétences dans Unity Gateway pour les concepts derrière ce tutoriel.
- Créez et partagez des compétences Unity Gateway pour publier les vôtres.
- Gérez les compétences pour les privilèges qui contrôlent qui peut lire et partager les compétences.