Tutoriel : Découvrir et utiliser les compétences Unity Catalog
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 gouvernés, vous réutilisez donc ce qui existe au lieu de le reconstruire. Pour créer et publier vos propres compétences, consultez Créer et partager des compétences Unity Catalog.
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é pour installer
ucode). - 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 ucode et utilisez-le pour connecter votre agent de codage au registre de compétences de votre workspace Databricks.
ucode 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 ucode pour vous :
Install ucode from its Git source and connect my coding agent to Databricks:
1. Run: uv tool install git+https://github.com/databricks/ucode
2. Run: ucode configure --agents <your-agent> --workspaces https://<workspace-host>
3. Run: ucode 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/ucode
ucode configure --agents <your-agent> --workspaces https://<workspace-host>
ucode 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 ucode configure pour vous permettre de vous connecter. Redémarrez votre agent par la suite (ucode <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 ucode so I have it every session:
run ucode configure skills --location acme.sql_skills --skill databricks-sql-guide.
ucode configure skills --location acme.sql_skills --skill databricks-sql-guide # one skill
ucode configure skills --location acme.sql_skills --skill databricks-sql-guide,dbt-conventions # several skills
ucode 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 (ucode <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
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 ucode configure skills --location acme.sql_skills --mcp.
ucode configure skills --location acme.sql_skills --mcp
Redémarrez votre agent ensuite (ucode <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, ucode 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
ucode est open source. Pour obtenir la référence complète et actuelle des commandes, consultez le repository ucode. 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
- Qu’est-ce que les compétences Unity Catalog pour les concepts derrière ce tutoriel.
- Créez et partagez des compétences Unity Catalog 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.