Sorun giderme

Bir şey beklediğiniz gibi çalışmıyorsa büyük olasılıkla aşağıdakilerden biridir.

Widget sitede görünmüyor

• Embed kodundaki data-tenant-id panel → Widget → Kurulum'daki değerle birebir aynı mı?
• Script </body>'den önce mi ve URL https://semagent.ai/static/widget.js mi?
• Panelde widget aktif mi? (403 = asistan pasif)

Widget "bilmiyorum" diyor ama cevap sitede var

• O sayfa gerçekten indexlenmiş mi? Crawl-log'da arayın; atlandıysa sebep yazar (filtre, robots, boş içerik).
• Sayfa yeni eklendiyse yeniden tarama bekliyor olabilir — elle indexleyin.
• Soru başka kelimelerle sorulunca buluyorsa, o başlık için otomatik SSS'e düzenlenmiş bir soru-cevap ekleyin.

Crawl beklediğimden az sayfa aldı

• Kaynak sayfa-limitine takılmış olabilir; limiti yükseltin.
• URL filtresi fazla dar olabilir; deseni kontrol edin.
• Bot koruması varsa stealth devreye girmiştir ama bazı sayfalar yine engellenebilir — log'da görünür.

Ajan görevi yarıda kaldı / araç hata verdi

• Ajan sebep uydurmaz: hata mesajındaki teşhis notunu okuyun (sağlayıcı limiti, boş sonuç, yetki).
• Çok-adımlı görevler kaldığı yerden devam edebilir; aynı aksiyon iki kez çalışmaz (idempotency).
• Onay kartı bekliyorsa görev "takılı" değildir — kartı yanıtlayın.

Limit doldu

Limitler sert tavandır: dolunca yeni istek durur, ek ücret oluşmaz. Panel → Kullanım'dan durumu görün; planı yükselttiğiniz an devam eder. Widget müşterinize hata değil, zarif bir yönlendirme gösterir.