Sambungkan OpenCode

Gunakan OpenCode dengan model, alat MCP, dan keterampilan melalui Unity Gateway. Unity Gateway CLI (ug) menangani proses masuk dan konfigurasi ruang kerja, atau Anda dapat mengonfigurasi koneksi secara manual.

Prerequisites

Anda membutuhkan URL workspace Azure Databricks Anda dan akses ke model, layanan MCP, dan keterampilan yang ingin Anda gunakan. Untuk pengaturan manual, instal OpenCode dan miliki token akses pribadi Azure Databricks.

Untuk konfigurasi manual, ganti <workspace-hostname> dengan hostname workspace Azure Databricks Anda dan <databricks-pat> dengan token Anda. Gunakan nama model lengkap yang tersedia di ruang kerja Anda, dan gabungkan entri konfigurasi ke dalam file yang ada, dengan tetap mempertahankan pengaturan yang tidak terkait.

Jika admin Anda sudah mengonfigurasi perangkat, ikuti instruksi pengaturan organisasi Anda.

Gunakan CLI Unity Gateway

Instal, uglalu jalankan perintah ini dari direktori proyek Anda:

ug opencode

Pilih ruang kerja Anda dan masuk saat diminta. Perintah ini membuka OpenCode dengan model gateway Anda yang telah dikonfigurasi. Mulai coding, atau masukkan /models untuk memilih model konfigurasi lain.

Konfigurasikan model secara manual

Instal OpenCode, lalu gabungkan konfigurasi ini ke dalam ~/.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
          }
        }
      }
    }
  }
}

Ganti nama model di kedua lokasi jika Anda memilih model Claude lain. Simpan toolStreaming: false untuk kompatibilitas gateway. Mulai OpenCode dengan opencode.

Untuk model Gemini, tambahkan penyedia terpisah menggunakan @ai-sdk/google, URL dasar https://<workspace-hostname>/ai-gateway/gemini/v1beta, kolom autentikasi yang sama, dan nama model Gemini Anda. Lihat dokumentasi penyedia OpenCode.

Untuk mengurangi biaya per token untuk tugas rutin, pilih model sumber terbuka seperti system.ai.glm-5-2 model Anda. Lihat Mengontrol pengeluaran.

Tambahkan alat MCP

Untuk menggunakan system.ai.dbsql, system.ai.sandbox, atau system.ai.web_search, admin akun harus mengaktifkan beta Unity Gateway dari halaman Pratinjau konsol akun. Lihat Kelola pratinjau akun.

Gunakan CLI Unity Gateway

Run:

ug mcp add --agents opencode

Pilih layanan Anda, lalu restart dengan ug opencode.

Konfigurasikan layanan MCP secara manual

Gabungkan entri ini ke dalam ~/.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>"
      }
    }
  }
}

Untuk layanan lain, ubah nama server dan ganti system.ai.dbsql dengan nama Unity Catalog tiga bagian. Mulai ulang OpenCode dan minta agar menggunakan alat yang terhubung. Lihat dokumentasi MCP OpenCode.

ug opencode menggunakan ~/.ucode/opencode-xdg/opencode/opencode.json. Gunakan file tersebut untuk entri MCP manual saat meluncurkan melalui ug.

Menambahkan keterampilan

Gunakan CLI Unity Gateway

Unduh keterampilan yang dipublikasikan:

ug skills add

Pilih keterampilan Anda, lalu restart OpenCode. Membaca unduhan dari ~/.agents/skills/ dan memuat skill yang relevan saat Anda bekerja.

Konfigurasikan keterampilan secara manual

Untuk berkas yang sudah Anda miliki, tempatkan setiap folder skill yang lengkap di ~/.agents/skills/ atau di .opencode/skills/ proyek Anda. Lihat dokumentasi keterampilan OpenCode.

Untuk mengakses registry keterampilan yang dipublikasikan melalui MCP, tambahkan server kedua menggunakan contoh MCP di atas, beri nama databricks-skill-registry, dan atur url ke https://<workspace-hostname>/ai-gateway/skills/. Pertahankan garis miring di akhir, header Bearer, dan oauth: false. Minta agen untuk menggunakan keterampilan dengan menyebutkan nama lengkap keterampilan tersebut.

Keterampilan Unity Gateway masih dalam tahap Beta. Lihat Mengatur keterampilan untuk pemberdayaan dan izin.

Troubleshooting

Permintaan model gagal: Periksa URL gateway, kedaluwarsa token, nama model, dan izin.

Server MCP tidak ditemukan: Mulai ulang agen. Jika Anda mengonfigurasinya dengan ug, jalankan dengan ug opencode agar menggunakan pengaturan yang sama. Untuk pengaturan manual, periksa ~/.config/opencode/opencode.json dan token pembawa.

Skill yang diunduh hilang: Periksa bahwa folder lengkapnya ada SKILL.md di direktori yang didukung. Jalankan kembali ug skills add dengan opsi yang sama untuk memperbarui skill yang diunduh.

Untuk masalah saat masuk ke ruang kerja atau penyiapan ug, jalankan ug doctor.

Langkah berikutnya

  • Terakhir diperbarui pada