1. Genel Bakış

Kuika platformunda, çalışma alanınızda (workspace) kullanılan AI Chatbot özelliğinin kredi tüketimini, kullanım limitlerini ve detaylı kullanım analizlerini yönetebileceğiniz bir yönetim ekranı bulunur. Bu ekrana, platforma giriş yaptıktan sonra sol kenar çubuğundaki dişli (Ayarlar) ikonuna tıklayarak ve açılan menüden AI Chatbot sekmesini seçerek ulaşabilirsiniz.

AI Chatbot yönetim ekranı üç sekmeden oluşur:

• Credits: Çalışma alanınızın kredi bakiyesini görüntüleme ve yeni kredi satın alma.
• Token Limits: Üyelerin AI kullanımını haftalık/aylık kredi bazında sınırlama.
• Analytics: Kredi ve token tüketimini, sohbet sayılarını ve aktif üye bilgilerini zaman bazlı olarak analiz etme.

2. Credits Sekmesi

Bu sekme, çalışma alanınızın AI Chatbot için kullandığı kredi sistemini yönetmenizi sağlar.

AI Chatbot, çalışma alanınızdaki tüm üyeler tarafından paylaşılan ortak bir kredi havuzu üzerinden çalışır. Her yeni çalışma alanı, ücretsiz bir hoş geldin bonusu ile başlar; krediler tükendiğinde istediğiniz zaman ek kredi satın alınabilir. Daha uzun sohbetler ve daha yetenekli modeller, krediyi daha hızlı tüketir.

2.1. Available Credits (Kullanılabilir Krediler)

Ekranın üst kısmında yer alan bilgi kartında aşağıdaki veriler gösterilir:

• Available Credits: Çalışma alanında o an kullanılabilir toplam kredi miktarı.
• Welcome Bonus: Çalışma alanı oluşturulduğunda tanımlanan ücretsiz başlangıç kredisi.
• Total Purchased: Şimdiye kadar satın alınmış toplam kredi miktarı.
• Total Used: Şimdiye kadar tüketilmiş toplam kredi miktarı.
• Remaining: Kalan kullanılabilir kredi miktarı (Available Credits ile aynı değeri gösterir).

2.2. Add More Credits (Kredi Satın Alma)

Kredi bakiyesi yetersiz kaldığında, ekranın alt kısmındaki paket seçeneklerinden birini seçerek ek kredi satın alabilirsiniz:

• Hazır paketler arasından (örn. $5 / 500 kredi, $20 / 2.000 kredi, $50 / 5.000 kredi, $100 / 10.000 kredi) seçim yapılabilir.
• Custom seçeneği ile istenilen tutarda özel bir kredi paketi oluşturulabilir.
• En popüler paket, ekranda "POPULAR" etiketiyle vurgulanır.
• Ödeme işlemleri Stripe altyapısı üzerinden güvenli şekilde gerçekleştirilir; ödeme onaylandığı anda satın alınan krediler çalışma alanına yansır.

3. Token Limits Sekmesi

Bu sekme, AI harcamalarını öngörülebilir tutmak amacıyla, her üyenin haftalık veya aylık olarak ne kadar kredi kullanabileceğini sınırlamanızı sağlar. Üyeler, tanımlı limite yaklaştıklarında bir uyarı görür; limite ulaşıldığında ne olacağı ise yönetici tarafından belirlenir.

3.1. Workspace Policy (Çalışma Alanı Politikası)

Bu bölümde, özel bir sınırlaması olmayan tüm üyelere uygulanan genel (varsayılan) kullanım politikası tanımlanır:

• Weekly Limit (Haftalık Limit): Üyenin bir hafta içinde kullanabileceği maksimum kredi miktarını belirler. Toggle kapalıyken "No limit" (sınırsız) olarak çalışır; açıldığında bir kredi değeri girilebilir.
• Monthly Limit (Aylık Limit): Üyenin bir ay içinde kullanabileceği maksimum kredi miktarını belirler. Aynı şekilde toggle ile aktif/pasif edilebilir.
• When a Member Hits Their Limit (Limite Ulaşıldığında): Bir üye tanımlı limite ulaştığında sistemin nasıl davranacağını belirler:
  
  • Block: Üyenin sohbetleri, limit periyodu (hafta/ay) yenilenene kadar tamamen durdurulur (reddedilir).
  • Warn: Üyeye bir uyarı gösterilir, ancak kullanım engellenmez.
• Limitler her zaman kredi cinsinden ölçülür.
• Yapılan değişiklikler Save butonuyla kaydedilir; Revert ile son kaydedilmemiş değişiklikler geri alınabilir.

3.2. Per Member (Üye Bazlı Özel Limitler)

Workspace Policy tüm üyelere varsayılan olarak uygulanırken, Members tablosu üzerinden belirli üyeler için özel (custom) limitler tanımlanabilir veya üyeler genel politikadan muaf tutulabilir.

Tabloda her üye için şu bilgiler listelenir:

• Member: Üyenin adı ve e-posta adresi.
• This Week / This Month: Üyenin ilgili periyotta kullandığı kredi miktarı ve tanımlı limiti (örn. "0 · no limit").
• Limits: Üyeye uygulanan limit politikası (varsayılan olarak "Default" — Workspace Policy'yi kullanır).
• Status: Üyenin limit durumu (örn. "OK" — herhangi bir limit aşımı yok).
• Edit: İlgili üyeye tıklanarak veya "Edit" butonuyla, o üyeye özel bir limit tanımlanabilir ya da üye genel politikadan muaf tutulabilir.

(i) Tablo başlıklarındaki filtre ikonları ile Member, This Week, This Month, Limits ve Status alanlarına göre filtreleme yapılabilir.

4. Analytics Sekmesi

Analytics sekmesi, çalışma alanınızdaki AI Chatbot kullanımını detaylı biçimde izlemenizi sağlar. Bu sekme sayesinde proje yöneticileri, hangi üyenin, hangi modeli, ne sıklıkla ve ne kadar kredi/token harcayarak kullandığını görebilir.

4.1. Zaman Aralığı Seçimi

Ekranın üst kısmında, analiz edilecek dönem aşağıdaki hazır seçeneklerden seçilebilir:

• 7d (son 7 gün)
• 30d (son 30 gün)
• 90d (son 90 gün)
• This month (bu ay)

Seçilen aralık, ekranın sağ üst köşesinde tarih formatında gösterilir (örn. "May 14 – Aug 12").

4.2. Usage Analytics (Kullanım Özeti)

Seçilen dönem için özet metrikleri içeren koyu renkli bir bilgi kartı görüntülenir:

• Credits Used: İlgili dönemde tüketilen toplam kredi miktarı.
• Chats: İlgili dönemde başlatılan/gerçekleştirilen toplam sohbet sayısı.
• Tokens: İlgili dönemde işlenen toplam token miktarı; ayrıca giriş (in) ve çıkış (out) token miktarları ayrı ayrı gösterilir (örn. "793.7K in · 39.9K out").
• Active Members: İlgili dönemde AI Chatbot'u en az bir kez kullanmış üye sayısı.

(i) Seçilen dönemde herhangi bir AI etkileşimi gerçekleşmemişse, tüm değerler "0" olarak görüntülenir ve grafik alanında "No AI activity in this period — Usage will appear here as your team chats with the AI." mesajı gösterilir.

4.3. Credits Used Grafiği

Usage Analytics kartının altında, kredi tüketiminin zaman içindeki değişimini gösteren bir çizgi grafik yer alır.

• Grafik verisi Day / Week / Month seçenekleriyle günlük, haftalık veya aylık olarak gruplanabilir.
• Yatay eksende tarihler, dikey eksende tüketilen kredi miktarı gösterilir.
• Kullanım yoğunluğunun arttığı dönemler grafikte belirgin tepe noktaları (peak) olarak görülebilir; bu sayede anormal veya yoğun kullanım dönemleri kolayca tespit edilebilir.

4.4. Where Credits Go (Kredilerin Dağılımı)

Bu bölüm, kredi tüketiminin hangi boyutta dağıldığını görüntülemenizi sağlar. Üstteki sekme seçicisi ile üç farklı kırılım arasında geçiş yapılabilir:

• Members: Krediyi en çok tüketen üyeleri, kullandıkları kredi ve gerçekleştirdikleri sohbet sayısıyla birlikte listeler (örn. "Furkan Ceylan — 179 credits · 17 chats").
• Projects: Krediyi en çok tüketen projeleri listeler.
• Models: Krediyi en çok tüketen AI modellerini listeler (örn. openai/gpt-5.4, openai/gpt-5.4-nano).

Liste, en yüksek tüketimden en düşüğe doğru sıralanır ve her satırda sıra numarası, ilgili üye/proje/model adı ile tüketim özeti gösterilir.

4.5. Recent Requests (Son İstekler)

Bu tablo, gerçekleşen her bir AI isteğinin ayrıntılı kaydını (log) satır satır listeler. Denetim, hata ayıklama ve kullanım kalitesi değerlendirmesi için kullanılabilir.

Tabloda yer alan alanlar:

• When: İsteğin gerçekleştiği tarih ve saat.
• Member: İsteği gönderen üyenin e-posta adresi.
• Project: İsteğin ilişkilendirildiği proje (proje ile eşleştirilmemiş istekler "Unattributed" olarak gösterilir).
• Model: İstek için kullanılan AI modeli (örn. openai/gpt-5.4, openai/gpt-5.4-nano).
• Credits: İlgili istek için harcanan kredi miktarı.
• Tokens: İlgili istek için işlenen token miktarı.

(i) Her sütun başlığındaki filtre ikonu ile ilgili alana göre filtreleme yapılabilir. Ayrıca üstteki Search kutusu ile kayıtlar arasında serbest metin araması yapılabilir. Tablo, sayfa altındaki sayfalama kontrolleriyle sayfalara bölünmüş şekilde görüntülenir.

5. Kullanım Senaryosu: Kredi ve Kullanım Denetimi

Bir çalışma alanı sahibi (owner), ekibinin AI Chatbot kullanımını denetlemek ve gerekirse limit tanımlamak ister.

Adımlar:

1. Sol kenar çubuğundaki dişli ikonuna tıklayın ve AI Chatbot sekmesine girin.
2. Credits sekmesinden mevcut kredi bakiyesini kontrol edin; bakiye düşükse uygun bir paket seçerek kredi satın alın.
3. Analytics sekmesine geçin ve istenen zaman aralığını (7d / 30d / 90d / This month) seçin.
4. Where Credits Go bölümünden Members sekmesini seçerek en çok kredi tüketen üyeleri belirleyin.
5. Belirli bir üyenin kredi tüketiminin fazla olduğunu tespit ederseniz, Token Limits sekmesine geçip ilgili üyeyi tabloda bulun ve Edit ile özel bir haftalık/aylık limit tanımlayın.
6. Recent Requests tablosundan, belirli bir tarihte veya modelle yapılan istekleri filtreleyerek detaylı inceleme yapabilirsiniz.

Beklenen Sistem Davranışı:

• Analytics sekmesindeki tüm veriler seçilen zaman aralığına göre anlık olarak güncellenir.
• Token Limits sekmesinde tanımlanan limitler, kaydedildikten sonra ilgili üyenin bir sonraki AI isteğinden itibaren geçerli olur.
• Limite ulaşan bir üye, "Block" politikası tanımlıysa yeni istek gönderemez; "Warn" politikası tanımlıysa uyarı görür ancak kullanmaya devam edebilir.

‍