AI Model Konfigürasyonu

mindzieStudio artık çok daha gelişmiş büyük dil modeli (LLM) entegrasyonu sunarak, AI yardımcılarınızı ve asistanlarınızı güçlendirmek için esnek seçenekler sağlar. mindzie'nin yerleşik proxy modellerini kullanabilir, kendi API anahtarlarınızla popüler bulut sağlayıcılarına bağlanabilir veya tam kontrol için kurum içi modelleri dağıtabilirsiniz.

Genel Bakış

AI model konfigürasyon sistemi size şunları sağlar:

• mindzie Proxy Modellerini Kullanma: mindzieStudio'nun sunduğu hızlı ve düşünme modellerine kutudan erişim
• Kendi Modellerinizi Getirme: Kendi kimlik bilgilerinizi kullanarak OpenAI uyumlu herhangi bir API'ye bağlanma
• Bulut Sağlayıcıları: OpenAI, OpenRouter, Grok, Gemini ve diğer büyük AI sağlayıcılarını kullanma
• Kurum İçi Dağıtım: LM Studio, Ollama veya benzeri platformlarla yerel modelleri dağıtma
• Otomatik Algılama: mindzieStudio'nun model yeteneklerini, token limitlerini ve özelliklerini otomatik algılamasına izin verme
• Birden Fazla Model: Farklı kullanım senaryoları için ihtiyacınız kadar model konfigüre etme

AI Model Konfigürasyonunu Ne Zaman Kullanmalı

AI modellerini şu durumlarda konfigüre edin:

• İlk kez copilot asistanları kurmak istediğinizde
• Maliyet veya performansa göre farklı AI sağlayıcıları arasında geçiş yapmak istediğinizde
• Veri gizliliği ve güvenlik için kurum içi modeller dağıtmak istediğinizde
• Belirli görevler için özel modeller kullanmak istediğinizde (hızlı yanıtlar için hızlı modeller, karmaşık analizler için düşünme modelleri)
• Güvenlik uyumluluğu için API anahtarlarını döndürmek istediğinizde
• Yeni modelleri varsayılan yapmadan önce test etmek istediğinizde

Ön Koşullar

AI modellerini konfigüre etmeden önce:

• Yönetici Erişimi: mindzieStudio ayarlarında yönetici erişiminiz olmalıdır
• API Anahtarları: Seçtiğiniz sağlayıcıdan (OpenAI, OpenRouter vb.) API anahtarları alın
• Sağlayıcı Hesabı: Dış hizmetleri kullanıyorsanız AI sağlayıcınızda hesap oluşturun
• Kurum İçi Kurulum: Yerel modeller kullanıyorsanız LM Studio, Ollama veya eşdeğer yazılımı kurup yapılandırın

Copilot Ayarlarına Erişim

Yönetim panelinden copilot ayarlarına gidin.

1. Sağ üst köşedeki profil simgenize tıklayın
2. Açılır menüden Ayarlar seçeneğini seçin
3. Sol kenar çubuğunda Copilot seçeneğine tıklayın

mindzie Copilot Ayarları sayfası iki ana bölüme sahiptir:

• LLM Sağlayıcıları: AI hizmet sağlayıcılarınızı yönetin
• LLM Modelleri: Sağlayıcılarınızdan belirli modelleri konfigüre edin

Bir AI Sağlayıcısı Ekleme

Sağlayıcılar modelleri barındıran AI hizmetleridir. Birden fazla sağlayıcı ekleyebilir ve aralarında geçiş yapabilirsiniz.

Adım 1: Sağlayıcı Ekle Diyaloğunu Açın

1. LLM Sağlayıcıları bölümündeki Sağlayıcı Ekle butonuna tıklayın
2. Sağlayıcı Ekle diyalogu açılacaktır

Adım 2: Sağlayıcı Tipini Seçin

Sağlayıcı Tipi açılır menüsünden seçin:

• OpenAI: Resmi OpenAI API (GPT-4, GPT-3.5 vb.)
• AzureOpenAI: Microsoft Azure’da barındırılan OpenAI modelleri
• Anthropic: Anthropic’in Claude modelleri
• Google: Google’ın Gemini modelleri
• OpenRouter: OpenRouter üzerinden çoklu modellere erişim
• LMStudio: LM Studio kullanarak yerel dağıtım
• Diğer: Diğer OpenAI uyumlu API’ler (Ollama, xAI Grok ve benzerleri için; temel URL’yi girin)

Not: Tanınan sağlayıcılar için mindzieStudio temel URL’yi otomatik bilir. Yerel dağıtımlar veya özel sağlayıcılar için Diğer seçeneğini belirleyip temel URL girin.

Adım 3: Sağlayıcı Detaylarını Konfigüre Edin

Sağlayıcı Adı: Bu sağlayıcı için açıklayıcı bir isim girin (örneğin, "OpenAI Production", "Local LM Studio")

API Anahtarı: Sağlayıcınızdan aldığınız API anahtarını girin

• Bulut sağlayıcılar için, sağlayıcının kontrol panelinden alın
• Yerel dağıtımlarda gerek olmayabilir ya da boş bırakılabilir

Organizasyon ID’si (İsteğe Bağlı): Açıklama ve erişim kontrolü için bazı sağlayıcılar (OpenAI gibi) organizasyon ID’si destekler

Temel URL (İsteğe Bağlı): Özel veya yerel dağıtımlar için

• LM Studio örneği: http://localhost:1234/v1
• Ollama örneği: http://localhost:11434/v1
• Özel API: Sunucunuzun API uç noktası

Adım 4: Sağlayıcı Durumunu Ayarlayın

Aktif: Sağlayıcıyı etkinleştirmek için kutuyu işaretleyin

• Devre dışı bırakmak için işareti kaldırın (konfigürasyonu silmeden geçici kapatma için)
• API anahtarlarınız saklı kalır, ancak kullanımı durur

Varsayılan Sağlayıcı Yap: Bu sağlayıcıyı varsayılan olarak belirlemek için kutuyu işaretleyin

• Yeni modeller eklenirken varsayılan sağlayıcı olarak kullanılır
• Genellikle tek bir ana sağlayıcı kullandığınızda konfigürasyonu kolaylaştırır

Adım 5: Bağlantıyı Test Edin

Kaydetmeden önce sağlayıcınızın doğru yapılandırıldığını test edin:

1. Bağlantıyı Test Et butonuna tıklayın
2. mindzieStudio, kimlik bilgilerinizi kullanarak sağlayıcıya bağlanmayı dener
3. Başarılı veya hata mesajı gösterilir

Not: "Authentication failed: Invalid API key" hatası görürseniz, API anahtarınızın doğru ve süresinin dolmadığından emin olun.

Adım 6: Sağlayıcıyı Kaydedin

Oluştur butonuna tıklayarak sağlayıcı konfigürasyonunu kaydedin.

Sağlayıcınız artık LLM Sağlayıcıları tablosunda görünecektir.

Mevcut Sağlayıcıları Yönetme

Sağlayıcı Düzenleme

Ayarları güncellemek (örneğin API anahtarını döndürmek) için:

1. İşlemler sütunundaki düzenle simgesine (kalem) tıklayın
2. Sağlayıcı Düzenle diyaloğu mevcut ayarlarla açılır
3. Değişiklikleri yapın (örneğin API anahtarını güncelleyin)
4. Bağlantıyı Test Et ile yeni kimlik bilgilerini doğrulayın
5. Güncelle butonuna tıklayın

Yaygın Kullanım: API anahtarları güvenlik politikalarınız doğrultusunda düzenli olarak döndürülebilir. Sağlayıcıyı yeniden oluşturmadan anahtarları değiştirmek için bu işlevi kullanın.

Sağlayıcı Silme

Bir sağlayıcıyı kaldırmak için:

1. İşlemler sütunundaki sil simgesine (çöp kutusu) tıklayın
2. Silmeyi onaylayın

Uyarı: Sağlayıcı silindiğinde ilişkili modeller silinmez, ancak o modeller geçerli bir sağlayıcı olmadan çalışmaz.

Model Ekleme

En az bir sağlayıcı konfigüre ettikten sonra AI modelleri ekleyebilirsiniz.

Adım 1: Model Ekle Diyaloğunu Açın

1. LLM Modelleri bölümündeki Model Ekle butonuna tıklayın
2. Model Ekle diyaloğu açılacaktır

Diyalogun iki ana bölümü vardır:

• Model Konfigürasyonu (sol): Temel model ayarları
• Test & Doğrulama (sağ): Otomatik yetenek algılama

Adım 2: Sağlayıcıyı Seçin

Açılır menüden Sağlayıcıyı seçin.

Bu menü, yapılandırdığınız tüm aktif sağlayıcıları listeler.

Adım 3: Model Adı Seçin veya Girin

Model belirtmek için iki seçeneğiniz var:

Seçenek A: Listeden Seçme (Önerilen)

1. Sağlayıcı Model Adı alanının yanındaki Model Seç butonuna tıklayın
2. Bir Model Seç diyaloğu açılır ve arama kutusu görünür
3. mindzieStudio sağlayıcının API'sine sorgu gönderir ve mevcut modelleri listeler

4. Yüklendikten sonra kullanılabilir modeller listelenir

5. Bir modele tıklayarak seçin (örneğin gpt-5-search-api-2025-10-14)

Not: Sağlayıcının tüm modelleri chat için uygun olmayabilir. Örneğin, OpenAI ses ve embedding modelleri mindzieStudio copilots ile çalışmaz. Uyumsuz bir model seçmek kullanımda hatalara yol açar.

Seçenek B: Manuel Giriş

Modelin tam adını biliyorsanız, doğrudan Sağlayıcı Model Adı alanına yazabilirsiniz.

Örnekler:

• gpt-4-turbo
• gpt-4o-mini
• claude-3-opus-20240229

Adım 4: Model Görünür Adını Konfigüre Edin

Model Görünen Adı: Kullanıcıların göreceği dostça bir isim girin

• Örnek: GPT-4 Turbo (hızlı, uygun maliyetli)
• Bu isim, copilot arayüzünde model seçiminde görünür

Adım 5: Varsayılan Sıcaklığı Ayarlayın

Varsayılan Sıcaklık: 0 ile 2 arasında değer

• Düşük değerler (0-0.3): Daha keskin, deterministik yanıtlar
• Orta değerler (0.7-1.0): Yaratıcılık ve tutarlılık dengesi
• Yüksek değerler (1.0-2.0): Daha yaratıcı ve değişken yanıtlar

Varsayılan: Çoğu kullanım için 1 iyi başlangıçtır

Adım 6: Yetenekleri Otomatik Algıla

mindzieStudio modelin desteklediği özellikleri otomatik algılayabilir.

1. Test & Doğrulama bölümünde Yetenekleri Otomatik Konfigüre Et butonuna tıklayın
2. mindzieStudio sağlayıcıya bağlanır ve modeli test eder

3. Sistem saniyeler içinde şunları algılar ve konfigüre eder:
   • Token Limitleri: Maksimum bağlam ve çıktı token’ları
   • Model Yetenekleri: Desteklenen özellikler
   • Sıcaklık Desteği: Sıcaklık parametresi mevcut mu
   • Sistem Mesajları: Model sistem mesajlarını destekliyor mu
   • Araç Çağrısı: Model dış araçları çağırabiliyor mu

4. Başarı diyalogunda Kapat butonuna tıklayın
5. Yetenekler formda otomatik doldurulur

Otomatik Doldurulan Bilgiler:

• Maksimum Bağlam Tokenı: Örnek: 128.000
• Maksimum Çıktı Tokenı: Örnek: 16.000
• Algılanan Katman: Bu model için önerilen katman (Küçük, Ajan veya Düşünen)
• Model Yetenekleri: Sistem Mesajları (işaretli), Sıcaklık (örnekte işaretsiz)

Adım 7: Manuel Düzenleme (İsteğe Bağlı)

Gerekirse otomatik algılanan yetenekleri manuel düzenleyebilirsiniz.

Uyarı: Otomatik algılamanın yanlış olduğundan emin değilseniz değiştirmeyin. Yanlış ayarlar model kullanımında hatalara yol açar.

Örnek:

• Sıcaklık desteklenmeyen bir modelde bu özelliği etkinleştirirseniz API çağrıları başarısız olur
• Token limitlerini çok yüksek ayarlarsanız istekler reddedilebilir

Adım 8: Model Durumunu Ayarlayın

Aktif: Modeli kullanıma açmak için işaretleyin

• Devre dışı bırakmak için işareti kaldırabilirsiniz, ancak silmez

Kiracı Varsayılan Modeli Olarak Ayarla: Bu modeli tüm copilot asistanları için varsayılan yapar

• Sadece bir model kiracı genel varsayılan olabilir
• Yeni varsayılan ayarlayınca onun sağlayıcısı da varsayılan olur

Adım 9: Modeli Oluşturun

1. Oluştur butonuna tıklayın
2. Modelin başarılı şekilde eklendiğine dair Bilgi diyaloğu çıkar

3. Kapat butonuna tıklayın
4. Model artık LLM Modelleri tablosunda görünür

Modeller Tablosunu Anlama

LLM Modelleri tablosunda gösterilenler:

Sütun	Açıklama
Model Adı	Yapılandırdığınız görünür isim
Sağlayıcı	Bu modeli barındıran sağlayıcı
Sağlayıcı Model Adı	API tarafından kullanılan teknik model tanımlayıcısı
Katman	Model katmanı: Küçük (hızlı yönlendirme görevleri), Ajan (karmaşık akıl yürütme), Düşünen (uzun akıl yürütme) veya Devre Dışı
Durum	Aktif veya Pasif
Kiracı Varsayılanı	Model kiracı genel varsayılan ise "DEFAULT" gösterir
İşlemler	Modeli düzenle veya sil

Modelleri Yönetme

Modeli Düzenleme

Bir modeli değiştirmek için:

1. İşlemler sütunundaki düzenle simgesine tıklayın
2. Model Düzenle diyaloğunda ayarları güncelleyin
3. Güncelle butonu ile kaydedin

Farklı Bir Varsayılan Model Ayarlama

Varsayılan kullanılan modeli değiştirmek için:

1. Varsayılan yapmak istediğiniz modeli düzenleyin
2. Kiracı Varsayılan Modeli Olarak Ayarla seçeneğini işaretleyin
3. Güncelle butonuna tıklayın

Önceki varsayılan otomatik olarak işaret kaldırılır.

Model Silme

Modeli kaldırmak için:

1. İşlemler sütunundaki sil simgesine tıklayın
2. Silmeyi onaylayın

Not: Şu anda kiracı varsayılanı olan modeli silemezsiniz; önce başka bir model varsayılan yapılmalıdır.

Konfigürasyonunuzu Test Etme

Sağlayıcı ve modelleri konfigüre ettikten sonra şunları yaparak testi tamamlayın:

1. Copilot özelliklerinden birine gidin (örneğin, Soruşturmalar, AI Takım Arkadaşı)
2. Copilot arayüzünü açın
3. Varsayılan modelin model seçicide göründüğünü doğrulayın
4. Test sorgusu göndererek modelin doğru yanıt verdiğini kontrol edin

Desteklenen Sağlayıcılar

Bulut Sağlayıcıları

mindzieStudio herhangi bir OpenAI uyumlu API’yi destekler, örneğin:

• OpenAI: GPT-4, GPT-4 Turbo, GPT-3.5, GPT-5 (mevcut olduğunda)
• OpenRouter: Yüzlerce modele çoklu sağlayıcı erişimi
• Anthropic Claude (OpenRouter veya uyumlu proxy ile)
• Grok (xAI)
• Google Gemini (uyumlu API ile)
• Azure OpenAI Servisi
• Özel API’ler: OpenAI API standartlarını uygulayan hizmetler

Kurum İçi Çözümler

Veri gizliliği ve güvenlik için yerel modeller dağıtabilirsiniz:

• LM Studio: Kullanımı kolay yerel model dağıtımı
• Ollama: Hafif yerel model sunumu
• vLLM: Yüksek performanslı çıkarım sunucusu
• Text Generation Inference: Hugging Face çıkarım sunucusu
• LocalAI: OpenAI uyumlu yerel çıkarım

Kurum İçi Kurulum Gereksinimleri:

1. Seçtiğiniz yerel çıkarım yazılımını kurun
2. Tercih ettiğiniz modeli indirin ve yükleyin
3. Yerel sunucuyu başlatın (genellikle localhost:1234 veya localhost:11434)
4. mindzieStudio’da temel URL ile bir sağlayıcı ekleyin
5. Yerel sağlayıcı ile modelleri ekleyin

En İyi Uygulamalar

API Anahtarı Güvenliği

• Anahtarları Düzenli Döndürün: Güvenlik politikalarınıza göre periyodik olarak anahtar değiştirin
• Organizasyon ID’lerini Kullanın: Müşteri takibi ve maliyet kontrolü için kullanın
• Anahtar İzinlerini Sınırlayın: Gerekli minimum izinlere sahip anahtarlar oluşturun
• Anahtar Paylaşmayın: Her kullanıcı veya ekip kendi API kimlik bilgilerini kullansın

Model Seçimi

• Gerçek Zamanlı İçin Hızlı Modeller: Örneğin gpt-4o-mini gibi hızlı copilot yanıtları için
• Analiz İçin Düşünme Modelleri: Karmaşık analiz görevleri için büyük modeller (örneğin, gpt-5-search-api)
• Varsayılan Öncesi Test: Yeni modelleri kiracı varsayılan yapmadan önce kapsamlı test edin
• Maliyetleri İzleyin: Özellikle pahalı modellerde kullanım ve maliyet takibi yapın

Sağlayıcı Yönetimi

• Sağlayıcıları Aktif Tutun: Gerektiğinde devre dışı bırakın, ancak karışıklığı önlemek için etkin tutmaya çalışın
• Açıklayıcı İsimler Kullanın: Örneğin "OpenAI Production" veya "Local LM Studio Dev" gibi
• Bağlantıları Test Edin: Sağlayıcı ekledikten veya düzenledikten sonra mutlaka test edin
• Birden Fazla Sağlayıcı: Birincil sağlayıcınızda sorun olursa backup sağlayıcılar ekleyin

Yetenek Konfigürasyonu

• Otomatik Algılamaya Güvenin: Mümkün olduğunda yetenekleri otomatik konfigüre edin
• Tahminde Bulunmayın: Otomatik algılama başarısız olursa model dokümantasyonunu kontrol edin
• Token Limitlerini Doğrulayın: Yanlış limitler beklenmedik kesilmelere veya hatalara yol açar
• Düzenli Güncelleme: Model yetenekleri API güncellemeleri ile değişebilir

Sorun Giderme

Bağlantı Testi Başarısız Olursa

1. API Anahtarını Doğrulayın: Anahtarı doğrudan sağlayıcı kontrol panelinden kopyalayın
2. Temel URL’yi Kontrol Edin: URL’nin doğru ve protokolün (http:// veya https://) dahil olduğundan emin olun
3. Ağ Erişimi: Sağlayıcıya bağlantıya izin veren ağda olduğunuzu doğrulayın
4. Sağlayıcı Durumu: Sağlayıcı API servisinin çalışır durumda olup olmadığını kontrol edin
5. Organizasyon ID’sini Kaldırın: Eğer zorunlu değilse kaldırmayı deneyin

Model Copilot’ta Görünmüyorsa

1. Aktif Durumunu Kontrol Edin: Hem sağlayıcı hem model aktif olmalıdır
2. Sağlayıcı Durumunu Onaylayın
3. Arayüzü Yenileyin
4. Erişim İzinlerini Kontrol Edin

Otomatik Algılama Başarısız Olursa

1. Önce sağlayıcı bağlantısını test edin
2. Model adının doğru olduğunu doğrulayın
3. Bazı API’ler yetenek sorguları için özel izinler gerektirebilir
4. Gerekirse model dokümantasyonuna göre manuel konfigürasyon yapın

Model Kullanımında Hatalar Olursa

1. Yeteneklerin modelin gerçek destekledikleriyle uyumlu olduğundan emin olun
2. Maksimum bağlam ve çıktı token limitlerini kontrol edin; çok yüksekse ayarlayın
3. Bazı modeller sıcaklık parametresini desteklemez; gerekirse devre dışı bırakın
4. Sağlayıcının kota veya oran limitlerini aşıp aşmadığınızı kontrol edin

Örnek Konfigürasyonlar

Örnek 1: Birden Fazla Model ile OpenAI

Sağlayıcı Konfigürasyonu:

• Sağlayıcı Tipi: OpenAI
• Sağlayıcı Adı: "OpenAI Production"
• API Anahtarı: sk-... (gerçek anahtarınız)
• Aktif: Evet
• Varsayılan Sağlayıcı: Evet

Modeller:

1. Hızlı Yanıt için Hızlı Model

   • Model Adı: "GPT-4o Mini (Hızlı & Ucuz)"
   • Sağlayıcı Model Adı: gpt-4o-mini
   • Varsayılan Sıcaklık: 0.7
   • Kiracı Varsayılanı: Evet

2. Karmaşık Analiz için Düşünen Model

   • Model Adı: "GPT-5 Search API (Gelişmiş)"
   • Sağlayıcı Model Adı: gpt-5-search-api-2025-10-14
   • Varsayılan Sıcaklık: 1.0
   • Kiracı Varsayılanı: Hayır

Örnek 2: LM Studio ile Kurum İçi

Sağlayıcı Konfigürasyonu:

• Sağlayıcı Tipi: LM Studio
• Sağlayıcı Adı: "Local LM Studio"
• API Anahtarı: (boş bırakın veya sahte değer)
• Temel URL: http://localhost:1234/v1
• Aktif: Evet
• Varsayılan Sağlayıcı: Evet

Model:

• Model Adı: "Llama 3.1 70B (Yerel)"
• Sağlayıcı Model Adı: llama-3.1-70b-instruct
• Varsayılan Sıcaklık: 0.8
• Kiracı Varsayılanı: Evet

Örnek 3: Bulut ve Kurum İçi Karma

Esneklik için birden fazla sağlayıcı kullanın:

Sağlayıcılar:

1. OpenAI (bulut) - üretim yükleri için
2. LM Studio (yerel) - geliştirme ve hassas veri için

Modeller:

• Varsayılan: OpenAI GPT-4o Mini (üretim)
• İkincil: Yerel Llama 3.1 (geliştirme/test)

İlgili Dokümantasyon

• Soruşturmalarda Copilot Kullanımı - Süreç analizleri için AI asistanlarını kullanma
• AI Takım Arkadaşı - AI takım arkadaşınızı konfigüre etme ve kullanma
• Yönetici Ayarları - Kiracı genel diğer konfigürasyon seçenekleri

Destek

AI modellerini konfigüre ederken sorun yaşarsanız:

• E-posta: support@mindzie.com
• Dokümantasyon: AI sağlayıcınızın model isimleri ve yetenekleri için API dokümantasyonunu inceleyin
• Test: Sağlayıcı bağlantılarını ve model yanıtlarını varsayılan yapmadan önce mutlaka test edin