Ajouter des outils et des compétences
Utilisez le CLI Unity Gateway (ug) pour ajouter des serveurs MCP et des compétences partagées à votre agent de codage. Les outils MCP fournissent un accès aux données et aux services ; les compétences fournissent des instructions pour les tâches et les workflows de votre équipe.
Pour une configuration manuelle, consultez le guide de votre agent de codage sous Agents de codage pris en charge.
Avant de commencer
Installer et configurer ug. Vous devez avoir accès aux serveurs MCP ou aux compétences que vous souhaitez utiliser, y compris à l’ensemble des données et services sous-jacents.
You need an installed, configured MCP-capable agent, including for skill downloads. MCP connections apply to all your configured agents that support MCP.
Pour les compétences, votre administrateur doit activer la fonctionnalité bêta. Consultez Gérer les compétences.
Après avoir modifié votre configuration, redémarrez votre agent avec sa commande ug habituelle.
Ajouter des outils MCP
Choisir les serveurs MCP
ug mcp add
Connectez-vous si vous y êtes invité, puis choisissez des serveurs dans le sélecteur. Tapez pour filtrer, appuyez sur Space pour sélectionner, et sur Enter pour confirmer.
Les connexions existantes sont conservées. Dans votre agent, demandez-lui d’utiliser un outil en décrivant la tâche.
Choisir les serveurs MCP par nom
Pour ajouter des serveurs MCP par leur nom, utilisez leurs noms Unity Catalog complets (<catalog>.<schema>.<server-name>) :
ug mcp add --names system.ai.github,system.ai.slack
Pour ajouter tous les serveurs MCP d'un schéma :
ug mcp add --location "<catalog>.<schema>"
Ajouter d’autres serveurs MCP Databricks
Pour les ressources en dehors du sélecteur de serveur MCP, utilisez un sélecteur avec --names:
Ressource | Sélecteur |
|---|---|
Index de recherche vectorielle dans un schéma |
|
Fonctions Unity Catalog dans un schéma |
|
Connexion au serveur MCP externe |
|
Genie space |
|
Serveur MCP hébergé dans une application Databricks |
|
Par exemple, connectez un Genie space :
ug mcp add --names "genie-space:<space-id>"
Remplacez <space-id> par l’ID de Genie space.
Vérifier et supprimer les connexions
Répertorier les serveurs MCP configurés par ug:
ug mcp list
Pour supprimer les connexions que vous avez ajoutées :
ug mcp remove
Sélectionnez les serveurs à supprimer et appuyez sur Enter . Chaque connexion sélectionnée est supprimée de tous les agents où vous l’avez ajoutée. Le serveur MCP lui-même reste disponible dans le workspace.
Ajouter des compétences
Vous pouvez utiliser des compétences de deux manières :
- download skills: Votre agent découvre et utilise des fichiers de compétences locaux via son flux de travail de compétences natif.
- Utilisez des compétences via MCP : votre agent récupère les instructions à partir du registre de compétences publié lorsqu’il utilise une compétence, sans aucun fichier local à gérer.
Download les compétences
ug skills add
Sélectionnez les compétences à download dans le sélecteur.
ug télécharge chaque dossier de compétence complet, y compris SKILL.md et les fichiers de support, dans ~/.claude/skills/ et ~/.agents/skills/. Demandez à votre agent d’utiliser la compétence par son nom. Consultez le guide de l’agent pour connaître ses commandes de compétences.
Pour download des compétences spécifiques, utilisez leurs noms complets Unity Catalog :
ug skills add --names "<catalog>.<schema>.<skill-name>"
Pour download toutes les compétences d'un schéma :
ug skills add --location "<catalog>.<schema>"
Les deux options acceptent des noms séparés par des virgules. Utilisez --names ou --location dans une commande, mais pas les deux. Réexécutez la même commande pour récupérer les mises à jour ; ug invite à confirmer avant d’écraser les dossiers de compétences existants.
download permet également d'activer les outils de découverte et de chargement du registre de compétences, sans modifier les schémas déjà connectés via MCP.
download skills into a project
Depuis le répertoire de votre projet, exécutez :
ug skills add --path "$PWD"
Choisissez vos compétences. ug les écrit dans les répertoires .claude/skills/ et .agents/skills/ du projet. Vous pouvez également combiner --path avec --names ou --location.
--path doit pointer vers un répertoire de projet absolu et existant. Utilisez les téléchargements de projet avec ug gemini, qui utilise un répertoire d’accueil distinct pour les paramètres de l’agent.
Connectez-vous aux compétences publiées via MCP
Pour choisir les schémas dont les compétences peuvent être utilisées par votre agent via MCP :
ug skills add --via mcp
Sélectionnez les schémas dans le sélecteur. Pour spécifier un schéma directement :
ug skills add --location "<catalog>.<schema>" --via mcp
ug ajoute ces schémas à la connexion du registre de compétences, en conservant ceux qui sont déjà connectés. Vous ne pouvez pas combiner --via mcp avec --path ou --names.
Dans votre agent, demandez-lui d'utiliser une compétence publiée :
Use <catalog>.<schema>.<skill-name> to review this query.
Vous pouvez également demander à l’agent de lister les compétences dans un schéma. Les compétences chargées via MCP peuvent ne pas apparaître dans le menu des compétences natives de l’agent.
List skills
ug skills list
Supprimer les compétences
Pour sélectionner les compétences téléchargées à supprimer :
ug skills remove
To remove a particular skill from your current project:
ug skills remove --names "<catalog>.<schema>.<skill-name>" --path "$PWD"
Utilisez --location "<catalog>.<schema>" au lieu de --names pour supprimer tous les téléchargements d’un schéma. Sans --path, la suppression inclut les copies téléchargées par ug dans vos répertoires utilisateur et de projet. Les compétences publiées restent dans Unity Catalog.
Pour supprimer un schéma de la connexion MCP en direct :
ug skills remove --location "<catalog>.<schema>" --via mcp
Omettez --location pour choisir des schémas dans un sélecteur. La suppression d’un schéma laisse les fichiers téléchargés et les outils de découverte du registre en place.