reference ug CLI

Použijte Unity Gateway CLI (ug) pro konfiguraci a spuštění kódovacích agentů. Pro návod viz kód agent quickstart.

Install

Instaluj , pak zkontroluj ugnainstalovanou verzi:

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

Vyžaduje uv Python 3.12 nebo novější.

Configure

Command	Jak funguje
ug configure	Přihlaste se do pracovního prostoru Azure Databricks a nastavte své agenty pomocí nastavení nebo vedeného nastavení vašeho administrátora.
ug configure --workspace https://your-workspace.databricks.com	Nakonfigurujte své agenty tak, aby používali pracovní prostor na určené URL.
ug configure --profile <name> --use-pat	Autentizujte se pomocí osobního přístupového tokenu místo OAuth. Nejprve spusťte databricks configure --host <workspace-url> uložení tokenu do konfiguračního profilu, pak tento profil pošlete (například --profile DEFAULT).--profile Profil poskytuje URL pracovního prostoru.

Spustit agenta

Tyto příkazy otevřou agenta ve vašem terminálu, připraveného pro běžný programátorský postup.

Command	Jak funguje
ug	Spusť agenta vybraného konfigurací pracovního prostoru vašeho administrátora.
ug claude	Spusť Claude Code přes Unity Gateway.
ug codex	Spusť Codex přes Unity Gateway.
ug gemini	Spusťte Gemini CLI přes Unity Gateway.
ug opencode	Spusť OpenCode přes Unity Gateway.
ug copilot	Spusťte GitHub Copilot CLI přes Unity Gateway.
ug pi	Spusť Pi přes Unity Gateway.
ug cursor	Spusť Cursor Agent. Požadavky na model použijte váš účet Cursor.

Pro Claude Code nebo Codex přidejte --refresh obnovu autentizace pracovního prostoru, modely a konfigurace před spuštěním. Můžete také předávat argumenty specifické pro agenta příkazu launch.

Servery MCP

Command	Jak funguje
ug mcp add	Vyberte MCP servery a přidejte jejich připojení ke svým nakonfigurovaným agentům.
ug mcp list	Zobrazit konfigurované MCP servery a stav hlášený každým agentem.
ug mcp remove	Vyberte MCP připojení, která chcete odstranit ze svých agentů. Servery zůstávají v pracovním prostoru.

Kvalifikace

Command	Jak funguje
ug skills add	Vyberte publikované dovednosti a stáhněte jejich soubory do místních adresářů dovedností agentů.
ug skills add --via mcp	Propojte dovednosti z vybraných schémat Unity Catalog přes MCP, bez nutnosti stahovat soubory.
ug skills list	Ukažte dovednosti nastavené pro vaše agenty a jak byly přidány.
ug skills remove	Vyberte stažené složky dovedností, které chcete smazat z počítače. Publikované dovednosti zůstávají nezměněny.
ug skills remove --via mcp	Odstraňte vybrané schémata z MCP spojení registru dovedností. Stažené soubory dovedností jsou uchovávány.

Pro pojmenované servery a dovednosti, výběr schémat a stahování projektů viz Přidat nástroje a dovednosti.

Spravujte své zařízení

Command	Jak funguje
ug usage	Uveďte své aktuální výdaje, celkový rozpočet a procento využití.
ug doctor	Zkontrolujte místní instalaci a konfiguraci agenta a nabídněte řešení nalezených problémů.
ug upgrade	Nainstalujte nejnovější verzi Unity Gateway CLI z GitHub.
ug export	Vytiskněte uloženou konfiguraci kódovacího agenta vašeho administrátora jako JSON pro opětovné použití.
ug revert	Obnovte zálohované konfigurační soubory agenta a vymažte uguložený stav nastavení.

Pomoc s velením

Použijte to --help pro zobrazení možností pro vaši nainstalovanou verzi:

Command	Jak funguje
ug --help	Zobrazit dostupné příkazy a obecné možnosti.
ug configure --help	Zobrazit možnosti pracovního prostoru a nastavení agenta.
ug skills add --help	Zobrazit možnosti stahování dovedností nebo jejich propojení přes MCP.