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 la tua spesa attuale, il budget totale e la percentuale utilizzata.
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.

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.