AI Sorgu Asistanı

Genel Bakış

AI Sorgu Asistanı, doğal dilde sorular sormanızı ve bunları CQL (Colpan Query Language) sorgularına dönüştürmenizi sağlar.

Temel Özellikler:

• Doğal dilde soru yazma
• Hukuk terminolojisi desteği
• Birden fazla sorgu önerisi
• Sonuç sayısı önizleme
• Sohbet geçmişi kaydetme

Kullanım Modları

1. CF Worker Modu (Varsayılan)

• Ücretsiz kullanım - API key gerekmez
• Cloudflare Worker üzerinden proxy
• Hız sınırı olabilir

Avantajlar:

• Kayıt veya ödeme gerektirmez
• Hemen kullanıma hazır

Dezavantajlar:

• Yoğun zamanlarda yavaş olabilir
• Günlük istek limiti

2. Direct OpenRouter Modu

• Kendi API key’inizi kullanın
• Daha hızlı ve güvenilir

API Key Alma:

1. openrouter.ai adresine gidin
2. Kayıt olun
3. Dashboard’dan API key oluşturun
4. sk-or-v1-xxx formatındaki key’i kopyalayın

Ayar:

1. Colpan’da Ayarlar > AI Asistan
2. “Direct OpenRouter” seçin
3. API key’i yapıştırın

Floating Panel Kullanımı

Panel Açma

Yöntemler:

• Toolbar’da AI butonuna (🤖) tıklayın
• Ayarlanan kısayolu kullanın

Panel Boyutu: 480 x 600 piksel

Arayüz

┌─────────────────────────────────────────┐
│ AI Sorgu Asistanı              [X]      │
├─────────────────────────────────────────┤
│                                         │
│ 👤 TOKİ kamulaştırma davaları bulun     │
│                                         │
│ 🤖 İşte CQL sorgu önerilerim:           │
│                                         │
│ ┌─────────────────────────────────────┐ │
│ │ toki kamulaştırma          [42] ▶  │ │
│ └─────────────────────────────────────┘ │
│ ┌─────────────────────────────────────┐ │
│ │ (TOKİ | "Toplu Konut") acele [18] ▶│ │
│ └─────────────────────────────────────┘ │
│ ┌─────────────────────────────────────┐ │
│ │ kamulaştırma !iptal          [67] ▶│ │
│ └─────────────────────────────────────┘ │
│                                         │
├─────────────────────────────────────────┤
│ [Yazın...                    ] [Gönder] │
└─────────────────────────────────────────┘

Sorgu İsteme

1. Soru yazın:

   TOKİ kamulaştırma davaları bulun

2. Gönder’e tıklayın veya Enter tuşuna basın

3. Öneriler gelir:

   • Her öneri bir buton olarak gösterilir
   • Yanında tahmini sonuç sayısı (Manticore ile)
   • ▶ butonuyla arama kutusuna aktarın

Sorgu Önizleme

Manticore Search aktifse, her sorgu önerisi için tahmini sonuç sayısı gösterilir.

Görüntü	Anlam
[42]	42 belge bulundu
[0]	Sonuç yok
[⏳]	Hesaplanıyor
[-]	Manticore kapalı

Nasıl Çalışır:

1. AI sorgu önerir
2. Her sorgu Manticore’a gönderilir
3. Sonuç sayısı gösterilir
4. En çok sonuç veren sorguyu seçebilirsiniz

Sohbet Geçmişi

Kaydetme

1. Panel açıkken sohbeti kullanın
2. Panel kapandığında otomatik kaydedilir
3. Veya “Geçmiş” > “Kaydet” seçin

Yükleme

1. Panel açın
2. “Geçmiş” > “Son Sohbet” seçin
3. Önceki sohbet yüklenir

Temizleme

1. “Geçmiş” > “Temizle” seçin
2. Sohbet sıfırlanır

Örnek Kullanım Senaryoları

Senaryo 1: Basit Arama

Soru: “Boşanma davalarını bul”

AI Önerileri:

boşanma
"boşanma davası"
boşanma ; nafaka

Senaryo 2: Karmaşık Kriter

Soru: “TOKİ veya Toplu Konut İdaresi kamulaştırma kararları, iptal olanlar hariç”

AI Önerileri:

(TOKİ | "Toplu Konut") kamulaştırma !iptal
toki ; kamulaştırma ; !iptal
"Toplu Konut İdaresi" ; kamulaştırma ; !iptal

Senaryo 3: Tarih Bazlı

Soru: “2023 yılı Yargıtay ceza dairesi kararları”

AI Önerileri:

Yargıtay ; "ceza dairesi" ; 2023
"Yargıtay Ceza" ; 2023

Senaryo 4: Hukuk Terminolojisi

Soru: “Kamulaştırmasız el atma tazminat davaları”

AI Önerileri:

"kamulaştırmasız el atma" ; tazminat
"kamulaştırmasız el atma"
el ; atma ; tazminat ; !kamulaştırma

Tema Uyumu

AI panel, sistemin koyu/açık temasına uyum sağlar.

Tema	Görünüm
Açık	Beyaz arkaplan, koyu metin
Koyu	Koyu arkaplan, açık metin
Sistem	Otomatik takip

Sorun Giderme

”Bağlantı hatası” mesajı

Olası Nedenler:

• İnternet bağlantısı yok
• CF Worker erişilemez
• API key geçersiz (Direct mod)

Çözümler:

1. İnternet bağlantınızı kontrol edin
2. CF Worker modunu deneyin
3. API key’i yeniden girin

Yanıt gelmiyor

Olası Nedenler:

• Sunucu yoğun
• İstek zaman aşımı

Çözümler:

1. Birkaç saniye bekleyin
2. Tekrar deneyin
3. Soruyu kısaltın

Sorgu önerileri uygun değil

İpuçları:

• Daha spesifik sorular sorun
• Hukuk terimlerini kullanın
• Örnek belge adı verin

API Limitleri

CF Worker Modu

Limit	Değer
Günlük istek	~100
İstek başına token	~500

Direct OpenRouter Modu

Limit	Değer
Günlük istek	API kredisine bağlı
İstek başına token	Ayarlanabilir

Gizlilik

• CF Worker: Sorular Cloudflare üzerinden geçer
• Direct: Sorular doğrudan OpenRouter’a gider
• Dosya içerikleri asla gönderilmez
• Sadece sorular ve öneriler iletilir