AI Model Konfigürasyonu

mindzieStudio artık büyük dil modeli (LLM) entegrasyonunu önemli ölçüde geliştirdi, böylece AI yardımcı pilotlarınızı ve asistanlarınızı güçlendirmek için esnek seçenekler sunuyor. 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 modeller dağıtabilirsiniz.

Genel Bakış

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

• mindzie Proxy Modellerini Kullanın: mindzieStudio tarafından kutudan çıktığı gibi sağlanan hızlı ve düşünme modellerine erişin
• Kendi Modellerinizi Getirin: Kendi kimlik bilgilerinizle OpenAI uyumlu herhangi bir API'ye bağlanın
• Bulut Sağlayıcıları: OpenAI, OpenRouter, Grok, Gemini ve diğer büyük AI sağlayıcılarını kullanın
• Kurum İçi Dağıtım: LM Studio, Ollama veya benzeri platformları kullanarak yerel modeller dağıtın
• Otomatik Algılama: mindzieStudio model yeteneklerini, token limitlerini ve özellikleri otomatik olarak algılasın
• Çoklu Modeller: Farklı kullanım durumları için gerektiği kadar model yapılandırın

AI Model Konfigürasyonu Ne Zaman Kullanılır

AI modellerini yapılandırmanız gereken durumlar:

• Yardımcı pilot asistanlarını ilk kez kurarken
• Maliyet veya performansa bağlı olarak farklı AI sağlayıcıları arasında geçiş yaparken
• Veri gizliliği ve güvenliği için kurum içi modeller dağıtırken
• Belirli görevler için özel modeller kullanırken (hızlı yanıtlar için hızlı modeller, karmaşık analiz için düşünme modelleri)
• Güvenlik uyumluluğu için API anahtarlarını döndürürken
• Yeni modelleri varsayılan yapmadan önce test ederken

Ön Koşullar

AI modelleri yapılandırmadan önce:

• Yönetici Erişimi: mindzieStudio ayarlarına yönetici erişiminiz olmalıdır
• API Anahtarları: Seçilen sağlayıcıdan (OpenAI, OpenRouter, vb.) API anahtarları alın
• Sağlayıcı Hesabı: Harici hizmet kullanılıyorsa 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

Yardımcı Pilot Ayarlarına Erişim

Yönetim panelinden yardımcı pilot ayarlarına gidin.

1. Sağ üst köşedeki profil simgenize tıklayın
2. Açılır menüden Ayarlar'ı seçin
3. Sol yan çubukta mindzie Copilot'a tıklayın

İki ana bölümden oluşan mindzie Copilot Ayarları sayfasını göreceksiniz:

• LLM Sağlayıcıları: AI servis sağlayıcılarınızı yönetin
• LLM Modelleri: Sağlayıcılardan belirli modelleri yapılandırın

AI Sağlayıcısı Ekleme

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

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

1. LLM Sağlayıcıları bölümünde Add Provider (Sağlayıcı Ekle) butonuna tıklayın
2. Add Provider diyaloğu açılacaktır

2. Adım: Sağlayıcı Türünü Seçin

Provider Type açılır menüsünden seçin:

• OpenAI: Resmi OpenAI API (GPT-4, GPT-3.5, vb.)
• OpenRouter: OpenRouter üzerinden çoklu modellere erişim
• Grok: xAI'nin Grok modelleri
• Gemini: Google'ın Gemini modelleri
• LM Studio: LM Studio kullanarak yerel dağıtım
• Ollama: Ollama kullanarak yerel dağıtım
• Other: Diğer OpenAI uyumlu API'ler

Not: Bilinen sağlayıcılar için mindzieStudio temel URL'yi otomatik bilir. Yerel dağıtımlar veya özel sağlayıcılar için temel URL'yi vermeniz gerekir.

3. Adım: Sağlayıcı Ayrıntılarını Yapılandırma

Provider Name: Bu sağlayıcı için açıklayıcı bir isim girin (örn. "OpenAI Production", "Local LM Studio")

API Key: Sağlayıcıdan aldığınız API anahtarını girin

• Bulut sağlayıcıları için sağlayıcı panelinden alınır
• Yerel dağıtımlar için gerekli olmayabilir veya boş bırakılabilir

Organization ID (Opsiyonel): OpenAI gibi bazı sağlayıcılar faturalama ve erişim için organizasyon kimliği destekler

Base URL (Opsiyonel): Ö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ı

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

Active: Bu kutuyu işaretleyerek sağlayıcıyı etkinleştirin

• İşaretini kaldırmak geçici olarak devre dışı bırakır, yapılandırmayı silmez
• Kullanımı durdurup API anahtarlarını saklamak için faydalıdır

Set as Default Provider: Bu kutuyu işaretleyin, sağlayıcı varsayılan yapılsın

• Yeni modeller eklenirken varsayılan sağlayıcı olarak kullanılır
• Genellikle tek bir sağlayıcıyı tercih ediyorsanız yapılandırmayı basitleştirir

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

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

1. Test Connection butonuna tıklayın
2. mindzieStudio kimlik bilgilerinizle sağlayıcıya bağlanmayı dener
3. Başarı ya da hata mesajı gösterilir

Not: "Authentication failed: Invalid API key" (Kimlik doğrulama başarısız: Geçersiz API anahtarı) görürseniz API anahtarınızı doğrulayın ve süresinin geçmediğinden emin olun.

6. Adım: Sağlayıcıyı Kaydet

Create butonuna tıklayın ve sağlayıcı yapılandırmasını 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

API anahtarını döndürmek gibi ayarları güncellemek için:

1. Actions sütunundaki düzenle simgesine (kalem) tıklayın
2. Edit Provider diyaloğu mevcut ayarlarla açılır
3. Değişiklikleri yapın (örneğin API anahtarını güncelleyin)
4. Yeni kimlik bilgilerini doğrulamak için Test Connection'a tıklayın
5. Değişiklikleri kaydetmek için Update'e tıklayın

Yaygın Kullanım: IT departmanınızın güvenlik politikaları doğrultusunda API anahtarlarını periyodik olarak döndürmeniz gerekebilir. Sağlayıcı Düzenle özelliği ile tüm yapılandırmayı yeniden yapmadan anahtarları güncelleyebilirsiniz.

Sağlayıcı Silme

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

1. Actions sütunundaki silme simgesine (çöp kutusu) tıklayın
2. Silmeyi onaylayın

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

Model Ekleme

En az bir sağlayıcı yapılandırdıktan sonra AI modelleri ekleyebilirsiniz.

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

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

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

• Model Configuration (sol): Temel model ayarları
• Testing & Validation (sağ): Otomatik yetenek algılama

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

Provider açılır menüsünden sağlayıcıyı seçin.

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

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

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

Seçenek A: Listeden Seç (Önerilir)

1. Provider Model Name alanının yanındaki Select Model butonuna tıklayın
2. Arama kutusuyla birlikte bir Select Model diyaloğu açılır
3. mindzieStudio sağlayıcının API'sini sorgulayarak mevcut modelleri getirir

4. Yüklendikten sonra mevcut modeller listelenir

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

Not: Sağlayıcının tüm modelleri sohbet için uygun olmayabilir. Örneğin OpenAI'nin ses ve embedding modelleri mindzieStudio yardımcı pilotlarında çalışmaz. Uyumlu olmayan bir modeli seçerseniz kullanımda hatalar oluşur.

Seçenek B: Manuel Giriş

Modelin tam adını biliyorsanız Provider Model Name alanına doğrudan yazabilirsiniz.

Örnekler:

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

4. Adım: Model Görüntü Adını Yapılandırın

Model Display Name: Kullanıcıların göreceği anlaşılır bir ad girin

• Örnek: GPT-4 Turbo (hızlı, ekonomik)
• Bu isim yardımcı pilot arayüzünde model seçimi sırasında görünür

5. Adım: Varsayılan Sıcaklık Değerini Belirleyin

Default Temperature: 0 ile 2 arasında ayarlayın

• Daha düşük değerler (0-0.3): Daha belirgin, odaklı yanıtlar
• Orta değerler (0.7-1.0): Yaratıcılık ve tutarlılık dengesi
• Daha yüksek değerler (1.0-2.0): Daha yaratıcı ve çeşitli yanıtlar

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

6. Adım: Yetenekleri Otomatik Algıla

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

1. Testing & Validation bölümünde Auto-Configure Capabilities butonuna tıklayın
2. mindzieStudio sağlayıcıya bağlanıp modeli test eder

3. Sistem saniyeler içinde şunları algılar ve yapılandırır:
   • Token Limitleri: Maksimum giriş ve çıktı token sayısı
   • Model Yetenekleri: Desteklenen özellikler
   • Sıcaklık Desteği: Sıcaklık parametresi mevcut mu
   • Sistem Mesajları: Sistem mesajlarını destekliyor mu
   • Araç Çağırma: Harici araçları kullanabiliyor mu

4. Başarı diyaloğunda Close'a tıklayın
5. Yetenekler formda otomatik doldurulur

Otomatik Doldurulan Bilgiler:

• Max Context Tokens: 128.000 (bu örnekte)
• Max Output Tokens: 16.000 (bu örnekte)
• Model Yetenekleri: Sistem Mesajları (işaretli), Sıcaklık (bu örnekte işaretli değil)

7. Adım: Manuel Geçersiz Kılma (Opsiyonel)

Otomatik algılanan yetenekleri isterseniz manuel olarak düzenleyebilirsiniz.

Uyarı: Sadece otomatik algılama yanlışsa geçersiz kılın. Yanlış yetenek ayarları model kullanımında hata oluşturur.

Örneğin:

• Sıcaklık desteklenmeyen bir modele yanlışlıkla Temperature ayarı verirseniz API çağrıları başarısız olur
• Token limitini çok yüksek verirseniz istekler reddedilebilir

8. Adım: Model Durumunu Ayarlayın

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

• Geçici devre dışı bırakmak için işaret kaldırılabilir

Set as Tenant Default Model: Bu modeli tüm yardımcı pilotlar için varsayılan yapar

• Sadece bir model tenant varsayılan olabilir
• Yeni varsayılan ayarlamak aynı zamanda modelin sağlayıcısını da varsayılan yapar

9. Adım: Modeli Oluşturun

1. Create butonuna tıklayın
2. Modelin başarıyla eklendiğine dair bir bilgi diyaloğu açılır

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

Modeller Tablosunu Anlama

LLM Modelleri tablosu şunları gösterir:

Sütun	Açıklama
Model Name	Yapılandırdığınız görüntü adı
Provider	Bu modeli barındıran sağlayıcı
Provider Model Name	API tarafından kullanılan teknik model kimliği
Family	Model ailesi (örn. GPT4o, GPT5) varsa
Status	Etkin veya Devre Dışı
Tenant Default	Values is "DEFAULT" if this is tenant default
Actions	Modeli düzenleme veya silme işlemleri

Modelleri Yönetme

Model Düzenleme

Model konfigürasyonunu değiştirmek için:

1. Actions sütunundaki düzenle simgesine tıklayın
2. Edit Model diyaloğunda ayarları güncelleyin
3. Değişiklikleri kaydetmek için Update butonuna tıklayın

Farklı Varsayılan Model Ayarlama

Hangi modelin varsayılan kullanılacağını değiştirmek için:

1. Varsayılan yapmak istediğiniz modeli düzenleyin
2. Set as Tenant Default Model kutusunu işaretleyin
3. Update butonuna tıklayın

Önceki varsayılan otomatik olarak işaretsiz olur.

Model Silme

Bir modeli kaldırmak için:

1. Actions sütunundaki silme simgesine tıklayın
2. Silmeyi onaylayın

Not: Şu anda tenant varsayılanı olan modeli silemezsiniz. Önce başka bir modeli varsayılan yapmalısınız.

Yapılandırmanızı Test Etme

Sağlayıcıları ve modelleri yapılandırdıktan sonra kurulumunuzu test edin:

1. Yardımcı pilot özellikli bir bölüme gidin (örn. Investigations, AI Teammate)
2. Yardımcı pilot arayüzünü açın
3. Varsayılan modelin model seçicide göründüğünü doğrulayın
4. Modelin doğru yanıt verdiğini test etmek için bir sorgu gönderin

Desteklenen Sağlayıcılar

Bulut Sağlayıcıları

mindzieStudio, OpenAI uyumlu herhangi bir 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 vekil üzerinden)
• Grok (xAI)
• Google Gemini (uyumlu API üzerinden)
• Azure OpenAI Servisi
• Özel API'ler: OpenAI API spesifikasyonunu uygulayan tüm servisler

Kurum İçi Çözümler

Veri gizliliği ve güvenliği 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çilen 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 yerel temel URL ile sağlayıcı ekleyin
5. Yerel sağlayıcıyı kullanarak modelleri ekleyin

En İyi Uygulamalar

API Anahtarı Güvenliği

• Anahtarları Düzenli Döndürün: Güvenlik politikalarınıza göre API anahtarlarını periyodik değiştirin
• Organizasyon Kimlikleri Kullanın: Kullanım ve maliyet takibi için destekleniyorsa organizasyon ID'lerini kullanın
• Anahtar İzinlerini Sınırlandırın: Minimum yetki gerektiren anahtarlar kullanın
• Anahtarları Paylaşmayın: Her kullanıcı veya ekip kendi API kimlik bilgilerine sahip olmalı

Model Seçimi

• Gerçek Zamanlı için Hızlı Modeller: gpt-4o-mini gibi modellerle hızlı yanıtlar alın
• Analiz için Düşünme Modelleri: gpt-5-search-api gibi daha büyük modeller karmaşık analizlerde kullanılır
• Varsayılan Yapmadan Önce Test Edin: Yeni modelleri tenant varsayılan yapmadan önce iyice test edin
• Maliyetleri İzleyin: Özellikle pahalı modellerin kullanım ve maliyetlerini takip edin

Sağlayıcı Yönetimi

• Sağlayıcıları Aktif Tutun: Karışıklığı önlemek için yalnızca gerektiğinde devre dışı bırakın
• Tanımlayıcı İsimler Kullanın: “OpenAI Production” veya “Local LM Studio Dev” gibi açıklayıcı isimler tercih edin
• Bağlantıları Test Edin: Sağlayıcı ekledikten veya düzenledikten sonra mutlaka testi çalıştırın
• Birden Çok Sağlayıcı: Birincil sağlayıcıda sorun çıkarsa yedek sağlayıcılar yapılandırın

Yetenek Yapılandırması

• Otomatik Algılamaya Güvenin: Mümkünse yetenekleri otomatik yapılandırma kullanın
• Tahminde Bulunmayın: Otomatik algılama başarısız olursa model dokümantasyonunu inceleyin
• Token Limitlerini Doğrulayın: Yanlış token limitleri beklenmedik kesilmelere ve hatalara neden olur
• Düzenli Güncelleme: Model yetenekleri API güncellemeleriyle 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ı panelinden kopyalayın
2. Temel URL'yi Kontrol Edin: Protokol dahil (http:// veya https://) doğru yazıldığından emin olun
3. Ağ Erişimini Doğrulayın: Ağınızın sağlayıcıya bağlantıya izin verdiğinden emin olun
4. Sağlayıcı Durumunu Kontrol Edin: Sağlayıcının API'si hizmet dışı olabilir
5. Organizasyon Kimliği: Gerekmiyorsa organizasyon ID'yi kaldırın

Model Yardımcı Pilotlarda Görünmüyorsa

1. Aktif Durumu Kontrol Edin: Hem sağlayıcı hem model Etkin olmalı
2. Sağlayıcıyı Doğrulayın: Modelin bağlı olduğu sağlayıcı etkin olmalı
3. Arayüzü Yenileyin: Yardımcı pilot arayüzünü yenileyin
4. Yetkileri Kontrol Edin: AI özellikleri kullanım hakkınız olduğundan emin olun

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

1. Önce Sağlayıcıyı Test Edin: Sağlayıcı bağlantısı geçerli olmalı
2. Model Adını Kontrol Edin: Model adı doğru olmalı
3. API İzinleri: Bazı API'ler yetenek sorguları için özel izin gerektirir
4. Manuel Yapılandırma: Gerekirse model dokümantasyonuna göre yetenekleri manuel belirleyin

Model Kullanımında Hatalar Olursa

1. Yetenekleri Gözden Geçirin: Yetenekler gerçek modele uygun olmalı
2. Token Limitlerini Kontrol Edin: Maksimum bağlam ve çıktı tokenleri çok yüksek olmamalı
3. Sıcaklık Ayarı: Bazı modeller sıcaklık parametresini desteklemez - gerekirse devre dışı bırakın
4. API Kota: Sağlayıcınızın oran limitlerini veya kotalarını aşıp aşmadığınızı kontrol edin

Örnek Yapılandırmalar

Örnek 1: OpenAI ile Çoklu Modeller

Sağlayıcı Yapılandırması:

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

Modeller:

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

   • Model Adı: "GPT-4o Mini (Hızlı & Ucuz)"
   • Provider Model Name: gpt-4o-mini
   • Varsayılan Sıcaklık: 0.7
   • Tenant Varsayılanı: Evet

2. Karmaşık Analiz için Düşünme Modeli

   • Model Adı: "GPT-5 Search API (Gelişmiş)"
   • Provider Model Name: gpt-5-search-api-2025-10-14
   • Varsayılan Sıcaklık: 1.0
   • Tenant Varsayılanı: Hayır

Örnek 2: LM Studio ile Kurum İçi

Sağlayıcı Yapılandırması:

• Sağlayıcı Türü: LM Studio
• Sağlayıcı Adı: "Local LM Studio"
• API Anahtarı: (boş bırakın veya dummy değer)
• Base URL: http://localhost:1234/v1
• Etkin: Evet
• Varsayılan Sağlayıcı: Evet

Model:

• Model Adı: "Llama 3.1 70B (Yerel)"
• Provider Model Name: llama-3.1-70b-instruct
• Varsayılan Sıcaklık: 0.8
• Tenant Varsayılanı: Evet

Örnek 3: Karma Bulut ve Kurum İçi

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

Sağlayıcılar:

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

Modeller:

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

İlgili Dokümantasyon

• Investigations'da Yardımcı Pilot Kullanımı - Süreç analizinde AI asistanlarını kullanmayı öğrenin
• AI Teammate - AI takım arkadaşınızı yapılandırın ve çalıştırın
• Yönetim Ayarları - Diğer tenant genel yapılandırma seçenekleri

Destek

AI modellerini yapılandırırken sorun yaşarsanız:

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