OpenCode'a bağlan

OpenCode'u modeller, MCP araçları ve Unity Gateway üzerinden becerilerle kullanın. Unity Gateway CLI'si (ug) çalışma alanı giriş ve yapılandırmayı yönetir veya bağlantıyı manuel olarak yapılandırabilirsiniz.

Başlamadan önce

Azure Databricks çalışma alanı URL'nize ve kullanmak istediğiniz modellere, MCP hizmetlerine ve becerilere erişiminiz olmalıdır. Manuel kurulum için OpenCode kurun ve Azure Databricks kişisel erişim tokenı kullanın.

El ile yapılandırma için, <workspace-hostname> öğesini Azure Databricks çalışma alanı ana bilgisayar adınızla ve <databricks-pat> öğesini belirtecinizle değiştirin. Çalışma alanınızda mevcut tam model adlarını kullanın ve yapılandırma girişlerini mevcut dosyalarla birleştirin, alakasız ayarları koruyun.

Yöneticiniz cihazınızı zaten yapılandırdıysa, kuruluşunuzun kurulum talimatlarını takip edin.

Unity Gateway CLI'sini kullanın

Install ug, sonra proje dizininizden şu komutu çalıştırın:

ug opencode

İş alanınızı seçin ve istendiğinde giriş yapın. Komut, gateway modelleriniz ayarlanmış şekilde OpenCode'u açar. Kodlamaya başlayın veya başka bir yapılandırılmış model seçmek için Enter /models yapın.

Modelleri manuel olarak yapılandırmak

OpenCode'u yükleyin, ardından bu yapılandırmayı ~/.config/opencode/opencode.json ile birleştirin:

{
  "$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
          }
        }
      }
    }
  }
}

Başka bir Claude modeli seçerseniz, her iki konumda da model adını değiştirin. Ağ geçidi uyumluluğu için toolStreaming: false öğesini koruyun. OpenCode'u opencode ile başlatın.

Gemini modelleri için, https://<workspace-hostname>/ai-gateway/gemini/v1beta kullanarak, temel URL olarak @ai-sdk/google, aynı kimlik doğrulama alanlarını ve Gemini model adlarınızı kullanıp ayrı bir sağlayıcı ekleyin. OpenCode'un sağlayıcı dokümantasyonuna bakınız.

Rutin görevler için token başına maliyeti azaltmak için, modeliniz gibi bir açık kaynak modeli system.ai.glm-5-2 seçin. Bkz. Harcamaları kontrol etmek.

MCP araçları ekleyin

Unity Gateway CLI'sini kullanın

Koş!

ug mcp add --agents opencode

Hizmetlerinizi seçin, ardından ug opencode ile yeniden başlatın.

MCP hizmetlerini manuel olarak yapılandırma

Bu girdiyi ~/.config/opencode/opencode.json ile birleştirin:

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

Başka bir hizmet için sunucu adını değiştirin ve system.ai.dbsql öğesini kendi üç parçalı Unity Kataloğu adıyla değiştirin. OpenCode'u yeniden başlatın ve bağlı bir araç kullanmasını iste. OpenCode'un MCP dokümantasyonuna bakınız.

ug opencode kullanır ~/.ucode/opencode-xdg/opencode/opencode.json. ug üzerinden başlatırken MCP’yi manuel olarak girmek için bu dosyayı kullanın.

Beceri ekleme

Unity Gateway CLI'sini kullanın

Yayınlanmış becerileri indirin:

ug skills add

Yeteneklerinizi seçin, sonra OpenCode'u yeniden başlatın. Çalışmalarınız sırasında indirilen ~/.agents/skills/ bilgileri okuyor ve ilgili becerileri yüklüyor.

Becerileri manuel olarak yapılandırma

Zaten sahip olduğunuz dosyalar için her eksiksiz beceri klasörünü ~/.agents/skills/ içine veya projenizin .opencode/skills/ içine yerleştirin. OpenCode'un beceri dokümantasyonuna bakınız.

MCP üzerinden yayımlanmış yetenek kaydına erişmek için yukarıdaki MCP örneğini kullanarak ikinci bir sunucu ekleyin, adını databricks-skill-registry olarak belirleyin ve url değerini https://<workspace-hostname>/ai-gateway/skills/ olarak ayarlayın. Sondaki eğik çizgiyi, Bearer üstbilgisini ve oauth: false koruyun. Temsilciden bir yeteneği tam adıyla kullanmasını iste.

Unity Gateway yetenekleri Beta'da. Etkinleştirme ve izinler için Yönetim becerileri bölümünü inceleyebilirsiniz.

Troubleshooting

Bir model talebi başarısız olur: Gateway URL'sini, token süresi dolduğunu, model adını ve izinleri kontrol edin.

Bir MCP sunucusu eksik: Ajanı yeniden başlatın. Eğer bunu ug ile yapılandırdıysanız, aynı ayarları kullanması için ug opencode ile başlatın. Manuel kurulum için ~/.config/opencode/opencode.json ve bearer belirtecini kontrol edin.

İndirilen bir beceri eksik: Tam klasörünün, desteklenen bir dizinde SKILL.md içerdiğini doğrulayın. İndirilmiş becerileri yenilemek için aynı seçeneklerle tekrar çalıştır ug skills add .

Çalışma alanı giriş veya ug kurulum sorunları için çalıştırın ug doctor.

Sonraki Adımlar

  • Last updated on