Last chance! 50% off DataCamp Premium
Sale ends in
Codestral, fill-in-the-middle (FIM) ve kod tamamlama dahil kod üretim görevleri için optimize edilmiş, son teknoloji bir üretken modeldir. 80’den fazla programlama dilinde eğitilen Codestral, yaygın ve daha az kullanılan dillerde de başarılıdır; bu da onu geliştiriciler için çok yönlü bir araç haline getirir.
Codestral API’yi kullanarak kod üretimini otomatikleştirip iş akışlarımıza entegre edebiliriz. Bu eğitimde, Codestral API’nin adım adım kullanımını anlatacağız.
Codestral’a genel bir bakış isterseniz, Mistral’ın Codestral’ı nedir başlıklı makaleme göz atın.
Codestral API Uç Noktaları
Codestral, farklı kullanıcı ihtiyaçlarına yanıt veren iki ana API uç noktası sunar:
- codestral.mistral.ai: Bireysel kullanıcılar ve küçük ölçekli entegrasyonlar için idealdir. Bu uç nokta 1 Ağustos 2024’e kadar ücretsizdir; sonrasında aylık abonelik hizmetine dönüşecektir.
- api.mistral.ai: İşletmeler ve yüksek talep gerektiren kullanım senaryoları için tasarlanmıştır; daha yüksek hız limitleri ve büyük ölçekli uygulamalar için güçlü destek sunar.
Mistral, Codestral’ı bir IDE eklentisinin parçası olarak kullanmayı planlıyorsanız veya kullanıcıların kendi API anahtarlarını kullanmalarına olanak tanıyan ve uç noktaları doğrudan kullanıcılara açan araçlar geliştirecekseniz codestral.mistral.ai uç noktasını önerir.
Diğer tüm kullanım durumları için ise, daha yüksek hız limitleri ve iş uygulamalarına uygunluğu nedeniyle api.mistral.ai uç noktası önerilir.
Bu eğitimde Codestral’ın yeteneklerini göstermek için codestral.mistral.ai uç noktasını kullanacağız.
Codestral API ile Başlarken
API Anahtarı Alma
Codestral API’yi kullanmak için bir Mistral AI hesabı oluşturmanız ve bir API anahtarı edinmeniz gerekir. Şu adımları izleyin:
Adım 1: Kayıt olun
Mistral AI’ın kayıt sayfasını ziyaret edin ve bir hesap oluşturun.
Adım 2: API anahtarı alın
api.mistral.ai için, API Keys sekmesine gidip Create new key butonuna tıklayarak API anahtarınızı oluşturun.
codestral.mistral.ai için: API Keys sekmesinin altında “New” rozeti bulunan Codestral sekmesine gidin ve sayfadaki talimatları izleyerek API anahtarınızı edinin. Şu anda bir bekleme listesi bulunduğunu ve kayıt için bir telefon numarası vermeniz gerektiğini unutmayın. Onaylandıktan sonra, aşağıda gösterildiği gibi aynı sayfada API anahtarınıza ve codestral.mistral.ai’ye özgü iki uç noktaya erişebileceksiniz:
Bu makale, Codestral’ı göstermek için codestral.mistral.ai uç noktalarını kullanır; bu nedenle verilen tüm örnekler buna göre uyarlanmıştır.
Kimlik Doğrulama
API isteklerimizi doğrulamak için requests kütüphanesini kullanarak iki Python fonksiyonu oluşturacağız. Bu fonksiyonlar, elde edilen API anahtarını kimlik doğrulama için istek başlıklarına ekleyerek Codestral’ın iki API uç noktasıyla iletişimi yönetecek. İşte iki fonksiyon:
call_chat_endpoint— Sohbet Uç Noktasıhttps://codestral.mistral.ai/v1/chat/completionsçağrısı için.call_fim_endpoint— Tamamlama Uç Noktasıhttps://codestral.mistral.ai/v1/fim/completionsçağrısı için.
Bunu Python’da şu şekilde yapabilirsiniz:
import requests
import json
api_key = 'INSERT YOUR API KEY HERE'
def call_chat_endpoint(data, api_key=api_key):
url = "<https://codestral.mistral.ai/v1/chat/completions>"
headers = {
"Authorization": f"Bearer {api_key}",
"Content-Type": "application/json",
"Accept": "application/json"
}
response = requests.post(url, headers=headers, data=json.dumps(data))
if response.status_code == 200:
return response.json()
else:
return f"Error: {response.status_code}, {response.text}"
def call_fim_endpoint(data, api_key=api_key):
url = "<https://codestral.mistral.ai/v1/fim/completions>"
headers = {
"Authorization": f"Bearer {api_key}",
"Content-Type": "application/json",
"Accept": "application/json"
}
response = requests.post(url, headers=headers, data=json.dumps(data))
if response.status_code == 200:
return response.json()
else:
return f"Error: {response.status_code}, {response.text}"Codestral’ın API Uç Noktalarını Anlamak
API anahtarımızı aldığımıza ve kimlik doğrulama fonksiyonlarını kurduğumuza göre, kod üretimi için Codestral’ın iki API uç noktasını nasıl kullanacağımıza bakalım. Fill-in-the-middle (FIM) uç noktasıyla başlayacağız.
Fill-in-the-middle uç noktası
Fill-in-the-middle uç noktası, verilen bir başlangıç noktası (istem) ve isteğe bağlı bir bitiş noktası (sonek) arasına uyacak kod üretmek için tasarlanmıştır. Bu, daha büyük bir kod yapısının içine belirli bir kod parçasının üretilmesi gereken görevler için özellikle kullanışlıdır.
API Uç Noktası URL’si: https://codestral.mistral.ai/v1/fim/completions
Parametreler:
prompt: Kodun başlangıç noktası.suffix(isteğe bağlı): Kodun bitiş noktası.stop(isteğe bağlı): Üretimi durduracak bir belirteç dizisi.
Örnek:
prompt = "def fibonacci(n: int):"
suffix = "n = int(input('Enter a number: '))\\nprint(fibonacci(n))"
data = {
"model": "codestral-latest",
"prompt": prompt,
"suffix": suffix,
"temperature": 0
}
response = call_fim_endpoint(data)
Instruct uç noktası
Instruct uç noktası, kod üretimi için modele talimatlar sağlar. Daha açık uçlu kod üretim görevleri için kullanışlıdır.
API Uç Noktası URL’si: https://codestral.mistral.ai/v1/chat/completions
Parametreler:
prompt: Kod üretim görevi için talimat.temperature(isteğe bağlı): Üretilen kodun rastgeleliğini kontrol eder.max_tokens(isteğe bağlı): Üretilen kodun uzunluğunu sınırlar.
Örnek:
prompt = "Please write me a function that adds up two numbers"
data = {
"model": "codestral-latest",
"messages": [
{
"role": "user",
"content": prompt
}
],
"temperature": 0
}
response = call_chat_instruct_endpoint(data)
Gelişmiş API Kullanımı
Hız limitleri
Her uç noktanın farklı hız limitleri vardır:
- codestral.mistral.ai: Dakikada 30 istek ve günde 2000 istek.
- api.mistral.ai: Çalışma alanı başına saniyede 200 istek.
Kesintisiz çalışma ve kullanım kısıtlarını aşmamak için hız limitlerini yönetmek kritik önemdedir. Etkili bir strateji, belirli bir gecikmeden sonra isteği duraklatıp yeniden gönderen bir yeniden deneme mantığı uygulamaktır — bu gecikmeyi eklemek için Python’ın time kütüphanesini kullanabiliriz.
Alternatif olarak, izin verilen sınırlar içinde kaldığınızdan emin olmak için API kullanımınızı takip edebilirsiniz. Yapılan istek sayısını kaydedip hız limitleriyle karşılaştırabilirsiniz.
Hata yönetimi
Yaygın hata kodları şunlardır:
- 401 Unauthorized: Geçersiz API anahtarı veya eksik kimlik doğrulama.
- 429 Too Many Requests: Hız limiti aşıldı.
- 500 Internal Server Error: Mistral AI tarafındaki sunucu sorunları.
401 Unauthorized hatası için, API anahtarını kontrol edin ve istek başlıklarına doğru şekilde eklendiğinden emin olun.
429 Too Many Requests hatası için, bir gecikme sonrası bekleyip isteği yeniden deneyecek bir yeniden deneme mantığı uygulamayı deneyin.
500 Internal Server Error hatalarını yönetmek için de yeniden deneme mantığı faydalıdır; isteği daha sonra tekrar deneyin.
Çıktıyı özelleştirme
Çıktı biçimini ve stilini kontrol etmek için, istemi (daha spesifik veya genel hale getirerek) ve sıcaklığı (modelin yaratıcılığını kontrol ederek) gibi parametreleri ayarlayabilirsiniz.
Üretilen kodda yaratıcılık ve öngörülebilirlik arasındaki dengeyi ince ayar yapmak için bu parametrelerle deney yapın.
Codestral API Entegrasyonu
Codestral yalnızca bağımsız bir API olarak çalışmaz — mevcut geliştirme iş akışlarımıza da entegre edebiliriz. Bunu yapmanın iki temel yolunu inceleyelim: IDE ve metin düzenleyici entegrasyonları ile özel betikler oluşturmak.
IDE’ler ve metin düzenleyiciler
Codestral, eklenti veya uzantılar aracılığıyla popüler IDE ve metin düzenleyicilerle sorunsuz biçimde entegre olur. Örneğin, VS Code veya JetBrains için Continue.dev ile Codestral’ı kurabilirsiniz:
- VS Code veya JetBrains için Continue uzantısını kurun.
- Sağlayıcı olarak Mistral API’yi seçin ve model olarak Codestral’ı tercih edin.
- Codestral API anahtarını almak için Get API Key’e tıklayın.
- Add model’e tıklayın; bu işlem config.json dosyasını otomatik olarak dolduracaktır.
Özel betikler
Codestral API’den yararlanan özel betikler veya uygulamalar geliştirebilirsiniz. İşte test fonksiyonları üreten basit bir betik örneği:
prompt="""Sure, here is a simple function in Python that adds up two numbers:
def add_two_numbers(num1, num2):
return num1 + num2
You can use this function like this:
result = add_two_numbers(5, 3)
print(result) # Outputs: 8
This function takes two arguments, num1 and num2, and returns their sum.\ndef test_add_two_numbers():"""
suffix=""
data = { "model": "codestral-latest", "prompt": prompt, "suffix": suffix, "temperature": 0 }
response = call_fim_endpoint(data)
Codestral API’yi Kullanma İçin En İyi Uygulamalar
Codestral’dan en iyi şekilde yararlanmak için, API’yi etkili ve sorumlu şekilde kullanmaya yönelik bazı en iyi uygulamaları inceleyelim.
Açık ve özlü istemler
Codestral API’yi kullanırken netlik esastır. İstediğiniz kod çıktısını elde etmek için istemlerinizin veya talimatlarınızın iyi tanımlanmış ve yoruma yer bırakmayacak şekilde açık olmasını sağlayın. Spesifik ve bağlamsal istemler vererek modeli beklentilerinize uygun kod üretmeye yönlendirebilirsiniz.
Yinelemeli iyileştirme
Codestral API ile etkileşimlerinizi optimize etmek, yinelemeli bir iyileştirme sürecini içerir. İstediğiniz sonuçlara ulaşmak için farklı parametreler, istemler ve girdilerle deney yapın. Üretilen kod çıktısını analiz edin ve istemlerinizi ayarlamak için bu çıktılardan yararlanın. Yaklaşımınızı sürekli rafine ederek, zaman içinde üretilen kodun kalitesini ve ilgililiğini artırabilirsiniz.
Sorumlu kullanım
Codestral API’nin sorumlu kullanımı önemlidir. API kullanımınızın etik ve yasal standartlara uygun olduğundan emin olun. Kötü amaçlı veya zararlı olabilecek kod üretmekten kaçının. Güvenli ve etik programlama için en iyi uygulamalara uyun ve başkalarının gizliliğine ve haklarına saygı gösterin. API’yi sorumlu şekilde kullanmak, olumlu ve sürdürülebilir bir geliştirme ortamına katkıda bulunur.
Sonuç
Bu eğitim, kod üretimi için Codestral API’nin kullanımına yönelik pratik bir rehber sundu. Farklı uç noktaları, en iyi uygulamaları ve entegrasyon seçeneklerini inceledik.
API ile deneyler yapmanızı ve kendi geliştirme iş akışınızı nasıl güçlendirebileceğini keşfetmenizi öneririm.
Mistral hakkında daha fazla bilgi için şu Mistral 7B eğitimi ve şu Mistral large model ile çalışma rehberine göz atın.
Konular
