Hoş geldiniz
Cere Insight 2.0 dokümantasyonuna hoş geldiniz. Bu rehber; sıfırdan ürünü öğrenmek, günlük operasyonu yürütmek, API ile entegre olmak ve gelişmiş AI özelliklerini kullanmak isteyen herkes için yazılmıştır.
Bu sayfadan ne almalısınız?
- 5 dakikada: Cere Insight 2.0’ın problem uzayını (ne işe yarar, ne işe yaramaz) anlamak.
- 30 dakikada: Kavramlar ve mimari + Hızlı başlangıç ile ilk proje taslağını kurmak.
- Bir günde: Tahta, bilgi tabanı, test modu ve raporlar arasında güvenle gezinmek.
Cere Insight 2.0 nedir?
Cere Insight 2.0, kurumsal ekiplerin yapay zekâ destekli sohbet ajanlarını, bilgi kaynaklarını ve operasyonel raporlamayı tek bir web arayüzünden yönetmesi için tasarlanmış bir platformdur. Ürün üç büyük fikir etrafında organize edilmiştir:
- Tanımla — Projeler, ajanlar, araçlar ve görsel tahta ile ajanların davranışını hem teknik hem görsel olarak ifade edersiniz.
- Besle — Bilgi tabanları ve harici API entegrasyonları ile ajanların erişeceği gerçek dünya verisini bağlarsınız.
- Ölç ve iyileştir — Raporlar ve analitik ajanlar ile konuşma operasyonunu ve iş verisini izlersiniz.
Ürün bir “her işi yapan sihirli kutu” değildir: kaliteli system prompt, doğru router tasarımı, güncel bilgi tabanı ve canlı ajan süreçleri birlikte başarıyı belirler.
Ana bileşenler (bir cümleyle)
- Projeler: Tek bir uçtan uca sohbet deneyimi. Ad, açıklama, varsayılan LLM ayarları ve tahta düzeniniz burada yaşar.
- Görsel tahta (Board): Düğümler ve kenarlarla akışı modellersiniz: router ve alt ajanlar, araçlar, entegrasyonlar, bilgi tabanı ve gelen kutusu bağlantıları.
- Bilgi tabanları: Belgeleri yükleyip gömme (embedding) ile aranabilir hale getirirsiniz; ajanlar RAG tarzı yanıtlar üretebilir.
- Canlı mesajlaşma: Web widget, e-posta, WhatsApp gibi kanallar; gelen kutusu üzerinden projeye bağlanır ve canlı ajanlarla eşlenebilir.
- Analitik ajanlar: İş verinize (SQL, Excel veya platform içi kaynaklar) pano ve doğal dil sorgusu ile yaklaşmanız için ayrı modül.
- Orkestrasyon: Olaylara tepki veren iş akışları (abonelikte etkin olması gerekir).
- Raporlar: Canlı mesajlaşma ve canlı ajan operasyon verisinden türetilen özetler; ayrıca kişi raporları (
/reports/users).
Bunların teknik ilişkisi için bkz. Kavramlar ve mimari.
Kimler hangi ekranı kullanır?
| Persona | Tipik günlük kullanım | İlgili dokümantasyon |
|---|---|---|
| Ürün / operasyon | Proje kartları, tahta ince ayarı, bilgi tabanı güncelleme, rapor panoları | Proje yönetimi, Bilgi tabanları, Raporlar |
| Geliştirici | API entegrasyonları, araç tanımları, webhook ve dış sistemler | API entegrasyonları, Projects API |
Org yöneticisi (ORG_ADMIN) | Üye daveti, rol atama, abonelik limitlerinin gözetimi | Organizasyon, Roller |
Süper yönetici (SUPERADMIN) | Birden çok org’un platform ayarları, mesajlaşma ortamı kayıtları | Mesajlaşma ortamı instanceları |
Rolleri karıştırmayın
Hesap rolü (USER / SUPERADMIN) ile organizasyon üyelik rolü (ORG_ADMIN / MEMBER) farklıdır. Bir kullanıcı sistemde “normal kullanıcı” olsa bile bir org’da yönetici olabilir. Ayrıntı: Kimlik doğrulama.
Tipik ilk hafta senaryosu
- Davet ile org’a katıldınız → Kimlik doğrulama.
- Dashboard’da kota kartlarını gördünüz → Dashboard.
- İlk projeyi açtınız, bir router ve iki uzman ajan eklediniz → Ajanlar.
- PDF dokümanlarını bilgi tabanına attınız, embedding tamamlanana kadar beklediniz → Bilgi tabanları.
- Tahtada ajanlara araç bağladınız, test modunda mesajlarla doğruladınız → Proje yönetimi.
- Ops ekibi gelen kutusunu bağladı, widget’ı yayına aldı → Canlı mesajlaşma.
Sık karşılaşılan ilk sorular
Süper yönetici neden proje oluşturamıyor?
Backend, proje uçlarını organizasyon bağlamı olmadan kullanıma kapatmış olabilir. Projeleri org üyesi olarak oluşturun veya kendinize test amaçlı bir org üyeliği tanımlayın. Teknik açıklama: Kavramlar ve mimari (sistem mimarisi bölümündeki süper yönetici notu).
401 alıp login’e düşüyorum — token nerede?
Middleware çerezdeki access_token’a bakar; API istemcisi Bearer + X-Organization-Id gönderir. Oturum süresi dolmuş veya org başlığı eksik olabilir. Bkz. Kimlik doğrulama.
Tahta kayıtlı görünmüyor / test modu yanıt vermiyor
Önce proje detayının kaydedildiğinden emin olun; ardından Redis / kuyruk ve backend loglarını kontrol edin (kurulum sizin sorumluluğunuzdadır). Kullanıcı perspektifinden: Test modu.
Sonraki adımlar
- Kavramlar ve mimari — sözlük ve sistem şeması
- Öğrenme yolu — önerilen okuma sırası
- Hızlı başlangıç — ilk proje taslağı
- Arayüz rehberi — menü ve kabuk