riferimento alla CLI UG

Usa la CLI Gateway di Unity (ug) per configurare e avviare gli agenti di codifica. Per una guida, consulta l'avvio rapido dell'agente di codifica.

Install

Installa ug, poi controlla la versione installata:

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

Per i requisiti, consulta i prerequisiti di avvio rapido.

Configure

Comando	Funzionamento
ug configure	Accedi a uno spazio di lavoro Azure Databricks e configura i tuoi agenti usando le impostazioni del tuo amministratore o la configurazione guidata.
ug configure --workspace https://your-workspace.databricks.com	Configura i tuoi agenti per usare lo spazio di lavoro all'URL specificato.
ug configure --profile <name> --use-pat	Autentica con un token di accesso personale invece di OAuth. Prima esegui databricks configure --host <workspace-url> per salvare il token in un profilo di configurazione, poi passa quel profilo con --profile (ad esempio, --profile DEFAULT). Il profilo fornisce l'URL dello spazio di lavoro.

Lancia un agente

Questi comandi aprono l'agente nel tuo terminale, pronto per il tuo consueto flusso di lavoro di codifica.

Comando	Funzionamento
ug	Avvia l'agente selezionato dalla configurazione dello spazio di lavoro pubblicata dal tuo amministratore.
ug claude	Avvia Claude Code tramite Unity Gateway.
ug codex	Avvia Codex tramite Unity Gateway.
ug gemini	Avvia la CLI Gemini tramite Unity Gateway.
ug opencode	Avvia OpenCode tramite Unity Gateway.
ug copilot	Avvia GitHub Copilot CLI tramite Unity Gateway.
ug pi	Avvia Pi tramite Unity Gateway.
ug cursor	Avvia l'Agente Cursore. Le richieste di modello usano il tuo account Cursor.

Per Claude Code o Codex, aggiungi --refresh all'aggiornamento autenticazione dello spazio di lavoro, modelli e configurazione prima di avviare. Puoi anche passare argomentazioni specifiche dell'agente al comando di lancio.

Server MCP

Comando	Funzionamento
ug mcp add	Seleziona i server MCP e aggiungi le loro connessioni ai tuoi agenti configurati.
ug mcp list	Mostra i server MCP configurati e lo stato riportato da ciascun agente.
ug mcp remove	Seleziona le connessioni MCP da rimuovere dai tuoi agenti. I server rimangono nello spazio di lavoro.

Competenze

Comando	Funzionamento
ug skills add	Seleziona le competenze pubblicate e scarica i loro file nelle directory di abilità degli agenti locali.
ug skills add --via mcp	Collega le competenze di alcuni schemi selezionati del catalogo Unity tramite MCP, senza scaricare file.
ug skills list	Mostra le competenze configurate per i tuoi agenti e come sono state aggiunte.
ug skills remove	Seleziona le cartelle delle abilità scaricate per eliminarle dal computer. Le competenze pubblicate rimangono invariate.
ug skills remove --via mcp	Rimuovi gli schemi selezionati dalla connessione MCP del registro delle abilità. I file delle abilità scaricati sono conservati.

Per server e competenze nominate, selezione degli schemi e download di progetti, vedi Aggiungi strumenti e competenze.

Gestisci la tua configurazione

Comando	Funzionamento
ug usage	Mostra i limiti di spesa applicabili e la percentuale utilizzata. Vedi Controlla il tuo consumo.
ug doctor	Controlla la configurazione locale dell'installazione e dell'agente, e offri soluzioni per i problemi riscontrati.
ug upgrade	Installa l'ultima versione della CLI di Unity Gateway da GitHub.
ug export	Stampa la configurazione dell'agente di codifica salvata dall'amministratore come JSON per il riutilizzo.
ug revert	Ripristina i file di configurazione dell'agente salvati e cancella uglo stato di configurazione salvato.

Controlla il tuo utilizzo

Visualizza i limiti di spesa per Unity Gateway che ti riguardano.

Comando	Funzionamento
ug usage	Mostrate fino a cinque limiti di spesa applicabili, ordinati dalla percentuale più alta alla percentuale più bassa utilizzata.
ug usage --all	Mostra tutti i limiti di spesa applicabili nello stesso ordine.

Ogni voce include un breve ID di budget e una delle seguenti etichette:

Label	Cosa mostra
Limite personale mensile	Il tuo utilizzo rispetto alla soglia per utente del budget per il mese.
Limite condiviso mensile	Utilizzo combinato tra gli utenti coperto dal budget rispetto alla soglia condivisa per il mese.
Limite personale giornaliero	Il tuo utilizzo rispetto alla soglia giornaliera per utente prevista dal budget.
Limite condiviso giornaliero	Utilizzo combinato tra gli utenti coperti dal budget rispetto alla soglia condivisa per la giornata.

Le tue spese possono conteggiare per diversi limiti applicabili. Un singolo budget può contenere diversi limiti, quindi più voci possono condividere un ID di budget.

Per maggiori informazioni su budget e soglie, vedi Gestire i budget per Unity Gateway.

Aiuto al comando

Usa --help per vedere le opzioni per la versione installata:

Comando	Funzionamento
ug --help	Mostra i comandi disponibili e le opzioni generali.
ug configure --help	Mostra le opzioni di configurazione dello spazio di lavoro e dell'agente.
ug skills add --help	Mostra le opzioni per scaricare le competenze o collegarle tramite MCP.