Connect OpenCode

Používejte OpenCode s modely, nástroji MCP a dovednostmi prostřednictvím Unity Gateway. CLI Unity Gateway (ug) zajišťuje přihlášení a konfiguraci v pracovním prostoru, nebo můžete připojení nastavit ručně.

Než začnete

Potřebujete URL pracovního prostoru Azure Databricks a přístup k modelům, MCP službám a dovednostem, které chcete používat. Pro ruční nastavení nainstalujte OpenCode a mějte osobní přístupový token Azure Databricks.

Pro ruční konfiguraci nahraďte <workspace-hostname> hostitelským názvem vašeho pracovního prostoru Azure Databricks a <databricks-pat> tokenem. Používejte kompletní názvy modelů dostupné ve vašem pracovním prostoru a slučujte konfigurační položky do existujících souborů, přičemž nesouvisející nastavení zůstávají nesouvisející.

Pokud už váš administrátor vaše zařízení nakonfiguroval, postupujte podle pokynů vaší organizace.

Použijte Unity Gateway CLI

Instalujte , poté spusťte ugtento příkaz z adresáře vašeho projektu:

ug opencode

Vyberte si svůj pracovní prostor a přihlaste se, když vás k tomu vyzvou. Příkaz otevře OpenCode s nakonfigurovanými modely brán. Začněte programovat nebo zadejte /models pro výběr jiného konfigurovaného modelu.

Modely konfigurujte ručně

Nainstalujte OpenCode a poté tuto konfiguraci sloučete do:~/.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
          }
        }
      }
    }
  }
}

Pokud zvolíte jiný model Clauda, nahraďte název modelu na obou místech. Zachovejte toolStreaming: false kvůli kompatibilitě s gateway. Spusť OpenCode s opencode.

U modelů Gemini přidejte samostatného poskytovatele pomocí @ai-sdk/google, základní URL https://<workspace-hostname>/ai-gateway/gemini/v1beta, stejných autentizačních polí a názvů modelů Gemini. Viz dokumentaci poskytovatele OpenCode.

Pro snížení nákladů za token u rutinních úloh zvolte jako svůj model open-source model, například system.ai.glm-5-2. Viz Kontrola výdajů.

Přidat nástroje MCP

Použijte Unity Gateway CLI

Běh:

ug mcp add --agents opencode

Vyberte své služby a pak restartujte pomocí ug opencode.

Ručně konfigurujte MCP služby

Sločte tento záznam do :~/.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>"
      }
    }
  }
}

Pro jinou službu změňte název serveru a nahraďte system.ai.dbsql ho jeho třídílným názvem Unity Catalog. Restartujte OpenCode a požádejte ho, aby použil připojený nástroj. Viz dokumentaci OpenCode MCP.

ug opencode používá ~/.ucode/opencode-xdg/opencode/opencode.json. Použijte tento soubor pro ruční zápisy MCP při spuštění přes ug.

Přidání dovedností

Použijte Unity Gateway CLI

Stáhněte si publikované dovednosti:

ug skills add

Vyberte si své dovednosti a pak restartujte OpenCode. Čte stažené soubory z ~/.agents/skills/ a při práci načítá příslušné dovednosti.

Manuální nastavení dovedností

U souborů, které už máte, umístěte každou úplnou složku dovednosti do ~/.agents/skills/ nebo do složky .opencode/skills/ vašeho projektu. Viz dokumentaci dovedností OpenCode.

Pro přístup k publikovanému registru dovedností přes MCP přidejte druhý server pomocí výše uvedeného příkladu MCP, pojmenujte ho databricks-skill-registrya nastavte url na https://<workspace-hostname>/ai-gateway/skills/. Zachovejte koncové lomítko, hlavičku Bearer a oauth: false. Požádejte agenta, aby použil dovednost pod jejím plným názvem.

Dovednosti Unity Gateway jsou v beta verzi. Viz Govern skills pro zpřístupnění a oprávnění.

Troubleshooting

Požadavek na model selže: Zkontrolujte URL brány, expiraci tokenu, název modelu a oprávnění.

Chybí MCP server: Restartujte agenta. Pokud jste to nastavili s ug, spusťte to tak, ug opencode aby používalo stejná nastavení. Pro ruční nastavení zkontrolujte ~/.config/opencode/opencode.json a token typu Bearer.

Stažená dovednost chybí: Zkontrolujte, zda se její kompletní složka nachází v podporovaném adresáři a obsahuje SKILL.md. Znovu spouštějte ug skills add se stejnými možnostmi pro obnovení stažených dovedností.

Pro problémy s přihlášením nebo nastavením ug v pracovním prostoru použijte ug doctor.

Další kroky

  • Last updated on