ug CLI-Referenz

Verwenden Sie die Unity Gateway CLI (ug), um Coding-Agenten zu konfigurieren und zu starten. Für eine Anleitung siehe den Quickstart des Coding-Agenten.

Installieren

Installieren ugund dann die installierte Version überprüfen:

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

Für die Anforderungen siehe die Quickstart-Voraussetzungen.

Konfigurieren

Befehl	Was es bewirkt
ug configure	Melden Sie sich in einem Azure Databricks Arbeitsbereich an und konfigurieren Sie Ihre Agenten mit den Einstellungen Ihres Admins oder der geleiteten Einrichtung.
ug configure --workspace https://your-workspace.databricks.com	Konfigurieren Sie Ihre Agenten so, dass sie den Arbeitsbereich unter der angegebenen URL verwenden.
ug configure --profile <name> --use-pat	Authentifiziere dich mit einem persönlichen Zugriffstoken statt mit OAuth. Führe databricks configure --host <workspace-url> zuerst aus, um dein Token in einem Konfigurationsprofil zu speichern, und gib dann dieses Profil mit --profile (zum Beispiel --profile DEFAULT). Das Profil liefert die URL des Arbeitsbereichs.

Einen Agenten einsetzen

Diese Befehle öffnen den Agenten in deinem Terminal, bereit für deinen üblichen Codier-Workflow.

Befehl	Was es bewirkt
ug	Starten Sie den von der veröffentlichten Arbeitsflächenkonfiguration Ihres Administrators ausgewählten Agenten.
ug claude	Claude Code über Unity Gateway starten.
ug codex	Codex über Unity Gateway starten.
ug gemini	Starte Gemini CLI über Unity Gateway.
ug opencode	OpenCode über Unity Gateway starten.
ug copilot	Starte GitHub Copilot CLI über Unity Gateway.
ug pi	Starte Pi über Unity Gateway.
ug cursor	Cursor-Agent starten. Modellanfragen nutzen Sie Ihr Cursor-Konto.

Für Claude Code oder Codex fügen --refresh Sie vor dem Start die Arbeitsbereichs-Authentifizierung, Modelle und Konfigurationen hinzu. Du kannst auch agentenspezifische Argumente an den Startbefehl weitergeben.

MCP-Server

Befehl	Was es bewirkt
ug mcp add	Wählen Sie MCP-Server aus und fügen Sie deren Verbindungen zu Ihren konfigurierten Agenten hinzu.
ug mcp list	Zeigen Sie konfigurierte MCP-Server und den von jedem Agenten gemeldeten Status.
ug mcp remove	Wählen Sie MCP-Verbindungen aus, die Sie von Ihren Agenten entfernen möchten. Die Server bleiben im Arbeitsbereich.

Fähigkeiten

Befehl	Was es bewirkt
ug skills add	Wählen Sie veröffentlichte Fähigkeiten aus und laden Sie deren Dateien in lokale Agenten-Fertigkeitsverzeichnisse herunter.
ug skills add --via mcp	Verbinde Skills aus ausgewählten Unity-Catalog-Schemata über MCP, ohne Dateien herunterladen zu müssen.
ug skills list	Zeige die für deine Agenten konfigurierten Fähigkeiten und wie sie hinzugefügt wurden.
ug skills remove	Wählen Sie heruntergeladene Fertigkeitsordner aus, die Sie von Ihrem Computer löschen möchten. Veröffentlichte Fähigkeiten bleiben unverändert.
ug skills remove --via mcp	Entferne ausgewählte Schemata aus der MCP-Verbindung des Skill-Registers. Heruntergeladene Fertigkeitsdateien werden aufbewahrt.

Für benannte Server und Fähigkeiten, Schema-Auswahl und Projektdownloads siehe Werkzeuge und Fähigkeiten hinzufügen.

Verwalten Sie Ihr Setup

Befehl	Was es bewirkt
ug usage	Zeigen Sie Ihre aktuellen Ausgaben, Ihr Gesamtbudget und Ihren verwendeten Prozentsatz an.
ug doctor	Überprüfen Sie Ihre lokale Installation und Agentenkonfiguration und bieten Sie Lösungen für gefundene Probleme an.
ug upgrade	Installiere die neueste Unity Gateway CLI-Version von GitHub.
ug export	Drucke die gespeicherte Coding-Agent-Konfiguration deines Administrators als JSON zur Wiederverwendung aus.
ug revert	Wiederherstelle die gesicherten Agenten-Konfigurationsdateien und lösche ugden gespeicherten Setup-Zustand.

Kommandohilfe

Nutze --help sie, um die Optionen für deine installierte Version zu sehen:

Befehl	Was es bewirkt
ug --help	Zeigen Sie verfügbare Befehle und allgemeine Optionen an.
ug configure --help	Zeigen Sie Arbeitsflächen und Agenteneinrichtungsoptionen.
ug skills add --help	Zeige Optionen zum Herunterladen von Fähigkeiten oder zum Verbinden über MCP.