SemAgent5 dakikada yayında
Bu rehberin sonunda sitenizde, bilgi tabanınızdan kaynak göstererek cevap veren bir widget çalışıyor olacak. Kod bilgisi yalnız embed adımında (kopyala-yapıştır) gerekir.
SemAgent nedir?
SemAgent, aynı asistanı iki yüzeyde çalıştırır ve ikisi de aynı bilgi tabanını kullanır:
- Sitenizdeki widget — ziyaretçilerinize, sitenizden ve dokümanlarınızdan kurulan bilgi tabanıyla, kaynak göstererek cevap verir.
- Panel sohbeti — siz ve ekibiniz kendi içeriğinize soru sorarsınız; ziyaretçiye kapalıdır.
Bu rehber widget'ı kurar. Devamı: Sohbetler ekranı ve insana devir.
Quickstart: Widget'ı kur (5 dk)
Shopify mağazanız mı var? SemAgent'ı Shopify App Store'dan kurun: Shopify'dan gelen kayıtta kart istenmez, balonu kod yapıştırmadan temanızın Uygulama yerleştirmeleri'nden açarsınız. Adımlar: Shopify & e-ticaret.
1. Hesap açın ve bilgi tabanını başlatın
- semagent.ai/register adresinden ücretsiz deneme hesabınızı açın (7 gün, 250 kredi — kart gerekli, deneme sonunda otomatik ücretlendirilir, istediğiniz an iptal).
- Panelde İçerik → Tarama'ya gidin ve Site ekle kutusuna site adresinizi yazın.
- Bul ve ekle'ye tıklayın. Sitemap'iniz otomatik bulunur ve ilk tarama başlar; forumunuz varsa motoru (Discourse, phpBB, XenForo, vBulletin, inSided) otomatik algılanır.
Tarama sürerken devam edebilirsiniz — sayfalar indexlendikçe widget'ın bilgisi genişler. Ayrıntı: Bilgi tabanı oluşturma.
2. Embed kodunu sitenize ekleyin
Panelde Yayın → RAG Widget ekranındaki Yerleştirme kodu kutusundan kodu kopyalayın (hesabınızın kimliği kodda hazır gelir) ve 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
- Sitenizi yenileyin — sağ altta widget balonu görünür.
- Sitenizde cevabı olan bir soru sorun → kaynaklı cevap gelir.
- Sitenizde cevabı olmayan bir soru sorun → widget uydurmak yerine bilmediğini söyler. Bu, strict-KB grounding'in çalıştığını gösterir.
Bu kadar — widget'ınız yayında. Asistan adı, ton, renk ve karşılama için: Widget kurulum & persona.
Temel kavramlar
| Kavram | Anlamı |
|---|---|
| Tenant | Sizin izole çalışma alanınız — bilgi tabanı, widget, kanallar ve ekip üyeleriniz burada yaşar. |
| Bilgi tabanı (KB) | Taranan sayfalar + yüklenen dokümanlardan oluşan, anlamsal aranabilir içerik havuzu. |
| Strict-KB grounding | Widget'ın yalnız KB'den, kaynak göstererek cevap vermesi; eşik altında "bilmiyorum" davranışı. |
| Connector | Google Drive, Notion, Zendesk ya da veritabanınıza salt-okuma bağlantı; kimlik bilgileri şifreli kasada. |
Sonraki adımlar
- Bilgi tabanı oluşturma — crawl kaynakları, forum, dosya, kalite döngüsü.
- Widget Chat API — kendi arayüzünüzü kurmak için.