5 dakikada yayında

Bu rehberin sonunda: sitenizde bilgi tabanınızdan cevap veren bir widget ve ilk görevini tamamlamış bir ajanınız olacak. Kod bilgisi yalnız embed adımında (kopyala-yapıştır) gerekir.

SemAgent nedir?

SemAgent iki üründen oluşan tek bir platformdur:

• RAG Widget — sitenizden ve dokümanlarınızdan kurulan bilgi tabanıyla, ziyaretçilere kaynak göstererek cevap veren chat widget'ı.
• AI Agent — e-posta, takvim, Drive, veritabanı ve Shopify gibi sistemlerde işleri sizin adınıza (ve onayınızla) yürüten ajan.

İkisi aynı bilgi tabanını paylaşır: widget'a öğrettiğiniz her şeyi ajan da bilir.

Quickstart: Widget'ı kur (5 dk)

1. Hesap açın ve bilgi tabanını başlatın

1. semagent.ai/register adresinden ücretsiz deneme hesabınızı açın (7 gün, 250 kredi — kredi kartı istenmez).
2. Panelde Bilgi Tabanı → Kaynak Ekle'ye gidip site adresinizi girin.
3. Taramayı Başlat'a tıklayın. Sitemap'iniz otomatik bulunur; forumunuz varsa motoru (Discourse, phpBB, XenForo, vBulletin, inSided) otomatik algılanır.

2. Embed kodunu sitenize ekleyin

Panelde Widget → Kurulum'dan tenant kimliğinizi alın ve şu tek satırı sitenizin </body> etiketinden hemen önce yapıştırın:

<script src="https://semagent.ai/static/widget.js"
        data-tenant-id="sirket-slug" defer></script>

// app/layout.tsx
import Script from "next/script";

<Script src="https://semagent.ai/static/widget.js"
        data-tenant-id="sirket-slug"
        strategy="lazyOnload" />

// Görünüm → Tema Düzenleyici → footer.php
// (veya bir "header/footer script" eklentisi)
<script src="https://semagent.ai/static/widget.js"
        data-tenant-id="sirket-slug" defer></script>

3. Test edin

1. Sitenizi yenileyin — sağ altta widget balonu görünür.
2. Sitenizde cevabı olan bir soru sorun → kaynaklı cevap gelir.
3. Sitenizde cevabı olmayan bir soru sorun → widget uydurmak yerine bilmediğini söyler. Bu, strict-KB grounding'in çalıştığını gösterir.

Quickstart: İlk ajan göreviniz

Ajan, paneldeki Ajan sekmesinden konuşarak çalışır — ayrı kurulum gerektirmez. İlk görev için bilgi tabanınız yeterlidir; connector'lar isteğe bağlıdır.

1. Otonomi seviyenizi seçin

Ajan → Ayarlar → Otonomi: yeni başlıyorsanız Denetimli kalın — okuma ve taslak işleri otomatik yürür, gönderme/yazma aksiyonları onayınıza düşer.

2. İlk görevi verin

Bilgi tabanımızdaki iade ve kargo koşullarını özetleyen,
müşteriye gönderilebilir kısa bir doküman hazırla.

Ajan kb_search ile bilgi tabanını tarar, doc_generate ile Word dokümanı üretir. İkisi de okuma/taslak (T1) sınıfında olduğundan onay gerekmez — sonuç birkaç dakikada artefakt olarak iner.

3. Bir aksiyonu onaylayın

Bu dokümanı e-postayla bana gönder.

E-posta göndermek T2 (aksiyon) katmanındadır: ajan taslağı hazırlar ve bir onay kartı gösterir. "Onayla" dediğinizde gönderilir. Onay akışını burada ilk kez görmüş oldunuz — ajan güvenlik modelinin kalbi budur.

4. (Opsiyonel) Görevi zamanlayın

Her pazartesi 09:00'da bilgi tabanına yeni eklenen
içerikleri özetleyip bana e-posta ile gönder.

Ajan schedule_task ile görevi zamanlar; Ayarlar → Zamanlanmış Görevler'de görünür, sohbetten iptal edilebilir.

Temel kavramlar

Sonraki adımlar

• Bilgi tabanı oluşturma — crawl kaynakları, forum, dosya, kalite döngüsü.
• Ajan araç referansı — 50+ aracın tamamı, risk sınıfları ve onay davranışı.
• Widget Chat API — kendi arayüzünüzü kurmak için.