Aller au contenu principal

Prise en charge des compétences dans Unity Gateway

info

Bêta

Cette fonctionnalité est en Beta. Pour l'utiliser, un administrateur de workspace doit activer les compétences Unity Gateway dans Genie à partir de la page Prévisualisations . Consultez Gérer les aperçus Databricks.

Les compétences Unity Gateway vous offrent un emplacement central pour découvrir, publier et régir les compétences des agents dans toute votre organisation. Il n'y a aucun exemplaire à synchroniser, et toute personne disposant d'un accès peut découvrir ce qui existe déjà au lieu de poser des questions.

Sur Databricks, une compétence est un élément sécurisable de premier ordre dans Unity Catalog (catalog.schema.skill) ; vous pouvez donc la partager avec des personnes ou des groupes en utilisant les mêmes autorisations, tags et audits que ceux qui protègent vos tables.

Les compétences Unity Gateway respectent le format de spécification SKILL.md. Les compétences enseignent à un agent à bien exécuter une tâche, telle que l'analyse d'une table, le suivi d'un guide d'exécution ou l'application des conventions SQL de votre équipe.

Les auteurs et les équipes centrales créent une compétence à partir d'un fichier SKILL.md et de fichiers de support, puis la publient dans le registre des compétences dans UC. Les autorisations, les tags, les logs d'audit et la recherche régissent les compétences publiées. Votre agent découvre les compétences accessibles, conserve de brèves métadonnées dans le contexte et charge la compétence complète lorsque cela est nécessaire.

Les auteurs et les équipes centrales écrivent un fichier SKILL.md avec des fichiers de support et publient la compétence dans un registre dans Unity Catalog. Le registre applique les autorisations, les tags et les logs d'audit et rend les compétences recherchables. Votre agent découvre les compétences auxquelles vous pouvez accéder, conserve un petit ensemble de métadonnées de compétence en contexte et charge la compétence complète lorsqu'une tâche en a besoin.

Accéder aux compétences via MCP​

Le serveur MCP Databricks Skills permet à un agent de découvrir et de lire des compétences dans Unity Catalog. Pour les agents de codage pris en charge, utilisez la Unity Gateway CLI pour vous connecter au registre des compétences.

Pour connecter directement un autre client MCP, utilisez https://<workspace-hostname>/ai-gateway/skills/?schema=<catalog>.<schema>. Remplacez les espaces réservés par le hostname de votre workspace et votre schéma, puis authentifiez-vous auprès du workspace dans votre client. Pour inclure plusieurs schémas, répétez le parameter schema :

Text
https://<workspace-hostname>/ai-gateway/skills/?schema=acme.sql_skills&schema=acme.analytics_skills

Les schémas sélectionnés limitent la découverte. Les autorisations Unity Catalog contrôlent toujours les compétences auxquelles le client peut accéder.

Le serveur prend en charge l’interface Skills MCP et l’ extension Skills over MCP à la même URL. Databricks permet l’extension via un déploiement géré. Là où elle est activée, les requêtes qui annoncent la capacité Skills utilisent l’extension. Toutes les autres demandes utilisent l’interface Skills MCP. Pour un client personnalisé, incluez io.modelcontextprotocol/skills dans params._meta["io.modelcontextprotocol/clientCapabilities"].extensions sur chaque demande.

Les deux interfaces permettent aux agents de découvrir et de lire des compétences et de retourner des instructions CLI Databricks pour les gérer. Le serveur n’exécute pas de commandes et n’upload pas de fichiers. Vous ou votre agent exécutez les commandes localement. Consultez Créer et partager des compétences de Unity Gateway.