Knowentra'ya Hızlı Başlangıç

Bu rehber, çalışır durumdaki boş bir Knowentra kurulumunu ilk kullanılabilir kurumsal senaryoya dönüştürür. Yaklaşık 30–45 dakika sonunda:

• Bir organizasyon, departman ve Space oluşturmuş,
• Yerel veya izinli bir model bağlamış,
• Küçük bir bilgi tabanı hazırlamış,
• Kaynak gösteren bir agent oluşturmuş,
• Salt-okunur bir araç veya basit bir workflow eklemiş,
• Yetki, kaynak ve çalıştırma kaydını doğrulamış

olacaksınız.

Kuracağımız örnek

“İK Politika Asistanı” adlı dar kapsamlı bir senaryo kullanacağız:

1. Çalışan, izin politikası hakkında soru sorar.
2. Agent yalnızca İnsan Kaynakları Space'ine bağlı belgelerde arama yapar.
3. Yanıt, kullandığı belgeyi kaynak gösterir.
4. Çalışan izin talebi taslağı isterse agent bir taslak hazırlar.
5. Gerçek bir sisteme kayıt açılması gerekiyorsa workflow insan onayı bekler.

Bu örnek; Chat, Knowledge Hub, Agent, Workflow ve güvenlik sınırlarını tek bir küçük akışta gösterir.

---

Başlamadan önce

Şunların hazır olduğunu doğrulayın:

• Knowentra arayüzüne yönetici veya kurulum sahibi olarak erişim
• En az bir model sağlayıcısı ya da kurum içinde çalışan model endpoint'i
• Test için hassas veri içermeyen 3–10 kısa belge
• Organizasyon ve kullanıcı yapılandırma yetkisi
• İsteğe bağlı olarak salt-okunur bir test entegrasyonu

Örnek belge seti

Küçük ama cevapları birbirinden ayrılabilen belgeler hazırlayın:

izin-politikasi.pdf
uzaktan-calisma-politikasi.pdf
masraf-proseduru.docx

Belgelere test sırasında soracağınız bilgilerin gerçekten yazılmış olduğundan emin olun. Örneğin izin politikasında “yıllık izin talebi en az üç iş günü önce iletilir” gibi doğrulanabilir bir kural bulunabilir.

---

Adım 1 — Ortamın çalıştığını doğrulayın

Arayüzü açın ve oturum açın. İlk olarak şu temel kontrolleri yapın:

• Sayfalar hata vermeden yükleniyor.
• Oturum kapatılıp yeniden açılabiliyor.
• Sistem saati ve saat dilimi doğru.
• Kalıcı depolama yapılandırılmış.
• Model servisine ağ erişimi mevcut.

Kurulum henüz yapılmadıysa önce Kurulum rehberini izleyin.

Hızlı sağlık kontrolü

Bu kontrollerden biri başarısızsa sonraki adımlara geçmeden altyapı sorununu çözün. Aksi halde agent veya RAG hatası gibi görünen problem aslında temel servis problemidir.

---

Adım 2 — Organizasyon sınırını oluşturun

Yönetim alanından bir organizasyon oluşturun:

Organizasyon: Acme

Ardından bu organizasyonda bir departman oluşturun:

Departman: İnsan Kaynakları

Son olarak departman içinde çalışma alanını oluşturun:

Space: İK Politikaları
Amaç: Çalışanların onaylanmış İK politikalarında kaynaklı arama yapması

Neden doğrudan agent oluşturmuyoruz?

Space yalnızca klasör değildir. Kullanıcı, bilgi, agent, araç ve workflow kapsamının kesiştiği yetki alanıdır. Agent'ın “hangi belgeyi görebileceği” ve “hangi aracı kullanabileceği” bu bağlama göre sınırlandırılır.

İlk Space'e yalnızca test kullanıcılarını ekleyin. Genel kurum erişimini pilot tamamlandıktan sonra değerlendirin.

Ayrıntılar: Organizasyon → Departman → Space.

---

Adım 3 — Model bağlantısını hazırlayın

Kullanacağınız temel modeli seçin. Bu model:

• Kurum içinde çalışan yerel bir model,
• Özel ağdaki OpenAI uyumlu bir endpoint,
• Kurum politikasının izin verdiği harici bir sağlayıcı

olabilir.

İlk senaryoda modelden beklediğimiz yetenekler:

Modeli kaydettikten sonra hassas olmayan bir mesajla bağlantıyı test edin:

Yalnızca “model bağlantısı çalışıyor” yazarak yanıt ver.

Harici model kullanıyorsanız

Verinin hangi sağlayıcıya, bölgeye ve log politikasına gittiğini doğrulayın. LLM Secure Gateway'de bu Space için uygulanacak maskeleme ve engelleme politikasını belirleyin.

Yerel model kullanmak ağ çıkışını azaltır; kullanıcı ve belge yetkilendirmesini kendiliğinden çözmez.

---

Adım 4 — Bilgi tabanını oluşturun

Knowledge Hub'da yeni bir bilgi tabanı oluşturun:

Ad: İK Politikaları
Kapsam: İnsan Kaynakları / İK Politikaları Space

Hazırladığınız test belgelerini yükleyin. Her belge için:

• Dosya adını ve türünü
• İşleme durumunu
• Kaynak/Space kapsamını
• Varsa sürüm ve geçerlilik tarihini

kontrol edin.

İşleme tamamlanmadan agent testine geçmeyin. “Yüklendi” durumu her zaman “ayrıştırıldı ve indekslendi” anlamına gelmeyebilir.

İlk retrieval testi

Bilgi tabanı aramasında belgedeki kesin bir ifadeyi sorun:

Yıllık izin talebi kaç iş günü önce iletilmelidir?

Beklenen:

• Doğru belge bulunur.
• İlgili bölüm veya chunk döner.
• Başka Space'e ait belge sonuçta görünmez.
• Kaynak bağlantısı yetkili kullanıcı tarafından açılabilir.

Belge akışı: Belge Yükleme ve Bilgi Tabanı.

---

Adım 5 — İlk agent'ı oluşturun

Agent oluşturma alanında şu başlangıç yapılandırmasını kullanın:

Başlangıç talimatı

Sen İK Politika Asistanısın.

Yalnızca sana bağlı İK Politikaları bilgi tabanındaki kaynaklara dayan.
Her politika yanıtında kullandığın belgeyi belirt.
Kaynakta açık yanıt yoksa tahmin etme; bilginin bulunamadığını söyle.
Kullanıcı adına kayıt oluşturma, mesaj gönderme veya dış sistemde işlem yapma.
Kişisel çalışan verisi istenirse yetkili İK kanalına yönlendir.
Yanıtlarını kısa, açık ve profesyonel Türkçe ile ver.

Talimat, yetkilendirme mekanizması değildir. “Başka belgeye bakma” yazmak faydalıdır; asıl erişim engeli Space ve bilgi tabanı izinleriyle uygulanmalıdır.

Agent oluşturma ayrıntıları: Model / Ajan Oluşturma.

---

Adım 6 — Kaynaklı yanıtı test edin

Agent ile yeni bir sohbet başlatın ve üç test türü kullanın.

Pozitif test

Yıllık izin talebimi ne kadar önce iletmeliyim?

Beklenen:

• Belgede bulunan doğru kuralı açıklar.
• Kaynak belgeyi gösterir.
• Kaynakta olmayan ayrıntı eklemez.

Kapsam dışı test

Geçen ay Ahmet'in kaç gün izin kullandığını söyle.

Beklenen:

• Kişisel kayda erişmeye çalışmaz.
• Bilgi tabanında yoksa tahmin etmez.
• Uygun İK kanalına yönlendirir.

Çelişki testi

İki test belgesinde farklı sürümlere ait çelişkili kural varsa agent'ın güncel sürümü seçip seçmediğini veya çelişkiyi açıkça gösterip göstermediğini kontrol edin.

---

Adım 7 — Güvenlik politikasını doğrulayın

Test Space'inde LLM Secure Gateway politikasını açın. Sentetik bir örnekle hassas veri davranışını deneyin:

Bu metni özetle: Çalışan e-postası test.user@example.com ve test amaçlı kimlik değeri
11111111110.

Yapılandırmanıza göre beklenen sonuç:

• Hassas alan maskelenir,
• İstek uyarıyla devam eder,
• Ya da politika çağrıyı engeller.

Kontrol edin:

• Kullanıcıya anlaşılır politika sonucu gösteriliyor mu?
• Ham değer model sağlayıcı loguna gitmeden korunuyor mu?
• Audit kaydı politika ve maskeleme kararını içeriyor mu?
• Yetkili yönetici olayın kaynağını görebiliyor mu?

Detaylar: LLM Secure Gateway.

---

Adım 8 — Salt-okunur bir araç ekleyin

Bu adım isteğe bağlıdır; fakat RAG ile canlı erişim farkını gösterir.

Test ortamında yalnızca salt-okunur bir araç bağlayın. Örnek:

Araç: remaining_leave_days
Girdi: employee_id
Çıktı: remaining_days, as_of_date
Yan etki: Yok

Araç için:

• Kullanıcı veya görev odaklı credential
• Space allowlist'i
• Giriş/çıkış şeması
• Timeout ve maksimum sonuç
• Hassas alan maskesi
• Audit

tanımlayın.

Agent'ın belge sorusunda bu aracı gereksiz çağırmadığını; yalnızca güncel bakiye sorusunda çağırdığını test edin. Araç sonucu, tarihiyle birlikte gösterilmelidir.

MCP kullanıyorsanız: Araç Bağlama (MCP).

---

Adım 9 — Kontrollü bir workflow kurun

Şimdi “izin talebi taslağı” için basit bir workflow oluşturun:

Manuel tetikleyici
  → giriş şemasını doğrula
  → politikadan ilgili kuralı getir
  → AI ile talep taslağı hazırla
  → kullanıcıya önizleme göster
  → insan onayı bekle
  → test sisteminde kayıt oluştur
  → sonucu audit'e yaz

İlk çalıştırmada son “kayıt oluştur” adımını dry-run veya test hedefinde tutun.

Onay ekranında görünmesi gerekenler

• İşlemi başlatan kullanıcı
• Agent/workflow adı ve sürümü
• Hedef sistem
• Gönderilecek alanlar
• Kullanılan politika kaynağı
• Geri alınabilirlik

Onaydan sonra parametre değişirse önceki onay geçersiz olmalıdır.

Workflow kavramları: Workflow ve Space Agent.

---

Adım 10 — İzlenebilirliği kontrol edin

Tek bir test çalıştırmasını uçtan uca izleyin:

1. Kullanıcı mesajı
2. Space ve agent kimliği
3. Getirilen belge/chunk
4. Model ve talimat sürümü
5. Secure Gateway kararı
6. Araç çağrısı ve parametre özeti
7. İnsan onayı
8. Workflow sonucu
9. Hedef sistem kayıt kimliği

Ham secret veya gereksiz kişisel veri loglarda bulunmamalıdır. Buna karşılık olayın kim tarafından, hangi kaynak ve yetkiyle yapıldığı kanıtlanabilmelidir.

---

Başarı kriterleri

Hızlı başlangıcı tamamlanmış saymak için:

• Kullanıcı yalnızca üyesi olduğu Space'e erişiyor.
• Agent yalnızca bağlı bilgi tabanını kullanıyor.
• Kaynakta olmayan soruda tahmin üretmiyor.
• Kaynaklı soruda doğru belgeyi gösteriyor.
• Hassas veri politikası beklenen şekilde çalışıyor.
• Salt-okunur araç yalnızca gereken görevde çağrılıyor.
• Credential modele veya kullanıcıya açılmıyor.
• Yazma işlemi onaysız ilerlemiyor.
• Aynı olay tekrarlandığında çift kayıt oluşmuyor.
• Audit kullanıcıdan hedef sistem sonucuna kadar izlenebiliyor.
• Yetkisi kaldırılan kullanıcı yeniden erişemiyor.
• Hata kullanıcıya güvenli ve anlaşılır biçimde gösteriliyor.

---

Sık karşılaşılan sorunlar

Model listesi boş

Sağlayıcı bağlantısını, endpoint erişimini ve credential'ı doğrulayın. Modelin organizasyon veya workspace kapsamında etkin olduğundan emin olun.

Belge yüklendi ama bulunmuyor

İşleme durumunu, ayrıştırılmış metni, bilgi tabanı–Space bağını ve indeksleme hatalarını kontrol edin. Dosyanın yalnızca depolanmış olması retrieval için yeterli değildir.

Agent kaynak göstermiyor

Bilgi tabanının agent'a bağlı olduğunu, citations özelliğini ve sistem talimatını doğrulayın. Retrieval sonucunun gerçekten döndüğünü ayrı test edin.

Araç gereksiz çağrılıyor

Araç açıklamasını daraltın; ne zaman kullanılmaması gerektiğini yazın. Aracı bütün agent'lara değil yalnızca ilgili Space'e açın.

Workflow iki kez işlem yaptı

Webhook/event ID ve operasyon sürümünden idempotency anahtarı üretin. Hedef sistemde veya workflow kayıtlarında aynı anahtarı tekrar kabul etmeyin.

---

Buradan sonra

Bu rehber bir pilot sınırı kurdu. Üretime geçmeden önce sırayla:

1. Platform bileşenleri ve güven sınırlarını belgeleyin.
2. Dağıtım modelini ve veri yerleşimini onaylayın.
3. Kimlik, SSO ve kullanıcı yaşam döngüsünü tamamlayın.
4. Yedekleme, gözlemlenebilirlik ve olay müdahalesini test edin.
5. Agent ve workflow için sürümlü değerlendirme kapıları kurun.

Bir sonraki rehber: Platform Mimarisi.