Referensi ug CLI

Gunakan CLI Unity Gateway (ug) untuk mengonfigurasi dan menjalankan agen pengkodean. Untuk panduan, lihat quickstart agen coding.

Install

Instal, uglalu periksa versi yang terpasang:

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

Untuk persyaratan, lihat prasyarat quickstart.

Configure

Perintah	Apa fungsinya
ug configure	Masuk ke workspace Azure Databricks dan konfigurasikan agen Anda menggunakan pengaturan admin atau pengaturan terpandu Anda.
ug configure --workspace https://your-workspace.databricks.com	Konfigurasikan agen Anda untuk menggunakan workspace pada URL yang ditentukan.
ug configure --profile <name> --use-pat	Autentikasi dengan token akses pribadi sebagai pengganti OAuth. Pertama jalankan databricks configure --host <workspace-url> untuk menyimpan token Anda di profil konfigurasi, lalu berikan profil tersebut dengan --profile (misalnya, --profile DEFAULT). Profil menyediakan URL workspace.

Luncurkan agen

Perintah-perintah ini membuka agen di terminal Anda, siap untuk alur kerja pemrograman biasa Anda.

Perintah	Apa fungsinya
ug	Jalankan agen yang dipilih berdasarkan konfigurasi workspace yang dipublikasikan oleh admin Anda.
ug claude	Luncurkan Claude Code melalui Unity Gateway.
ug codex	Luncurkan Codex melalui Unity Gateway.
ug gemini	Luncurkan Gemini CLI melalui Unity Gateway.
ug opencode	Luncurkan OpenCode melalui Unity Gateway.
ug copilot	Luncurkan GitHub Copilot CLI melalui Unity Gateway.
ug pi	Jalankan Pi melalui Unity Gateway.
ug cursor	Luncurkan Agen Kursor. Permintaan model menggunakan akun Cursor Anda.

Untuk Claude Code atau Codex, tambahkan --refresh untuk menyegarkan autentikasi workspace, model, dan konfigurasi sebelum meluncurkan. Anda juga dapat meneruskan argumen khusus agen ke perintah peluncuran.

Server MCP

Perintah	Apa fungsinya
ug mcp add	Pilih server MCP dan tambahkan koneksi mereka ke agen yang telah dikonfigurasi.
ug mcp list	Tampilkan server MCP yang dikonfigurasi dan status yang dilaporkan oleh setiap agen.
ug mcp remove	Pilih koneksi MCP yang akan dihapus dari agen Anda. Server tetap berada di ruang kerja.

Keterampilan

Perintah	Apa fungsinya
ug skills add	Pilih keterampilan yang dipublikasikan dan unduh file mereka ke direktori keterampilan agen lokal.
ug skills add --via mcp	Hubungkan keterampilan dari skema Unity Catalog yang dipilih melalui MCP, tanpa mengunduh file.
ug skills list	Tunjukkan keterampilan yang dikonfigurasi untuk agen Anda dan bagaimana keterampilan tersebut ditambahkan.
ug skills remove	Pilih folder keterampilan yang diunduh untuk dihapus dari komputer Anda. Keterampilan yang diterbitkan tetap tidak berubah.
ug skills remove --via mcp	Hapus skema yang dipilih dari koneksi MCP di registri keterampilan. File skill yang diunduh akan disimpan.

Untuk server dan keterampilan bernama, pemilihan skema, dan unduhan proyek, lihat Tambah alat dan keterampilan.

Kelola pengaturan Anda

Perintah	Apa fungsinya
ug usage	Tampilkan pengeluaran saat ini, total anggaran, dan persentase yang digunakan.
ug doctor	Periksa instalasi lokal dan konfigurasi agen Anda, serta tawarkan solusi untuk masalah yang ditemukan.
ug upgrade	Instal versi CLI Unity Gateway terbaru dari GitHub.
ug export	Cetak konfigurasi agen pengkodean admin Anda yang tersimpan sebagai JSON untuk digunakan kembali.
ug revert	Pulihkan file konfigurasi agen yang terbackup dan hapus ugstatus setup yang tersimpan.

Bantuan perintah

Gunakan --help untuk melihat opsi versi yang terpasang:

Perintah	Apa fungsinya
ug --help	Tampilkan perintah yang tersedia dan opsi umum.
ug configure --help	Tampilkan opsi pengaturan workspace dan agen.
ug skills add --help	Tampilkan opsi untuk mengunduh keterampilan atau menghubungkannya melalui MCP.