Connettiti a OpenCode

Usa OpenCode con modelli, strumenti MCP e competenze tramite Unity Gateway. La CLI Unity Gateway (ug) gestisce l'accesso e la configurazione dello spazio di lavoro, oppure puoi configurare la connessione manualmente.

Prerequisites

Hai bisogno dell'URL dello spazio di lavoro di Azure Databricks e dell'accesso ai modelli, ai servizi MCP e alle competenze che vuoi utilizzare. Per la configurazione manuale, installa OpenCode e usa un token di accesso personale Azure Databricks.

Per la configurazione manuale, sostituisci <workspace-hostname> con il nome host dello spazio di lavoro Azure Databricks e <databricks-pat> con il token. Usa i nomi completi dei modelli disponibili nel tuo workspace e unisci le voci di configurazione ai file esistenti, mantenendo impostazioni non correlate.

Se il tuo amministratore ha già configurato il tuo dispositivo, segui le istruzioni di configurazione della tua organizzazione.

Utilizzare l'interfaccia a riga di comando di Unity Gateway

Installa ug, poi esegui questo comando dalla cartella del progetto:

ug opencode

Seleziona il tuo spazio di lavoro e accedi quando ti viene chiesto. Il comando apre OpenCode con i modelli gateway configurati. Inizia a programmare, oppure inserisci /models per scegliere un altro modello configurato.

Configurare i modelli manualmente

Installa OpenCode, poi unisci questa configurazione in ~/.config/opencode/opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "model": "databricks-anthropic/system.ai.claude-sonnet-4-6",
  "provider": {
    "databricks-anthropic": {
      "npm": "@ai-sdk/anthropic",
      "options": {
        "baseURL": "https://<workspace-hostname>/ai-gateway/anthropic/v1",
        "apiKey": "<databricks-pat>",
        "headers": {
          "Authorization": "Bearer <databricks-pat>"
        }
      },
      "models": {
        "system.ai.claude-sonnet-4-6": {
          "options": {
            "toolStreaming": false
          }
        }
      }
    }
  }
}

Sostituisci il nome del modello in entrambe le posizioni se scegli un altro modello Claude. Mantieni toolStreaming: false per la compatibilità con il gateway. Inizia OpenCode con opencode.

Per i modelli Gemini, aggiungi un provider separato usando @ai-sdk/google, URL https://<workspace-hostname>/ai-gateway/gemini/v1betabase , gli stessi campi di autenticazione e i nomi dei tuoi modelli Gemini. Consulta la documentazione per i fornitori di OpenCode.

Per ridurre il costo per token per compiti di routine, seleziona un modello open source come system.ai.glm-5-2 il tuo modello. Vedere Controllo delle spese.

Aggiungi strumenti MCP

Per utilizzare system.ai.dbsql, system.ai.sandbox, o system.ai.web_search, un amministratore dell'account deve abilitare la beta Unity Gateway dalla pagina delle anteprime della console account. Vedi Gestisci anteprime dell'account.

Utilizzare l'interfaccia a riga di comando di Unity Gateway

Corri!

ug mcp add --agents opencode

Seleziona i tuoi servizi, poi riavvia con ug opencode.

Configura manualmente i servizi MCP

Unisci questa voce in ~/.config/opencode/opencode.json:

{
  "mcp": {
    "dbsql": {
      "type": "remote",
      "url": "https://<workspace-hostname>/ai-gateway/mcp-services/system.ai.dbsql",
      "oauth": false,
      "headers": {
        "Authorization": "Bearer <databricks-pat>"
      }
    }
  }
}

Per un altro servizio, cambia il nome del server e sostituisci system.ai.dbsql con il nome Unity Catalog in tre parti. Riavvia OpenCode e chiedigli di usare uno strumento connesso. Consulta la documentazione MCP di OpenCode.

ug opencode usa ~/.ucode/opencode-xdg/opencode/opencode.json. Usa quel file per gli inserimenti manuali di MCP quando avvii MCP tramite ug.

Aggiungere competenze

Utilizzare l'interfaccia a riga di comando di Unity Gateway

Scarica le competenze pubblicate:

ug skills add

Scegli le tue competenze, poi riavvia OpenCode. Legge i download da ~/.agents/skills/ e carica le funzionalità pertinenti mentre lavori.

Configura manualmente le competenze

Per i file che hai già, inserisci la cartella completa di ogni skill in ~/.agents/skills/ o nel .opencode/skills/ del tuo progetto. Consulta la documentazione sulle competenze di OpenCode.

Per accedere al registro delle abilità pubblicato tramite MCP, aggiungi un secondo server usando l'esempio MCP sopra, chiamalo databricks-skill-registry, e imposta url .https://<workspace-hostname>/ai-gateway/skills/ Mantieni la barra finale, l'intestazione Bearer e oauth: false. Chiedi all'agente di usare un'abilità con il nome completo.

Le abilità Unity Gateway sono in Beta. Vedi Competenze di Governo per abilitazione e permessi.

Troubleshooting

Una richiesta modello fallisce: Controlla l'URL del gateway, la scadenza del token, il nome del modello e i permessi.

Manca un server MCP: Riavvia l'agente. Se l'hai configurato con ug, avvialo con ug opencode in modo che utilizzi le stesse impostazioni. Per la configurazione manuale, controlla ~/.config/opencode/opencode.json e il bearer token.

Manca una skill scaricata: Verifica che la relativa cartella completa contenga SKILL.md in una directory supportata. Rigioca ug skills add con le stesse opzioni per aggiornare le abilità scaricate.

Per problemi di login o ug configurazione dello spazio di lavoro, esegui ug doctor.

Passaggi successivi

  • Ultimo aggiornamento: