Référence de l’ug CLI
Utilisez la CLI Unity Gateway (ug) pour configurer et lancer des agents de code. Pour une présentation détaillée, consultez le guide de démarrage rapide sur l’agent de code.
Installer
Installez ug, puis vérifiez la version installée :
uv tool install git+https://github.com/databricks/unity-gateway
ug --version
Requires uv and Python 3.12 or later.
Configurer
Commande | Fonctionnement |
|---|---|
| Connectez-vous à un Workspace Databricks et configurez vos agents à l'aide des paramètres de votre administrateur ou de la configuration guidée. |
| Configurez vos agents de manière à utiliser le workspace à l'URL spécifiée. |
| Authentifiez-vous avec un jeton d'accès personnel au lieu d'OAuth. Exécutez d'abord |
Lancez un agent
Ces commandes ouvrent l'agent dans votre terminal, prêt pour votre workflow de codage habituel.
Commande | Fonctionnement |
|---|---|
| Lancez l'agent sélectionné par la configuration du Workspace publiée par votre administrateur. |
| Lancez Claude Code via Unity Gateway. |
| Launch Codex through Unity Gateway. |
| Lancez Gemini CLI par l'intermédiaire de Unity Gateway. |
| Lancez OpenCode via Unity Gateway. |
| Lancez GitHub Copilot CLI via Unity Gateway. |
| Lancez Pi via Unity Gateway. |
| Lancez Cursor Agent. Les requêtes de modèle utilisent votre compte Cursor. |
Pour Claude Code ou Codex, ajoutez --refresh pour refresh l’authentification du Workspace, les modèles et la configuration avant le lancement. Vous pouvez également transmettre des arguments spécifiques à l’agent à la commande de lancement.
Serveurs MCP
Commande | Fonctionnement |
|---|---|
| Sélectionnez les serveurs MCP et ajoutez leurs connexions à vos agents configurés. |
| Afficher les serveurs MCP configurés et l'état signalé par chaque agent. |
| Sélectionnez les connexions MCP à supprimer de vos agents. Les serveurs restent dans le Workspace. |
Compétences
Commande | Fonctionnement |
|---|---|
| Sélectionnez les compétences publiées et download leurs fichiers dans les répertoires de compétences de l’agent local. |
| Connectez des compétences à partir de schémas Unity Catalog sélectionnés via MCP, sans download de fichiers. |
| Affichez les compétences configurées pour vos agents et la manière dont elles ont été ajoutées. |
| Sélectionnez les dossiers de compétences download à supprimer de votre ordinateur. Les compétences publiées restent inchangées. |
| Supprimez les schémas sélectionnés de la connexion MCP du registre des compétences. Les fichiers de compétences téléchargés sont conservés. |
Pour en savoir plus sur les serveurs nommés et les compétences, la sélection des schémas et les téléchargements de projets, consultez la page Ajouter des outils et des compétences.
Gérez votre configuration
Commande | Fonctionnement |
|---|---|
| Affirhez vos dépenses actuelles, le budget total et le pourcentage utilisé. |
| Vérifiez votre installation locale ainsi que la configuration de votre agent, et proposez des corrections pour les problèmes détectés. |
| Installez la dernière version d’Unity Gateway CLI à partir de GitHub. |
| Affichez la configuration de l'agent de codage enregistrée de votre administrateur au format JSON pour pouvoir la réutiliser. |
| Restaurez les fichiers de configuration de l’agent sauvegardés et effacez l’état de configuration enregistré de |
Aide sur les commandes
Utilisez --help pour afficher les options de votre version installée :
Commande | Fonctionnement |
|---|---|
| Afficher les commandes disponibles et les options générales. |
| Afficher les options de configuration du workspace et de l’agent. |
| Afficher les options de download de compétences ou de connexion via MCP. |