referencja ug CLI

Użyj CLI Unity Gateway ()ug do konfiguracji i uruchamiania agentów kodujących. Aby uzyskać poradnik po przeglądzie, zobacz quickstart agenta kodującego.

Install

Zainstaluj ug, a potem sprawdź zainstalowaną wersję:

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

Wymagania znajdziesz w szybkim etapie wstępnym.

Configure

Polecenie	Do czego służy
ug configure	Zaloguj się do przestrzeni roboczej Azure Databricks i skonfiguruj swoich agentów, korzystając z ustawień administratora lub konfiguracji prowadzonej.
ug configure --workspace https://your-workspace.databricks.com	Konfiguruj swoich agentów, aby korzystali z przestrzeni roboczej na wskazanym URL.
ug configure --profile <name> --use-pat	Uwierzytelnij się za pomocą osobistego tokena dostępu zamiast OAuth. Najpierw uruchom databricks configure --host <workspace-url> zapis tokena w profilu konfiguracyjnym, a następnie przekaż ten profil (na przykład --profile DEFAULT).--profile Profil podaje adres URL workspace.

Uruchom agenta

Te polecenia otwierają agenta w terminalu, gotowego do zwykłego procesu kodowania.

Polecenie	Do czego służy
ug	Uruchom agenta wybranego przez opublikowaną przez administratora konfigurację przestrzeni roboczej.
ug claude	Uruchom kod Claude'a przez Unity Gateway.
ug codex	Uruchom Codex przez Unity Gateway.
ug gemini	Uruchom Gemini CLI przez Unity Gateway.
ug opencode	Uruchom OpenCode przez Unity Gateway.
ug copilot	Uruchom GitHub Copilot CLI przez Unity Gateway.
ug pi	Uruchom Pi przez Unity Gateway.
ug cursor	Uruchom Agenta Kursora. Żądania modeli korzystają z twojego konta Cursor.

W przypadku kodu Claude lub Codexu dodaj --refresh uwierzytelnianie do odświeżania przestrzeni roboczej, modele i konfigurację przed uruchomieniem. Możesz też przekazywać argumenty specyficzne dla agentów do polecenia launch.

Serwery MCP

Polecenie	Do czego służy
ug mcp add	Wybierz serwery MCP i dodaj ich połączenia do skonfigurowanych agentów.
ug mcp list	Pokaż skonfigurowane serwery MCP oraz status raportowany przez każdego agenta.
ug mcp remove	Wybierz połączenia MCP, które chcesz usunąć z agentów. Serwery pozostają w przestrzeni roboczej.

Skills

Polecenie	Do czego służy
ug skills add	Wybierz opublikowane umiejętności i pobierz ich pliki do lokalnych katalogów umiejętności agentów.
ug skills add --via mcp	Połącz umiejętności z wybranych schematów Unity Catalog przez MCP, bez pobierania plików.
ug skills list	Pokaż umiejętności skonfigurowane dla twoich agentów i jak zostały dodane.
ug skills remove	Wybierz pobrane foldery umiejętności, które chcesz usunąć z komputera. Opublikowane umiejętności pozostają niezmienione.
ug skills remove --via mcp	Usuń wybrane schematy z połączenia MCP rejestru umiejętności. Pobrane pliki umiejętności są przechowywane.

Aby uzyskać nazwy serwerów i umiejętności, wybór schematu oraz pobranie projektów, zobacz Dodaj narzędzia i umiejętności.

Zarządzaj swoim setupem

Polecenie	Do czego służy
ug usage	Pokaż odpowiednie limity wydatków oraz procent wykorzystania. Zobacz Sprawdź swoje użytkowanie.
ug doctor	Sprawdź lokalną instalację i konfigurację agenta i zaproponuj rozwiązania wykrytych problemów.
ug upgrade	Zainstaluj najnowszą wersję CLI Unity Gateway z GitHub.
ug export	Wydrukuj zapisaną konfigurację agenta kodującego administratora jako JSON do ponownego użycia.
ug revert	Przywróć pliki konfiguracyjne zarchiwizowanych agentów i wyczyść ugzapisany stan konfiguracji.

Sprawdź swoje użytkowanie

Zobacz limity wydatków Unity Gateway, które dotyczą Ciebie.

Polecenie	Do czego służy
ug usage	Pokaż do pięciu obowiązujących limitów wydatków, uporządkowanych od najwyższego do najniższego procentu wykorzystania.
ug usage --all	Pokaż wszystkie obowiązujące limity wydatków w tej samej kolejności.

Każdy wpis zawiera krótki identyfikator budżetu oraz jedną z następujących etykiet:

Label	Co pokazuje
Miesięczny limit osobisty	Twoje zużycie w odniesieniu do progu na użytkownika w budżecie za dany miesiąc.
Miesięczny limit współdzielony	Łączne zużycie użytkowników objętych budżetem względem wspólnego progu na ten miesiąc.
Dzienny limit osobowy	Twoje zużycie w porównaniu z progiem budżetowym na użytkownika na dany dzień.
Dzienny limit współdzielony	Łączne zużycie użytkowników objętych budżetem względem wspólnego progu na dany dzień.

Twoje wydatki mogą być liczone do wielu obowiązujących limitów. Pojedynczy budżet może zawierać kilka limitów, więc wiele wpisów może dzielić ten sam identyfikator budżetu.

Więcej informacji o budżetach i progach można znaleźć w sekcji Zarządzaj budżetami dla Unity Gateway.

Pomoc w dowództwie

Użyj opcji --help dla zainstalowanej wersji:

Polecenie	Do czego służy
ug --help	Pokaż dostępne komendy i ogólne opcje.
ug configure --help	Pokaż opcje przestrzeni roboczej i ustawień agenta.
ug skills add --help	Pokaż opcje pobierania umiejętności lub łączenia ich przez MCP.