Inizia con gli agenti di codifica

Unity Gateway collega agenti di codifica come Claude Code, Codex e OpenCode a modelli provenienti da più provider, strumenti MCP e competenze condivise. Scegli un modello per il compito, dai al tuo agente accesso ai dati aziendali e utilizza i flussi di lavoro del tuo team.

Puoi connetterti in due modi:

• Uso ug (consigliato): installa la CLI del Gateway Unity, accedi e avvia il tuo agente preferito. ug gestisce le impostazioni di connessione specifiche dell'agente e applica la configurazione della tua organizzazione, così puoi iniziare a programmare senza modificare file di configurazione o scrivere script di setup.
• Configura tu stesso la connessione: Inserisci l'endpoint gateway e le impostazioni di autenticazione nel tuo agente. Consulta Agenti di codifica supportati per scegliere il tuo agente e apri la sua guida per la configurazione desktop e CLI.

Questa guida ti spiega come usare ug.

Prerequisites

È necessario:

• L'URL dello spazio di lavoro di Azure Databricks e l'accesso ai modelli che vuoi utilizzare. Chiedi al tuo amministratore se non hai queste.
• Python 3.12 o versione successiva e uv.
• Un diritto allo spazio di lavoro: Accesso all'area di lavoro, o accesso Consumer con l'anteprima Accesso Consumer a Unity Gateway abilitata per il tuo account (Anteprima pubblica). Vedi Gestire i diritti e Gestire le anteprime di Azure Databricks.

Configura ed esegui il tuo agente

Installa ug

Nel terminale eseguire:

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

Per verificare l'installazione, esegui:

ug --version

Verrà visualizzato il numero di versione installato.

Avvia il tuo agente

Apri un terminale nella directory del progetto. Esegui il comando per l'agente che vuoi usare:

Claude Code

ug claude

Codex

ug codex

Interfaccia della riga di comando gemini

ug gemini

OpenCode

ug opencode

interfaccia della riga di comando (CLI) di GitHub Copilot

ug copilot

Pi

ug pi

Al primo utilizzo, segui le istruzioni per selezionare il tuo spazio di lavoro e accedere. ug gestisce la connessione a Unity Gateway, poi apre l'agente scelto con la stessa interfaccia e flusso di lavoro che già conosci. Puoi iniziare subito a usarla.

Per cambiare modello durante una sessione, usa /model per scegliere tra quelli resi disponibili dalla tua organizzazione.

Aggiungere strumenti e competenze

Nel terminale eseguire:

ug mcp add
ug skills add

Scegli i server MCP e le competenze che vuoi aggiungere tra quelle a cui hai accesso. Gli strumenti MCP collegano il tuo agente a dati e servizi; le competenze forniscono istruzioni per compiti specifici.

Poi avvia o riavvia il tuo agente per usare ciò che hai aggiunto:

I comandi di taglio variano a seconda dell'agente. Controlla il menu di aiuto per comandi modello, MCP e abilità. Vedi Aggiungi strumenti e competenze per ulteriori opzioni di configurazione.

Controlla il tuo utilizzo

Nel terminale eseguire:

ug usage

Vedrai quanto hai speso e quanto del tuo budget hai speso.

Passaggi successivi

• riferimento alla CLI UG
• Agenti di codifica supportati