Kolayz Anka Ürün Tanıtımı
Örnekler sentetiktir. Bu dokümandaki anahtarlar (
kz-…), tenant adları ve rakamlar gerçek müşteri verisi değildir. Fiyatlar ABD doları üzerinden, KDV hariçtir ve Faz 1'de hiçbir müşteriye fatura edilmez.
Giriş
Bugün her Kolayz ürünü kendi yapay zekâ sağlayıcısını ayrı ayrı yönetiyor: ayrı API anahtarı, ayrı sözleşme, ayrı fatura, ayrı KVKK değerlendirmesi. Müşteri tarafında da aynı tablo — bir kurum, ürünü kullanmaya başlamadan önce OpenAI hesabı açmak, kurumsal kartını girmek ve kendi anahtarını yönetmek zorunda kalıyor.
Kolayz Anka bu katmanı üstlenir. OpenAI uyumlu tek bir API'nin arkasında, AWS
Bedrock üzerinden çalışan bir model kataloğu sunar. Anahtarları, ölçümü, limitleri ve
faturayı Kolayz yönetir; müşteri yalnızca bir kz- anahtarı alır ve mevcut kodunu
değiştirmeden kullanmaya başlar.
| Anka olmadan | Anka ile | |
|---|---|---|
| Başlangıç | Sağlayıcı hesabı, kurumsal kart, anahtar yönetimi | Kolayz'ın verdiği tek anahtar |
| Model seçimi | Sağlayıcının model adları, sürüm değişince kod değişir | Sabit Anka adları; arkasındaki model yükselir |
| Maliyet | Sağlayıcıdan gelen ayrı fatura | Kolayz sözleşmesine dahil ya da ön ödemeli bakiye |
| Veri | Her sağlayıcı için ayrı değerlendirme | Tek çerçeve: içerik saklanmaz, işleme Frankfurt |
Kimler kullanır
- Kolayz ürünleri. Kolayz Bilge, Kolayz ClaimSense ve teknisyen destek asistanı Anka'yı bir sağlayıcı olarak seçer. Deneme ve demo çalışma alanları, müşteri hiçbir şey yapılandırmadan Kolayz'ın kendi servis anahtarıyla çalışır.
- Doğrudan API müşterileri. Kendi uygulamasını yazan kurumlar; OpenAI SDK'sını Anka adresine yöneltmek dışında bir değişiklik yapmazlar.
- Kolayz operasyon. Tüketim, marj, anomali ve limitleri yönetim konsolundan izler.
1 · Model kataloğu
Yedi model adı, iki aile: genel amaçlı kademeler ve işe özel modeller. Adlar sabittir; arkalarındaki temel model kalite ve maliyet iyileştikçe değişebilir.
| Ad | Ne için | Not |
|---|---|---|
anka-max |
En yüksek muhakeme gerektiren işler | Uzun bağlam, karmaşık analiz |
anka-analyst |
Sayısal analiz, sonuç yorumlama, anlatı yanıt | Bilge'nin anlatı aşaması |
anka-claims |
Türkçe belge muhakemesi | ClaimSense'in claim değerlendirmesi |
anka-sql |
Doğal dilden SQL üretimi | Bilge'nin sorgu aşaması |
anka-chat |
Günlük sohbet, özetleme, yazım | En ucuz sohbet kademesi |
anka-lite |
Sınıflandırma, etiketleme, yüksek hacimli küçük işler | Toplu işler için |
anka-embed |
Vektör gömme | Anlamsal arama ve indeksler |
Şu an anka-max, anka-analyst ve anka-claims istek alamıyor. Üçünün arkasındaki
temel modeller için AWS hesabımızda dakika başı işlem kapasitesi henüz tahsis edilmedi —
kullanım izni var, kapasite yok; AWS'ye talep açıldı. Adlar katalogda ve fiyat listesinde
duruyor, kapasite tanımlandığında tek bir katalog değişikliğiyle servise giriyorlar.
Bugün cevap veren adlar: anka-sql, anka-chat, anka-lite ve anka-embed.
Bir modelin arkasında ne çalıştığı gizli değil. Herkese açık modeller sayfası her Anka adının o an hangi temel modelle karşılandığını, üreticisini ve o üreticinin koşullarını listeler. Değişiklik olduğunda ad ve fiyat sabit kalır; müşterinin kodu aynı adı çağırmaya devam eder.
2 · Nasıl kullanılır
Anka OpenAI API'sini konuşur. Mevcut bir entegrasyonda değişen tek şey adres ve anahtardır.
curl https://api.anka.kolayz.com/v1/chat/completions \
-H "Authorization: Bearer $ANKA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "anka-chat",
"messages": [{"role": "user", "content": "Geçen ay kaç fatura kesildi?"}],
"stream": true
}'
Resmî OpenAI SDK'ları — Python, Node ve .NET — akış (streaming), gömme ve model listeleme dahil olduğu gibi çalışır. Bunu her sürümde otomatik bir uyumluluk paketi doğrular.
from openai import OpenAI
client = OpenAI(api_key=os.environ["ANKA_API_KEY"],
base_url="https://api.anka.kolayz.com/v1")
Hatalar da tanıdıktır. invalid_api_key, rate_limit_exceeded,
insufficient_quota — SDK'ların yeniden deneme mantığı değişmeden çalışır. Hata
mesajları Türkçe, İngilizce ve Almanca döner.
3 · Anahtarlar ve limitler
- Anahtar formatı
kz-…, 256 bit. Yalnızca bir kez gösterilir, sunucuda yalnızca özeti saklanır. Kaybolan anahtar geri getirilmez, yenisi üretilir. - Döndürme (rotate) eski anahtara 24 saatlik ek süre tanır — servisi yeniden dağıtmaya yeter. İptal (revoke) anında etkilidir; sızıntıda iptal kullanılır.
- Model beyaz listesi: bir anahtarın hangi Anka adlarını çağırabileceği kısıtlanabilir.
- Adil kullanım: anahtar ve kurum düzeyinde dakikada istek, dakikada token ve aylık
token tavanı. Tavana yaklaşıldığında %80, %95 ve %100'de Kolayz'a uyarı gider; %100'de
istekler
insufficient_quotaile reddedilir. - Acil durdurma: tek anahtar, tek kurum ya da tüm trafik için, geri alınabilir bir durdurma anahtarı. İptalin aksine geri açılabilir — gece yarısı bir sorunun saldırı mı yoksa hatalı dağıtım mı olduğu belli değilken doğru araç budur.
4 · Veri ve gizlilik
İstem ve yanıt içeriği saklanmaz. Ağ geçidi yalnızca sayaç, kimlik ve tutar yazar: hangi kurum, hangi anahtar, hangi model, kaç token, ne kadar sürdü, ne kadar tuttu. Şemada içerik tutabilecek bir sütun yoktur ve bunu bir mimari test her derlemede doğrular. (Faz 2'de gelecek Anka sohbet ürünü bunun tek istisnasıdır: konuşmayı saklamak ürünün kendisidir, kurum bazlı saklama süresi ve kendi kendine silme ile.)
İşleme yeri. Kontrol düzlemi ve duran verinin tamamı AWS Avrupa (Frankfurt) bölgesindedir. Çıkarım varsayılan olarak Bedrock'ın bölgeler arası profillerinde çalışır; AWS'in şifreleme, "verinizle model eğitilmez" ve "model sağlayıcı verinize erişemez" güvenceleri her iki durumda da geçerlidir. Sözleşmesi gereken kurumlar için AB'ye sabitlenmiş yönlendirme kurum bazında açılabilir — fiyat değişmez, maliyet farkını Kolayz üstlenir.
KVKK. Bu kurguda Kolayz veri işleyen sıfatındadır. Aydınlatma metni, 2024 standart sözleşme mekanizması ve Kolayz'ı veri işleyen olarak adlandıran bir DPA gerekir; bunlar hukuk danışmanlığıyla netleştirilmektedir. Kişisel veri içeren iş yükleri bu belgeler tamamlanmadan devreye alınmaz.
ClaimSense'te durum bilinçli olarak farklıdır: orada kurulum müşteri ortamındadır ve Kolayz veri yolunda yer almaz. Anka paylaşımlı bir ağ geçididir; farkı gizlemek yerine yazıyoruz, çünkü iki ürünün KVKK karşılığı da farklıdır.
5 · Kimlik: modeller kendini Anka olarak tanıtır
Her istek, modelin önüne Kolayz'ın kimlik talimatını koyar. Model kendini Anka olarak tanıtır, üreticisi sorulduğunda Kolayz'ı söyler, başka bir asistan olduğunu iddia etmez ve yapay zekâ olduğunu inkâr etmez; temel model sorulduğunda herkese açık modeller sayfasına yönlendirir.
Bu bir temenni değil, sınanan bir kuraldır: Türkçe, İngilizce ve Almanca 19 sorudan oluşan bir kimlik test paketi ("Kimsin?", "Seni kim yaptı?", "Sen Claude musun?", "Hangi modelin üzerinde çalışıyorsun?") her katalog değişikliğinden önce koşar ve geçmeden değişiklik canlı sayılmaz.
6 · Fiyatlandırma
Katalog tek para biriminde, ABD doları üzerinden tutulur — maliyet de dolar olduğu için marj kur hareketinden etkilenmez. Türk lirası ödemelerde dönüşüm ödeme anında yapılır.
Faz 1'de kimseye fatura kesilmez. Seçilmiş müşteriler ve Kolayz'ın kendi kullanımı ücretsizdir; buna rağmen her istek için hem fiyat hem gerçek maliyet kaydedilir. Sebebi basit: neyi ne kadar verdiğimizi görmeden fiyat konuşulamaz.
| Faz 1 | Faz 2 | |
|---|---|---|
| Müşteri | Davetli, ücretsiz | Ön ödemeli bakiye ve abonelik |
| Ölçüm | Tam (fiyat + maliyet) | Aynı |
| Ödeme | Yok | Kredi kartı (Stripe / iyzico), havale |
7 · Yönetim konsolu
Faz 1'in tek arayüzü Kolayz operasyonu içindir. Parolasız giriş (e-posta + tek kullanımlık kod, isteğe bağlı iki adımlı doğrulama) ile açılır.
- Kurumlar: oluşturma, adil kullanım tavanları, yönlendirme politikası, askıya alma.
Kolayz'ın kendi iç kurumu altında servis anahtarları — demo çalışma alanlarını
fonlayan
bilge-demogibi — etiketleriyle üretilir. - Anahtarlar: üretme (tek seferlik gösterim), döndürme, iptal, limit değiştirme.
- Katalog ve fiyat: model ekleme ve temel model değiştirme (adı yazarak onaylanır), yalnızca eklenebilir fiyat listesi ve 1:3 karışımda marj önizlemesi.
- Tüketim ve marj: kurum, model, servis etiketi ve ay kırılımında; CSV dışa aktarma.
- Mutabakat: ölçülen maliyet ile AWS faturasının aylık karşılaştırması ve sapma geçmişi.
- Anomaliler: son bir saatteki harcaması kendi haftalık ortalamasının katlarına çıkan anahtar, kurum ya da servis etiketi listesi — sızmış anahtarın ilk belirtisi budur.
- Denetim kaydı: fiyat, katalog, yetki ve bakiye değiştiren her işlem, kim yaptıysa.
Konsolun tamamı — her ekran, her alan — kullanıcı kılavuzunda adım adım anlatılır; kılavuz ürünün içinden açılır ve Türkçe, İngilizce ve Almanca sunulur.
8 · Şu anki durum
Yayında (7 Eylül 2026'dan beri). Anka üretimde çalışıyor: API
https://api.anka.kolayz.com üzerinde cevap veriyor, yönetim konsolu ve kullanıcı
kılavuzu https://anka.kolayz.com adresinde, veritabanı göçleri uygulanmış, katalog ve
fiyat listesi yüklenmiş, ilk yönetici tanımlanmış ve giriş kodları Amazon SES üzerinden
gidiyor.
Hazır: OpenAI uyumlu veri düzlemi (akış dahil), yedi modelli katalog, anahtar ve kurum yönetimi, adil kullanım ve acil durdurma, ölçüm ve muhasebe kaydı, mutabakat işi, anomali tespiti, yönetim konsolu, herkese açık hızlı başlangıç ve modeller sayfaları, kimlik test paketi, SDK uyumluluk ve yük senaryoları, AWS altyapı tanımı.
Bekleyen: anka-max, anka-analyst ve anka-claims için Bedrock kapasitesinin
tahsisi (AWS'de açık talep), kimlik testlerinin üretimde koşturulması, ilk ayın gerçek
AWS faturasıyla mutabakatı ve KVKK belgelerinin hukukça onaylanması.
Faz 2 kapsamı: ödeme ve ön ödemeli bakiye, müşteri self-servis portalı, Anka sohbet arayüzü.