GitHub Copilot SDK ile C#'ta Kendi Modelinizi (BYOK) Kullanın
GitHub Copilot SDK'da BYOK (kendi model sağlayıcınızı getirme) özelliğiyle Copilot agent runtime'ını korurken model isteklerini kendi Microsoft Foundry veya Azure OpenAI dağıtımınıza yönlendirebilirsiniz. Makale, .NET 10 konsol uygulamasıyla ProviderConfig kurulumunu ve Entra ID ile API anahtarı kimlik doğrulamasını adım adım gösteriyor.
Kilit noktalar
- ProviderConfig ile Type = "openai", WireApi = "responses" ayarlanır; dağıtımın Responses API'yi desteklemesi gerekir.
- AzureOpenAI:Endpoint değeri HTTPS olmalı; yardımcı metot /openai/v1/ yolunu otomatik ekler.
- Varsayılan kimlik doğrulama AzureCliCredential ile yapılır; BearerTokenProvider callback'i token'ı istek anında alır.
- Kimlik doğrulama için identity'ye resource üzerinde Cognitive Services OpenAI User rolü verilmelidir.
- API anahtarı kullanılacaksa User Secrets ile AzureOpenAI:ApiKey tanımlanır ve api-key başlığı gönderilir.
- Reasoning modellerde MaxOutputTokens, akıl yürütme token'larını da içerir; limit düşükse yanıt boş kalabilir.
GitHub Copilot SDK, uygulamanıza Copilot agent runtime'ını sağlıyor; BYOK ise model çıkarımının (inference) gideceği sağlayıcıyı sizin kontrol ettiğiniz bir endpoint'e çevirmenize izin veriyor. Bu yazıda Microsoft Foundry üzerindeki bir dağıtım hedef alınıyor ve örnek, sağlayıcı yapılandırmasını, kimlik doğrulamayı ve tek bir sorunun gönderilmesini kapsayan küçük bir .NET 10 konsol uygulaması olarak sunuluyor.
Örnekte ProviderConfig ile Responses API kullanılıyor, endpoint HTTPS doğrulamasından geçiriliyor ve varsayılan olarak Azure CLI oturumu üzerinden Entra ID token'ı alınıyor. Bir API anahtarı tanımlıysa istek api-key başlığıyla gönderiliyor. Oturum bilerek sade tutulmuş; araçlar, skill'ler ve Git işlemleri kapalı. Reasoning modellerde MaxOutputTokens değerinin düşük tutulmasının yanıtı tamamen kesebileceği de belirtiliyor.
Gerçek dünyada kullanımı
- Kurumsal bir ekibin Azure'daki kendi Foundry dağıtımını kullanarak Copilot SDK tabanlı bir agent'ı çalıştırması.
- Yerel Ollama veya vLLM gibi OpenAI uyumlu bir endpoint'i Copilot runtime'ına bağlayarak model sağlayıcısını değiştirmek isteyen bir geliştirici aracı.
- Anahtar yönetimi istemeyen, Entra ID ile çalışan dahili bir konsol veya otomasyon aracı.
Neden önemli
Copilot SDK'nın agent altyapısını kullanırken model çağrılarını kendi kurumsal sağlayıcınıza yönlendirebilirsiniz. Entra ID ile kimlik doğrulama, anahtar yönetimi yükünü azaltır.