Hızlı başlangıç

Bu sayfa, ilk proje deneyiminizi uçtan uca planlamanız için sıralı bir kontrol listesidir. Her adımın altında “başarı kriteri” ve “sık takılma” notları vardır. Ayrıntılı kavramlar için Kavramlar ve mimari sayfasını okuyun.

Ön koşullar

Gereksinim	Neden önemli?
Geçerli Cere Insight 2.0 hesabı (kayıt veya davet)	Middleware korumalı rotalar oturum ister
Tarayıcıda uygulama URL’si	Örn. dağıtımınızdaki https://…
API’nin erişilebilir olması	NEXT_PUBLIC_API_URL istemciyi doğru backend’e bağlar
(Canlı için) Mesajlaşma ortamı ve API kimlik bilgileri	Gelen kutusu bağlantısı org veya ortam düzeyinde yapılandırılır

Roller: Yeni proje oluşturma çoğu kurulumda ORG_ADMIN gerektirir; üyeler (MEMBER) düzenleyebilir ama oluşturamayabilir — kurumsal politikanız API ile uyumlu olmalıdır.

Adım 1 — Hesap ve organizasyon bağlamı

1. Giriş veya Kayıt ekranından oturum açın (/login, /register).
2. Birden fazla org üyeliğiniz varsa üst bölümdeki organizasyon seçici ile doğru kiracıyı seçin; bu seçim X-Organization-Id başlığını belirler.
3. Oturum sonrası ana kabuk görünmeli: sol menüde Ana sayfa, Projeler vb.

Başarı kriteri: Dashboard yüklendi; ağ sekmesinde API isteklerinde Authorization ve X-Organization-Id görünüyor.

Sık takılma: Sayfa sürekli /login’e atıyorsa çerezde access_token oluşmadığını kontrol edin; tarayıcı Gizli mod veya agresif izleme engelleme çerezleri silebilir.

Adım 2 — İlk proje

1. Projeler menüsüne gidin (/projects).
2. Yeni proje oluşturun: ad, kısa açıklama, ana system prompt (ajanın tonu ve kuralları burada başlar).
3. LLM ayarları (model, sıcaklık, token tavanı) abonelik planınızdaki allowedModels listesine uymalıdır; aksi halde kayıt reddedilir veya çalışma anında hata alırsınız.

Başarı kriteri: Proje kartı listede görünüyor; detaya (/projects/[id]) girdiğinizde tahta veya proje ayarları açılıyor.

Sık takılma: “403 Forbidden” — org üyeliği rolünüz yetersiz veya süper yönetici olarak org bağlamı yok. Bkz. Kimlik doğrulama.

Adım 3 — Ajanları tanımlayın

1. Proje içinde en az bir ajan oluşturun: görünen ad, system prompt.
2. Çoklu uzman senaryosu planlıyorsanız bir router ajanı ekleyin: routing açıklaması net olmalıdır ki model doğru dala ayırabilsin.
3. Öncelik / sıra alanları varsa çakışan router kuralları için bunları dokümante edin (ekip içi not).

Başarı kriteri: Ajan listesi proje ayarlarında görünür; tahtaya sürüklenebilir veya listeden eklenebilir (ürün sürümüne göre).

Bkz. Ajanlar.

Adım 4 — Bilgi tabanı (önerilir)

1. Bilgi tabanları (/knowledge-bases) üzerinden yeni taban yaratın.
2. PDF / metin / Office dosyalarını yükleyin; embedding işleminin COMPLETED olmasını bekleyin.
3. Projede bu tabanı kullanacak araç veya tahta bilgi tabanı düğümünü bağlayın.

Başarı kriteri: Test modunda soru sorulduğunda yanıt kaynak parçalarından besleniyor (ürün içi gösterim varsa) veya en azından halüsinasyon oranı azalıyor.

Bkz. Bilgi tabanları.

Adım 5 — Araçlar ve entegrasyonlar

1. Harici REST servisiniz varsa API entegrasyonu tanımlayın (base URL, kimlik).
2. Araç oluşturup uygun ajana bağlayın (link).
3. Kimlik bilgilerini asla istemci tarafında düz metin paylaşmayın; mümkünse backend proxy veya güvenli depolama kalıplarını kullanın — platform özellikleri API entegrasyonları sayfasında özetlenir.

Başarı kriteri: Test modunda model, uygun bağlamda aracı çağırıyor ve HTTP hataları anlamlı geri bildirimle geliyor.

Adım 6 — Tahta (Board)

1. Proje detayında tahta görünümüne geçin.
2. Düğümleri yerleştirin: ör. Router → Uzman Ajan → Bilgi tabanı aracı.
3. Kenarları çekerek akışı tamamlayın; bir düğüm seçildiğinde sağ detay paneli ayarları gösterir.
4. Kaydet / otomatik kayıt davranışını doğrulayın (ürün sürümüne göre).

Sık takılma: Tahta “boş” görünüyorsa API’den gelen grafik yüklenmemiş olabilir; tarayıcı konsolunda 401/403 arayın.

Adım 7 — Test modu

1. Test modu panelini açın (proje bağlamında).
2. Gerçek kullanıcı gibi mesajlar gönderin; hangi ajan / hangi araç tetiklendiğini gözlemleyin (ürün vurgulama özelliği varsa renkli highlight).
3. Hatalı dallanmayı düzeltmek için router açıklamasını veya düğüm bağlantılarını güncelleyin.

Bkz. Proje yönetimi — Test modu.

Adım 8 — Canlı sohbet (ops ekibi)

1. Canlı mesajlaşma bölümünde gelen kutusu oluşturun (kanal tipi: web, e-posta, WhatsApp…).
2. Projeyi gelen kutusuna bağlayın ve canlı ajan atamasını yapın.
3. Widget snippet’ini web sitenize gömün veya kanalı test kullanıcısı ile doğrulayın.

Bkz. Canlı sohbet ve mesajlaşma.

Adım 9 — AI Builder (isteğe bağlı)

Doğal dil ile proje oturumu açmak için AI Builder panelini kullanın. Uzun oturumlarda ara sıra tahtayı manuel doğrulayın — otomatik öneriler her zaman üretim kalitesinde olmayabilir.

Bkz. AI Builder.

Sonraki adımlar

• Proje yönetimi — panel sökümü ve günlük iş akışı
• Orkestrasyon — olay bazlı iş akışları
• API: Projects — CI/CD veya iç otomasyon