Connect OpenCode

Korzystaj z OpenCode z modelami, narzędziami MCP i umiejętnościami poprzez Unity Gateway. Unity Gateway CLI (ug) obsługuje logowanie i konfigurację w przestrzeni roboczej, albo można konfigurować połączenie ręcznie.

Prerequisites

Potrzebujesz adresu URL swojego workspace Azure Databricks oraz dostępu do modeli, usług MCP i umiejętności, które chcesz używać. Do ręcznej konfiguracji zainstaluj OpenCode i miej osobisty token dostępu Azure Databricks.

W przypadku konfiguracji ręcznej zamień <workspace-hostname> na nazwę hosta obszaru roboczego Azure Databricks, a <databricks-pat> na swój token. Używaj pełnych nazw modeli dostępnych w twojej przestrzeni roboczej i łącz wpisy konfiguracyjne z istniejącymi plikami, zachowując niepowiązane ustawienia.

Jeśli administrator już skonfigurował urządzenie, postępuj zgodnie z instrukcjami konfiguracyjnymi organizacji.

Użyj narzędzia Unity Gateway CLI

Instaluj ug, a następnie uruchom to polecenie z katalogu projektu:

ug opencode

Wybierz swoją przestrzeń roboczą i zaloguj się, gdy pojawi się poproszenie o to. Polecenie otwiera OpenCode z skonfigurowanymi modelami bram. Rozpocznij kodowanie lub wejdź, /models aby wybrać inny skonfigurowany model.

Konfiguruj modele ręcznie

Zainstaluj OpenCode, a następnie połącz tę konfigurację z :~/.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
          }
        }
      }
    }
  }
}

Zamień nazwę modelu w obu lokalizacjach, jeśli wybierzesz inny model Claude'a. Zachowaj toolStreaming: false dla zgodności z bramą. Zacznij OpenCode od opencode.

W przypadku modeli Gemini dodaj osobnego dostawcę, używając @ai-sdk/google, bazowego URL https://<workspace-hostname>/ai-gateway/gemini/v1beta, tych samych pól uwierzytelniania oraz nazw modeli Gemini. Zobacz dokumentację dostawców OpenCode.

Aby obniżyć koszt pojedynczego tokena w przypadku rutynowych zadań, wybierz jako swój model model o otwartym kodzie źródłowym, taki jak system.ai.glm-5-2. Zobacz Kontrola wydatków.

Dodaj narzędzia MCP

Aby używać system.ai.dbsql, system.ai.sandbox lub system.ai.web_search, administrator konta musi włączyć wersję beta Unity Gateway na stronie Previews w konsoli konta. Zobacz Podglądy konta.

Użyj narzędzia Unity Gateway CLI

Run:

ug mcp add --agents opencode

Wybierz swoje usługi, a następnie zrestartuj za pomocą ug opencode.

Konfiguruj usługi MCP ręcznie

Połącz ten wpis z :~/.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>"
      }
    }
  }
}

W przypadku innej usługi zmień nazwę serwera i zamień system.ai.dbsql ją trzyczęściową nazwą Unity Catalog. Zrestartuj OpenCode i poproś go o użycie podłączonego narzędzia. Zobacz dokumentację MCP OpenCode.

ug opencode używa metody ~/.ucode/opencode-xdg/opencode/opencode.json. Użyj tego pliku do ręcznych wpisów MCP podczas uruchamiania przez ug.

Dodawanie umiejętności

Użyj narzędzia Unity Gateway CLI

Pobierz opublikowane umiejętności:

ug skills add

Wybierz swoje umiejętności, a potem zrestartuj OpenCode. Odczytuje pobrane dane z ~/.agents/skills/ i ładuje odpowiednie umiejętności podczas pracy.

Konfiguruj umiejętności ręcznie

Jeśli masz już pliki, umieść każdy kompletny folder umiejętności w ~/.agents/skills/ lub w .opencode/skills/ swojego projektu. Zobacz dokumentację umiejętności OpenCode.

Aby uzyskać dostęp do opublikowanego rejestru umiejętności przez MCP, dodaj drugi serwer korzystając z powyższego przykładu MCP, nazwij go databricks-skill-registry, i ustaw url na https://<workspace-hostname>/ai-gateway/skills/. Zachowaj końcowy ukośnik, nagłówek Bearer i oauth: false. Poproś agenta o użycie umiejętności, podając jej pełną nazwę.

Umiejętności Unity Gateway są w fazie beta. Zobacz Zarządzanie umiejętnościami dla umożliwień i uprawnień.

Troubleshooting

Żądanie do modelu kończy się niepowodzeniem: Sprawdź adres URL bramy, czy token nie wygasł, nazwę modelu oraz uprawnienia.

Brakuje serwera MCP: Zrestartuj agenta. Jeśli skonfigurowałeś go za pomocą ug, uruchom go za pomocą ug opencode, aby używał tych samych ustawień. Przy ręcznej konfiguracji sprawdź ~/.config/opencode/opencode.json i żeton nosiciela.

Brakuje pobranego skilla: Sprawdź, czy jego pełny folder zawiera SKILL.md i znajduje się w obsługiwanym katalogu. Uruchom ponownie ug skills add z tymi samymi opcjami, aby odświeżyć pobrane umiejętności.

W przypadku problemów z logowaniem do obszaru roboczego ug lub z konfiguracją uruchom ug doctor.

Następne kroki

  • Ostatnia aktualizacja o