Référence CLI ug

Utilisez la ligne de commande Unity Gateway (ug) pour configurer et lancer des agents de codage. Pour un guide, consultez le quickstart de l’agent de codage.

Install

Installez ug, puis vérifiez la version installée :

uv tool install git+https://github.com/databricks/unity-gateway
ug --version

Pour les exigences, consultez les prérequis de démarrage rapide.

Configure

Command Qu’est-ce que cela fait ?
ug configure Connectez-vous à un espace de travail Azure Databricks et configurez vos agents en utilisant les paramètres de votre administrateur ou la configuration guidée.
ug configure --workspace https://your-workspace.databricks.com Configurez vos agents pour utiliser l’espace de travail à l’URL spécifiée.
ug configure --profile <name> --use-pat Authentifiez avec un jeton d’accès personnel au lieu d’un OAuth. D’abord, lance databricks configure --host <workspace-url> pour enregistrer ton jeton dans un profil de configuration, puis passe ce profil avec --profile (par exemple, --profile DEFAULT). Le profil fournit l’URL de l’espace de travail.

Lancez un agent

Ces commandes ouvrent l’agent dans votre terminal, prêt pour votre flux de travail de codage habituel.

Command Qu’est-ce que cela fait ?
ug Lancez l’agent sélectionné par la configuration de l’espace de travail publiée par votre administrateur.
ug claude Lancez Claude Code via Unity Gateway.
ug codex Lancez le Codex via Unity Gateway.
ug gemini Lancez la ligne de commande Gemini via Unity Gateway.
ug opencode Lancez OpenCode via Unity Gateway.
ug copilot Lancez la CLI de GitHub Copilot via Unity Gateway.
ug pi Lancez Pi via Unity Gateway.
ug cursor Lancez l’agent du curseur. Les demandes de modèles utilisent votre compte Cursor.

Pour Claude Code ou Codex, ajoutez --refresh à rafraîchir l’authentification de l’espace de travail, les modèles et la configuration avant le lancement. Vous pouvez aussi transmettre des arguments spécifiques à l’agent à la commande de lancement.

Serveurs MCP

Command Qu’est-ce que cela fait ?
ug mcp add Sélectionnez les serveurs MCP et ajoutez leurs connexions à vos agents configurés.
ug mcp list Affichez les serveurs MCP configurés et le statut rapporté par chaque agent.
ug mcp remove Sélectionnez les connexions MCP à retirer de vos agents. Les serveurs restent dans l’espace de travail.

Compétences

Command Qu’est-ce que cela fait ?
ug skills add Sélectionnez les compétences publiées et téléchargez leurs fichiers dans les annuaires locaux des agents.
ug skills add --via mcp Reliez des compétences issues de schémas sélectionnés du catalogue Unity via MCP, sans télécharger de fichiers.
ug skills list Montrez les compétences configurées pour vos agents et comment elles ont été ajoutées.
ug skills remove Sélectionnez les dossiers de compétences téléchargés pour les supprimer de votre ordinateur. Les compétences publiées restent inchangées.
ug skills remove --via mcp Supprimez les schémas sélectionnés de la connexion MCP du registre de compétences. Les fichiers de compétences téléchargés sont conservés.

Pour les serveurs et compétences nommés, la sélection de schémas et les téléchargements de projets, voir Ajouter des outils et compétences.

Gérez votre installation

Command Qu’est-ce que cela fait ?
ug usage Affichez les limites de dépenses applicables et le pourcentage utilisé. Voir Vérifiez votre consommation.
ug doctor Vérifiez votre installation locale et la configuration de votre agent, et proposez des solutions pour les problèmes rencontrés.
ug upgrade Installez la dernière version de la CLI de Unity Gateway depuis GitHub.
ug export Imprimez la configuration de l’agent de codage sauvegardé de votre administrateur en JSON pour la réutilisation.
ug revert Restaurez les fichiers de configuration de l’agent sauvegardés et effacez ugl’état de configuration sauvegardé.

Vérifie ton usage

Consultez les limites de dépenses Unity Gateway qui s’appliquent à vous.

Command Qu’est-ce que cela fait ?
ug usage Affichez jusqu’à cinq plafonds de dépenses applicables, classés du plus élevé au plus bas pourcentage utilisé.
ug usage --all Affichez toutes les limites de dépenses applicables dans le même ordre.

Chaque entrée inclut un court ID de budget et l’une des étiquettes suivantes :

Étiquette Ce qu’il montre
Limite personnelle mensuelle Votre utilisation par rapport au seuil par utilisateur du budget pour le mois.
Limite partagée mensuelle Utilisation combinée entre utilisateurs couverte par le budget par rapport à son seuil partagé pour le mois.
Limite personnelle quotidienne Votre utilisation par rapport au seuil par utilisateur du budget pour la journée.
Limite quotidienne partagée Utilisation combinée entre les utilisateurs couverts par le budget par rapport à son seuil partagé pour la journée.

Vos dépenses peuvent compter dans plusieurs plafonds applicables. Un seul budget peut contenir plusieurs limites, donc plusieurs entrées peuvent partager un identifiant de budget.

Pour plus d’informations sur les budgets et les seuils, voir Gérer les budgets pour Unity Gateway.

Aide au commandement

Utilisez --help pour voir les options pour votre version installée :

Command Qu’est-ce que cela fait ?
ug --help Affichez les commandes disponibles et les options générales.
ug configure --help Affichez les options de configuration de l’espace de travail et des agents.
ug skills add --help Montre des options pour télécharger des compétences ou les connecter via MCP.
  • Dernière mise à jour :