Karmaşık bir kurulum olmadan kendi AI modelinizi kodlama için kullanmak mı istiyorsunuz? Droid, CLI'sinde harici API'leri destekleyerek iş akışınıza uygun özel bir model bağlamanızı kolaylaştırır. Bu rehberde API'yi nasıl kuracağınızı, yaygın sorunları nasıl çözeceğinizi ve Kimi'yi Droid'da nasıl kullanacağınızı göreceksiniz. Başlamak için okumaya devam edin.
Droid nedir?
Droid, geliştiricilerin kod yazmasına, hataları çözmesine ve geliştirme görevlerini daha verimli yürütmesine yardımcı olan bir AI kodlama aracıdır. Yerleşik AI modellerini destekler ve daha fazla esneklik için kullanıcıların CLI üzerinden özel modeller bağlamasına da olanak tanır. İster hızlı yardıma ister daha kişiselleştirilmiş bir kuruluma ihtiyacınız olsun, farklı kodlama iş akışları için kullanışlıdır.
Droid'da yerleşik AI modelleri nasıl kullanılır?
Yerleşik AI modelleri, önce herhangi bir harici API'ye bağlanmanız gerekmediği için Droid ile kodlamaya başlamayı kolaylaştırır. Uygulama yüklendikten sonra platform içinden bir model seçip kod analizi, özellik geliştirme, hata düzeltme ve inceleme için AI yardımını kullanmaya başlayabilirsiniz. Droid'a başlamak için şu adımları izleyin:
1. Adım: Droid'u yükleyin ve açın
Önce cihazınıza Factory App'i indirin ve yüklemeyi tamamlayın. Ardından uygulamayı açıp hesabınızda oturum açın. Böylece uygulama içindeki Droid'a ve yerleşik AI özelliklerine erişebilirsiniz.
2. Adım: Droid'u proje klasörünüze bağlayın
Çalışma dizininizi üzerinde çalışmak istediğiniz kod tabanına ayarlayın. Bu, Droid'u yerel projenize bağlayarak dosyaları okumasını, kod yapısını anlamasını ve geliştirme görevlerinize daha iyi bağlamla destek vermesini sağlar.
3. Adım: Yerleşik bir model seçin ve prompt girmeye başlayın
Model seçiciyi açın ve Droid'da bulunan yerleşik AI modellerinden birini seçin. Model seçildikten sonra kod tabanını analiz etmesini istemek, bir hatayı düzeltmek, kodu incelemek veya bir özellik geliştirmek gibi prompt'lar girmeye başlayabilirsiniz.
Droid harici bir API'ye nasıl bağlanır?
Droid'u harici bir API'ye bağlamak, yerleşik seçeneklerle sınırlı kalmak yerine tercih ettiğiniz modelle çalışma özgürlüğü sağlar. Kurulum, ayarlar dosyasına özel bir model eklenerek Droid CLI içinde yapılır; kaydedildiğinde model /model menüsünden kullanılabilir hâle gelir. Aşağıdaki adımlar, API anahtarından model seçimine kadar tüm kurulumun nasıl çalıştığını görebilmeniz için Kimi'yi basit bir örnek olarak kullanır:
1. Adım: Moonshot AI'den Kimi API anahtarı alın
Moonshot AI'den Kimi API anahtarınızı oluşturun veya kopyalayın. Droid, Kimi API'ye bağlanmak ve kendi hesabınız üzerinden istek göndermek için bu anahtarı kullanır. Anahtarı ayarlar dosyasında güvenli şekilde kullanabilmek için MOONSHOT_API_KEY gibi bir ortam değişkeni olarak kaydetmeniz önerilir.
2. Adım: Droid ayarlar dosyasını açın
Ardından, Droid CLI'da özel modellerin eklendiği ayarlar dosyasını açın. macOS'te dosya yolu ~/.factory/settings.json şeklindedir. Windows PowerShell'de %USERPROFILE%\.factory\settings.json kullanın. Bu, Droid'un özel model yapılandırmanızı okuduğu ana dosyadır.
3. Adım: Kimi'yi özel model olarak ekleyin
settings.json içinde Kimi'yi customModels dizisinin altına ekleyin. Bu, Droid'a hangi modeli kullanacağını, hangi API uç noktasını çağıracağını, hangi sağlayıcı biçimini izlediğini ve kimlik doğrulama için hangi API anahtarının kullanılacağını bildirir. Dosyada başka ayarlar zaten varsa her şeyi değiştirmeyin; yalnızca bu model nesnesini mevcut customModels dizisinin içine ekleyin.
4. Adım: Dosyayı kaydedin ve Droid'u yeniden başlatın
Yapılandırmayı ekledikten sonra dosyayı kaydedin ve Droid CLI'yi yeniden başlatın. Böylece Droid güncellenen ayarları yeniden yükler ve yeni eklenen özel modeli doğru şekilde tanır.
5. Adım: Droid içinde /model kullanarak Kimi modelini seçin
Droid CLI'yi açın ve /model komutunu çalıştırın. Kimi kurulumunuz artık Custom models bölümünde görünmelidir. Kodlama oturumunuzda Kimi'yi etkin model yapmak için listeden seçin.
6. Adım: Bir görev çalıştırın
Kimi'yi seçtikten sonra Droid'da gerçek işler için kullanmaya başlayabilirsiniz. Kod inceleme, hata düzeltme veya bir kod tabanını açıklama gibi bir prompt deneyin. Droid, isteği Kimi API aracılığıyla gönderir ve görev için bu modeli kullanır.
Kimi API kullanmanın avantajları
Kimi'yi Droid'a bağladıktan sonra, CLI içindeki harici bir modelden çok daha fazlası hâline gelir. Günlük geliştirme iş akışınıza uyum sağlayan, küçük kodlama işlerinde ve daha büyük mühendislik görevlerinde yardımcı olan pratik bir kodlama asistanına dönüşür. Kimi API kullanmanın bazı avantajları şunlardır:
Geliştirme verimliliğini artırın
Kimi; kod üreterek, mantığı açıklayarak ve çalışırken düzeltme önerileri sunarak günlük kodlama görevlerini daha hızlı tamamlamanıza yardımcı olabilir. Böylece basit geliştirme desteği için birden fazla araç arasında geçiş yapmanız gerekmez. Kimi Droid içinde olduğunda, rutin programlama işlerini yönetmek hızlanır.
Daha güvenilir kod yazın
Kimi, küçük hatalar daha büyük sorunlara dönüşmeden önce kodunuzu inceleyebilir, olası sorunları belirtebilir ve yapıyı iyileştirmenize yardımcı olabilir. Bu tür erken geri bildirimler, daha temiz mantık ve daha iyi sürdürülebilirlik istediğinizde faydalıdır. Zamanla test edilmesi, güncellenmesi ve anlaşılması daha kolay kodlar oluşturmanıza yardımcı olabilir.
Farklı geliştirme görevlerini yönetin
Kimi yalnızca sıfırdan kod yazmakla sınırlı değildir. Ayrıca yeniden düzenleme, kod belgeleme, tanımadığınız projeleri anlama ve farklı görevlerde özellik geliştirmeyi destekleme konularında da yardımcı olabilir. Bu, iş akışının birçok bölümünde yardımcı olması için tek bir AI modeli isteyen geliştiriciler açısından esnek bir seçenek olmasını sağlar.
API'lere bağlanırken sık karşılaşılan hataları giderme
Droid'da harici bir API anahtarı bağlamak genellikle kolaydır, ancak küçük kurulum hataları yine de sorunlara yol açabilir. Sorunların çoğu Droid'ın kendisinden ziyade ayarlar dosyası, sağlayıcı adı, API anahtarı veya model sunucusu yapılandırmasından kaynaklanır. Nerede bakmanız gerektiğini bildiğinizde bu hataları çözmek genellikle kolaydır.
Model seçicide görünmüyor
Eski biçimi kullanıyorsanız
~/.factory/settings.jsonveyaconfig.jsoniçindeki JSON söz dizimini kontrol edinAyar değişiklikleri, dosya izleme yoluyla otomatik olarak algılanır
Özel model yapılandırmasında gerekli tüm alanların bulunduğunu doğrulayın
"Geçersiz sağlayıcı" hatası
Sağlayıcı değerinin tam olarak
anthropic,openaiveyageneric-chat-completion-apiolduğundan emin olunSağlayıcı alanında yazım hatası ve yanlış büyük/küçük harf kullanımı olup olmadığını kontrol edin
Kimlik doğrulama hataları
API anahtarınızın geçerli olduğunu ve kullanılabilir krediniz bulunduğunu doğrulayın
API anahtarının sağlayıcı için doğru izinlere sahip olduğunu kontrol edin
Temel URL'nin, sağlayıcının belgelerindeki API uç noktasıyla eşleştiğini doğrulayın
Yerel model bağlanmıyor
ollama servegibi yerel model sunucunuzun çalıştığından emin olunTemel URL'nin doğru olduğunu ve sağlayıcı gerektiriyorsa
/v1/içerdiğini doğrulayınModelin önceden indirildiğini veya yerel olarak kullanılabilir olduğunu kontrol edin
Hız sınırlaması veya kota hataları
Sağlayıcınızın API hız sınırlarını ve kullanım kotalarını kontrol edin
Sınırlara ulaşılıp ulaşılmadığını görmek için sağlayıcı kontrol panelinden kullanımınızı izleyin
Sonuç
Droid'da özel API'ler kullanmak, AI ile kod oluşturma, test etme ve iyileştirme süreçleri üzerinde daha fazla kontrol sağlar. Kurulum tamamlandığında, kodlama iş akışınızı ihtiyaçlarınıza uygun model etrafında şekillendirmek kolaylaşır. İster yerleşik seçeneklerle devam edin ister harici bir model bağlayın, Droid AI'ı geliştirme sürecine dahil etmek için esnek bir yol sunar. Özel bir kurulumla başlamak için basit bir seçenek arıyorsanız Kimi'yi Droid'da denemeye değer. Günlük kodlama işlerini daha akıcı ve hızlı hâle getirmek için pratik bir tercih olabilir.