Yapay Zeka Asistanı ve bağlı özelliklerde sık karşılaşılan belirtiler, olası nedenleri ve çözümleri bu sayfada toplanmıştır. Tanımların nerede yapıldığı Yapay Zeka Kurulumu ve Ön Koşullar sayfasındadır. Asistanın yaptığı her model ve araç çağrısı kullanım logunda tutulur; hangi çağrının hangi sağlayıcıya gittiği, hangi aracın engellendiği oradan izlenir (bkz. Kullanım Raporu).

Sorun giderme

• Menüde Yapay Zeka Asistanı yok ya da "Güncelleme Aboneliğinizin olması gerekli" uyarısı veriyor. Neden: Güncelleme aboneliği bitmiş; yapay zeka ekranları yalnız abonelik süren lisanslarda kayıtlıdır. Çözüm: Araçlar > Lisans Kayıt ekranında Güncelleme Bitiş tarihine bakılır, abonelik yenilenir. Abonelik yeniyse lisans kaydı tazelenir.
• "Bu kullanıcının yapay zekâ kullanma yetkisi yok" uyarısı veriyor. Neden: Kullanıcının Kullanıcı Tanımları kaydında Yapay zeka kullanımı alanı Kullanamaz. Çözüm: Yetkili kullanıcı alanı Kullanabilir yapar; kullanıcı yeniden bağlanır. Tanım ekranlarına erişim ayrıca güvenlik sınıfından verilir.
• Asistandaki Sağlayıcı listesi boş. Neden: Netsim Konnektör Tanımları'nda Connector türü AI Provider olan kayıt yok ya da kayıt Aktif/Onaylandı durumunda değil. Çözüm: Tanım açılır ya da durumu düzeltilir; asistan yeniden açılır (tanımlar asistan açılırken okunur).
• "Tanımlı yapay zekâ sağlayıcı yok…" uyarısı (doküman özeti, brif, kart özeti). Neden: Oturumsuz çağrılar için aktif bir AI Provider tanımı yok. Çözüm: Yukarıdaki gibi tanım açılır; bu çağrılar Connector kodu sırasında ilk aktif tanımı kullanır.
• Cevap yerine "API key" ya da kimlik doğrulama hatası geliyor. Neden: Tanımın Api key alanı boş ya da yanlış; @AD yazılmışsa o ortam değişkeni bu bilgisayarda tanımlı değil; ağ geçidi kullanılıyorsa Servis bağlantı adresi eksik ya da yanlış. Çözüm: Anahtar ve adres denetlenir. Ortam değişkeni, Netsim'i çalıştıran kullanıcı için tanımlanıp program yeniden açılır.
• Hiç araç rozeti çıkmıyor; asistan ekranı açmıyor, veri okumuyor. Neden: Oturumun Araç kullanımı ayarı Kullanma; seçili model araç çağrısı desteklemiyor; sağlayıcı tanımının İzinli araçlar/Yasak araçlar listeleri aracı dışarıda bırakıyor. Çözüm: Araç kullanımı Onay İle Kullan ya da Onay Beklemeden Kullan yapılır; araç destekleyen bir model seçilir; listeler gözden geçirilir. Engellenen çağrılar kullanım raporunda Araç Koruması kaynağıyla görünür.
• Asistan yardım ya da firma belgesi sorularına cevap veremiyor. Neden: NetsimSystemAgent kurulu değil, eski sürüm ya da ajan oturumu açık değil; yardım havuzu ya da firma belge havuzu ajanda tanımlı değil; kullanıcının izinli belge koleksiyonu yok. Çözüm: Ajan güncel sürümle kurulur ve bağlantısı denetlenir. Ajan eski sürümse asistan sohbete devam eder, yardım sorusunda kullanıcıyı docs.netsim.com.tr'ye yönlendirir.
• Alan ve tablo soruları (veri sözlüğü) cevaplanmıyor. Neden: Veritabanı eski; veri sözlüğü görünümleri yalnız güncel sürümle yükseltilmiş veritabanında bulunur. Çözüm: Veritabanı güncel sürümle yükseltilir.
• Bilgisayar Kullanımı çalışmıyor. Neden: Oturum Yetenekler'inde Bilgisayar Kullanımı işaretli değil; 32 bit Netsim çalışıyor; Netsim penceresi ikinci monitörde. Çözüm: Yetenek işaretlenir, 64 bit Netsim kullanılır, pencere birincil monitöre taşınır.
• Sesli konuşma düğmesi hata veriyor. Neden: AI Realtime türünde aktif tanım yok ("Sesli konuşma için Netsim Konnektör Tanımları'nda türü "AI Realtime" olan aktif bir tanım gerekli…"); tanımın Parametreler sekmesinde sürücünün tanımadığı bir anahtar var ("Sesli konuşma parametresi: …", konuşma sürer); mikrofon ya da hoparlör başlatılamadı (Windows mikrofon izni, cihaz yok); anahtar ya da ağ hatası ("Sesli bağlantı kurulamadı: …"). Çözüm: Sesli Konuşma sayfasındaki tanım denetlenir; Windows ayarlarında masaüstü uygulamalarının mikrofon erişimi açılır.
• Sesli konuşmada mikrofon düğmesi çalışmıyor. Neden: Sesli konuşma açıkken yazıya dökme mikrofonu kullanılamaz; iki düğme aynı mikrofonu paylaşır. Çözüm: Önce sesli konuşma durdurulur.
• Hazır komut / menüsünde görünmüyor. Neden: Komutun kapsamı dışında kalınıyor: Aktif formlar, İşlem kodları, Kayıt tip no ya da kullanıcı sınırı o anki ekrana ve kullanıcıya uymuyor; kayıt durumu pasif; komutun türü Talimat (talimatlar menüde ve kartlarda görünmez). Çözüm: Yapay Zeka Hazır Komut Tanımları'nda kapsam ve durum denetlenir; listede yalnız o an geçerli komutlar görünür.
• Günlük brif mesajı gelmiyor. Neden: Görevin veri sorgusu boş sonuç döndü (veri yoksa brif bilerek üretilmez); alıcı kullanıcı adı yanlış; mesaj grubunun adında "Brif" geçmiyor (asistanın "Günün brifi" kartı bu ada bakar); model boş cevap döndü (görev hata verir). Çözüm: Zamanlanmış Görev Tanımları'nda görevin sorgusu, alıcıları ve mesaj grubu denetlenir.
• Kullanım raporunda token değeri 0. Neden: Sağlayıcı o çağrı için sayaç vermiyor (oturumsuz çağrılar), uzak A2A ajanı çağrısı (token'ı karşı taraf harcar) ya da gerçek zamanlı sesli konuşma. Çözüm: Bir hata değildir; ölçüm yalnız sohbet cevaplarında tamdır.
• Uzak A2A ajanı hiç çağrılmıyor ya da yersiz çağrılıyor. Neden: Ajan tanımındaki Açıklama zayıf; model ajanı çağırıp çağırmama kararını yalnız bu metne bakarak verir. Çözüm: Yapay Zeka A2A Uzak Ajan Tanımları'nda açıklamaya ajanın ne işe yaradığı ve hangi soruların ona yönlendirileceği açıkça yazılır. Tanım değişikliği asistan yeniden açılınca geçerli olur.
• Tanım değiştirildi ama asistan eski davranıyor. Neden: Sağlayıcı, A2A ajanı ve MCP sunucusu tanımları asistan açılırken okunur; hazır komutun Ek sistem promptu yalnız yeni oturumda etkilidir (mevcut oturumun yönergesi oturum açılırken dondurulur). Çözüm: Asistan kapatılıp açılır; sistem yönergesi değişiklikleri için Yeni Chat ile yeni oturum açılır.

Bilinen sınırlar

• Oturumsuz çağrılarda (doküman özeti, brif, kart özeti) yalnız istem, cevap ve toplam token kaydedilir; düşünme ve önbellek sayaçları yalnız asistan sohbetlerinde vardır.
• Hazır komutlarda Aktif formlar çoklu seçilebilir, ancak aynı komutu farklı kayıt tipiyle (dinamik form) kullanmak için ayrı kayıt gerekir.
• Uzak A2A ajanlarıyla tek soru/tek cevap akışı vardır; çok turlu görev, akış (streaming) ve anlık bildirim desteklenmez. Netsim dışarıya ajan olarak açılmaz; dışarıdaki bir ajan Netsim'e soru soramaz.
• Sesli konuşmada araç koruması devrede değildir; birden çok ses tanımı arasından seçim yoktur (ilk aktif tanım kullanılır).
• Doküman özetinde görsel ya da PDF yalnız seçili modelin görsel girdi desteği varsa çalışır; program bunu önceden denetlemez.
• Fiyat/maliyet çevrimi ve kota denetimi yoktur; yalnız model başına token ölçümü yapılır.
• Yetki sınırlaması için sağlayıcı tanımındaki araç listeleri ve oturumun Araç kullanımı ayarı kullanılır; serbest SQL çalıştıran aracı yalnız yetkili kullanıcılara açık bırakmak yöneticinin sorumluluğudur.