Connect OpenCode

Nutze OpenCode mit Modellen, MCP-Tools und Fähigkeiten über Unity Gateway. Die Unity Gateway CLI (ug) übernimmt die Anmeldung und Konfiguration des Arbeitsbereichs, oder Sie können die Verbindung manuell konfigurieren.

Prerequisites

Sie benötigen die URL Ihres Azure Databricks Arbeitsbereichs sowie Zugriff auf die Modelle, MCP-Dienste und Fähigkeiten, die Sie nutzen möchten. Für die manuelle Einrichtung installieren Sie OpenCode und haben Sie ein Azure Databricks Personal Access Token.

Für die manuelle Konfiguration ersetzen Sie <workspace-hostname> durch den Hostnamen Ihres Azure-Databricks-Arbeitsbereichs und <databricks-pat> durch Ihr Token. Nutze vollständige Modellnamen, die in deinem Arbeitsbereich verfügbar sind, und füge Konfigurationseinträge in bestehende Dateien ein, wobei du nicht zusammenhängende Einstellungen beibehältst.

Wenn dein Administrator dein Gerät bereits konfiguriert hat, folge den Einrichtungsanweisungen deiner Organisation.

Verwenden Sie die Unity Gateway CLI

Installiere und führe ugdann diesen Befehl aus deinem Projektverzeichnis aus:

ug opencode

Wählen Sie Ihren Arbeitsbereich aus und melden Sie sich an, wenn Sie aufgefordert werden. Der Befehl öffnet OpenCode mit konfigurierten Gateway-Modellen. Beginnen Sie mit dem Programmieren oder geben Sie /models ein, um ein anderes konfiguriertes Modell auszuwählen.

Modelle manuell konfigurieren

Installiere OpenCode und füge diese Konfiguration dann zusammen 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
          }
        }
      }
    }
  }
}

Ersetze den Modellnamen an beiden Orten, wenn du ein anderes Claude-Modell wählst. Behalten Sie toolStreaming: false zur Gateway-Kompatibilität bei. Starte OpenCode mit opencode.

Für Gemini-Modelle fügen Sie einen separaten Anbieter hinzu, der @ai-sdk/googledie Basis-URL https://<workspace-hostname>/ai-gateway/gemini/v1beta, die gleichen Authentifizierungsfelder und Ihre Gemini-Modellnamen verwendet. Siehe die Anbieterdokumentation von OpenCode.

Um die Kosten pro Token für routinemäßige Aufgaben zu senken, wählen Sie ein Open Source-Modell wie system.ai.glm-5-2 Ihr eigenes Modell. Siehe Kontrollausgaben.

MCP-Werkzeuge hinzufügen

Um system.ai.sandbox, system.ai.web_search oder system.ai.dbsql zu verwenden, muss ein Kontoadministrator die Beta Unity Gateway auf der Seite Previews der Kontokonsole aktivieren. Siehe Kontovorschauen verwalten.

Verwenden Sie die Unity Gateway CLI

Laufen:

ug mcp add --agents opencode

Wählen Sie Ihre Dienste aus und starten Sie sie dann mit ug opencode neu.

MCP-Dienste manuell konfigurieren

Fügen Sie diesen Eintrag zusammen 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>"
      }
    }
  }
}

Für einen anderen Dienst ändern Sie den Servernamen und ersetzen system.ai.dbsql durch dessen dreiteiligen Unity Catalog-Namen. Starte OpenCode neu und bitte darum, ein verbundenes Tool zu verwenden. Siehe die MCP-Dokumentation von OpenCode.

ug opencode verwendet ~/.ucode/opencode-xdg/opencode/opencode.json. Verwenden Sie diese Datei für manuelle MCP-Einträge beim Start durch ug.

Hinzufügen von Fähigkeiten

Verwenden Sie die Unity Gateway CLI

Veröffentlichte Skills herunterladen:

ug skills add

Wähle deine Fähigkeiten aus und starte OpenCode neu. Er liest die Downloads aus ~/.agents/skills/ aus und lädt relevante Fähigkeiten, während Sie arbeiten.

Fähigkeiten manuell konfigurieren

Für Dateien, die du bereits hast, lege jeden vollständigen Skill-Ordner in ~/.agents/skills/ oder in den .opencode/skills/ deines Projekts. Siehe die Dokumentation der Fähigkeiten von OpenCode.

Um über MCP auf das veröffentlichte Fertigkeitsregister zuzugreifen, fügen Sie einen zweiten Server mit dem oben genannten MCP-Beispiel hinzu, benennen Sie ihn databricks-skill-registryund setzen url Sie auf https://<workspace-hostname>/ai-gateway/skills/. Behalten Sie den abschließenden Schrägstrich, den Bearer-Header und oauth: false. Bitten Sie den Agenten, eine Fähigkeit mit ihrem vollen Namen zu verwenden.

Die Unity-Gateway-Fähigkeiten befinden sich in der Beta. Siehe Governance-Fähigkeiten für Aktivierung und Berechtigungen.

Problembehandlung

Eine Modellanfrage schlägt fehl: Überprüfen Sie die Gateway-URL, das Token-Ablaufdatum, den Modellnamen und die Berechtigungen.

Ein MCP-Server fehlt: Starte den Agenten neu. Wenn du es mit ugkonfiguriert hast, startet es mit ug opencode so, dass die gleichen Einstellungen verwendet werden. Überprüfen Sie für die manuelle Einrichtung ~/.config/opencode/opencode.json und den Bearer-Token.

Ein heruntergeladener Skill fehlt: Überprüfen Sie, ob sein vollständiger Ordner SKILL.md in einem unterstützten Verzeichnis enthält. Führen Sie ug skills add mit denselben Optionen erneut aus, um heruntergeladene Skills zu aktualisieren.

Bei Problemen bei der Anmeldung am Arbeitsbereich oder bei ug Einrichtungsproblemen führe ug doctor aus.

Nächste Schritte

  • Zuletzt aktualisiert um