SymDevAI
Adım adım okul kurulumu PDF
Okul laboratuvarı

Sorunlar ve çözümleri

Okul laboratuvarına kurulumda ve derslerde karşılaşılabilecek durumlar. Sorununuzun başlığına tıklayın; çözüm adım adım açılır. Burada bulamadığınız bir durum için k12@symdevai.com adresine yazın.

Okul ağı ve izin verilmesi gereken adresler

Okul ağları (ör. MEB filtresi) bazı adresleri engelleyebilir. Kuruluma başlamadan önce BT sorumlusunun aşağıdaki adreslere izin vermesi, sahada yaşanan sorunların çoğunu baştan önler.

Ne için?Adresler
SymDevAIsymdevai.com
Yapay zekâ (Google AI Studio) ve Google girişiaistudio.google.com · accounts.google.com · drive.google.com
Chrome sürücüsü (ilk açılışta ve Chrome her güncellendiğinde)googlechromelabs.github.io · storage.googleapis.com
Arduino derleyicisi ve kart paketleri (robotik dersler)downloads.arduino.cc · github.com · objects.githubusercontent.com · raw.githubusercontent.com · arduino.esp8266.com
Bu izinler kalıcı olmalıChrome kendini düzenli olarak günceller. Her büyük güncellemede SymDevAI yeni Chrome sürücüsünü internetten indirir. Sürücü adresleri engelliyse kurulum günü sorun çıkmasa bile birkaç hafta sonra aşağıdaki hatalar görülebilir.

Chrome sürücüsü (“Failed to initialize AI Engine”)

SymDevAI, yapay zekâ penceresini açmak için Chrome'un sürümüne uygun bir Chrome sürücüsü kullanır. Sürücü ilk açılışta ve Chrome her güncellendiğinde internetten kendiliğinden iner. Okul ağı bunu engellerse aşağıdaki iki hatadan biri çıkar.

“Unable to obtain: chromedriver … error sending request for url (googlechromelabs.github.io …)”
Failed to initialize AI Engine. Reason: Unable to obtain: chromedriver, error Command failed with code: 65 … error sending request for url (https://googlechromelabs.github.io/chrome-for-testing/…)

Neden: Bilgisayar Chrome sürücüsünü indiremedi; okul ağı sürücü adreslerini engelliyor.

Kalıcı çözüm: BT sorumlusu googlechromelabs.github.io ve storage.googleapis.com adreslerine izin verir. Ardından SymDevAI'yi kapatıp açın.

Hızlı çözüm (izin hemen verilemiyorsa):

  1. SymDevAI'yi kapatın.
  2. Bilgisayarı bir kez başka bir ağa bağlayın (ör. telefonun mobil erişim noktası).
  3. SymDevAI'yi açın; sürücü birkaç saniyede iner ve yapay zekâ penceresi açılır.
  4. SymDevAI'yi kapatıp bilgisayarı yeniden okul ağına bağlayın. İnen sürücü bilgisayarda saklanır.

Bu hızlı çözüm, Chrome bir sonraki büyük güncellemesini alana kadar geçerlidir. Kalıcı çözüm adreslere izin verilmesidir.

“session not created: This version of ChromeDriver only supports Chrome version …”
session not created: This version of ChromeDriver only supports Chrome version 148 Current browser version is 156.0…

Neden: Chrome güncellendi, ama bilgisayarda kayıtlı eski sürücü yeni Chrome ile çalışmıyor ve yenisi okul ağı yüzünden indirilemedi.

Çözüm:

  1. SymDevAI'yi kapatın.
  2. Dosya Gezgini'nin adres çubuğuna %USERPROFILE%\.cache yazıp Enter'a basın ve içindeki selenium klasörünü silin. (Bu klasör yalnızca eski sürücüyü tutar; silmek güvenlidir.)
  3. Bilgisayarın sürücü adreslerine erişebildiğinden emin olun: adreslere izin verilmiş olmalı ya da yukarıdaki hızlı çözümdeki gibi bir kez mobil ağa bağlanmalı.
  4. SymDevAI'yi açın; Chrome'a uygun yeni sürücü iner.
Başka klasör silmeye gerek yok.symdevagent ve .symdevagent_selenium klasörlerini silmek bu hatayı çözmez. Silinirse kurum Google hesabıyla girişin ve Arduino paketlerinin yeniden yapılması gerekir (aşağıdaki klasör tablosu).
Laboratuvardaki bütün bilgisayarlarda aynı anda çıktı

Chrome bütün bilgisayarlarda aynı gün güncellenmiş ve sürücü adresleri engellenmiş demektir. En hızlı yol BT sorumlusunun sürücü adreslerine izin vermesidir; ardından her bilgisayarda yalnızca SymDevAI'yi kapatıp açmak yeterlidir.

Öğrenci girişi

Öğrenci şifresini unuttu

Öğrenci giriş penceresinde Şifremi unuttum'a basar. Adı öğretmen bilgisayarındaki SymDevAI'nin Sınıf penceresinde sarı görünür ve size bildirim gelir.

Sınıf penceresinin Öğrenciler bölümünde Şifre sıfırla'ya basın; yeni geçici şifre listede görünür (ekranınızı yansıtırken gizlidir). Web panelinde: Yönet → Öğrenciler → kalem simgesi → Şifreyi Sıfırla. Öğrenci girince kendi şifresini belirler.

Hesap kilitlendi

Üst üste 5 yanlış şifreden sonra hesap 15 dakika kilitlenir. Sınıf penceresinin Öğrenciler bölümünde ya da web panelindeki öğrenci listesinde Kilidi aç'a basın.

Hızlı giriş kodu çalışmıyor

Kod 30 dakika geçerlidir ve yeni kod alındığında eskisi geçersiz olur. Sınıf penceresinde Yeni şifre'ye basıp Tahtaya göster ile güncel kodu yansıtın (web panelinde: Yönet → Hızlı Giriş Şifresi → Yeni Kod).

Öğrenci adını listede bulamıyor

Listede yalnızca o bilgisayara kayıtlı öğrenciler görünür. Öğrenci büyük olasılıkla başka bir bilgisayara oturmuştur; oturma planına göre kendi bilgisayarına yönlendirin. Doğru bilgisayardaysa ve ilk kez giriyorsa hızlı giriş koduyla kendini ekler. Birden çok şube varsa şube seçimini ve Adını ara kutusunu kontrol edin.

“Giriş reddedildi” veya cihaz sınırı

Bir öğrenci hesabı en fazla iki cihazda (okul ve ev) kullanılabilir. Üçüncü bir cihaz gerekiyorsa k12@symdevai.com adresine yazın.

Ders açamıyorum (“okul yetkisi gerekli”)

Okul dersi ve öğrenci hesabı açmak için öğretmen hesabına okul (LAB) yetkisi verilmesi gerekir. Okul adınızı ve görevinizi k12@symdevai.com adresine yazın.

Sınıf penceresi (dondurma, yansıtma, izleme)

Öğrenci Sınıf penceresinde görünmüyor

Sınıf özellikleri öğretmen ve öğrenci bilgisayarları arasında okul ağında yürür. Sırasıyla kontrol edin:

  1. Öğrencinin bilgisayarında SymDevAI açık ve sürümü 1.0.157 ya da üstü olmalıdır (program açılırken kendini günceller).
  2. Öğretmen bilgisayarında Sınıf penceresinin üstünde sarı şerit varsa İzni ver'e basın ve Windows onayını verin.
  3. Öğretmen ve öğrenci bilgisayarları aynı okul ağında olmalıdır. Bazı Wi-Fi ağlarında (misafir ağı, "istemci yalıtımı" açık ağlar) cihazlar birbirini göremez; BT sorumlusuna sorun.

Bağlantı birkaç saniye içinde kendiliğinden kurulur; yenilemeye gerek yoktur. Öğrencinin Google (AI Studio) girişi yapmamış olması bağlantıyı engellemez.

“İzni ver” çalışmıyor

Öğretmen bilgisayarında yönetici yetkisi yoktur. Okulun BT sorumlusu Sınıf penceresinde İzni ver'e basıp yönetici bilgileriyle bir kez onaylar. İzin yalnızca okul ağı adreslerine (10.x, 172.16–31.x, 192.168.x) ve SymDevAI'nin kullandığı portlara (TCP 47400–47425, UDP 47400) açılır. Öğrenci bilgisayarlarında izin gerekmez.

Pardus / Ubuntu: öğrencinin ekranı siyah ya da “Ekran alınamıyor · Xorg gerekli”

Bilgisayar Wayland oturumundadır; bu oturumda programlar ekranı okuyamaz ve fare/klavye dışarıdan yönetilemez. Oturumu kapatın; giriş ekranında kullanıcıya tıklayıp sağ alttaki ⚙ simgesinden Ubuntu on Xorg (Pardus'ta Xorg/X11 oturumu) seçin. Seçim bir kez yapılır, hatırlanır. Kontrol için terminalde echo $XDG_SESSION_TYPE komutu x11 yazmalıdır.

Pardus / Ubuntu: “Kontrolü al” sırasında öğrenci de fareyi kullanabiliyor

Bilgisayarda xinput aracı yoktur. SymDevAI paketi sudo apt install ./symdev-agent-latest.deb ile ya da paket kurucuya çift tıklanarak kurulursa kendiliğinden gelir. Önceden kurulmuş bilgisayarlarda bir kez sudo apt install xinput çalıştırın.

Yapay zekâ bağlantısı

Chrome penceresi Google girişi istiyor

O bilgisayarın kurum hesabı oturumu kapanmıştır. Öğretmen, laboratuvar kayıt formundaki bilgiye göre o bilgisayarın kurum Google hesabıyla 5 dakika içinde giriş yapar. Şifre öğrenciye söylenmez.

Projeler açılmıyor

Google Drive bağlı değildir. Chrome penceresinde AI Studio menüsünde History üzerine gelin; Activate Google Drive görünüyorsa tıklayıp izni onaylayın, ardından SymDevAI'yi yeniden açın.

Yapay zekâ yanıt vermiyor ya da çok yavaş

Google'ın ücretsiz kullanım sınırı dolmuş olabilir; birkaç dakika bekleyin. Sık tekrarlanıyorsa o bilgisayarda Run settings'ten Flash Lite modelini ve Low düşünme seviyesini seçin. Öğrencilere Chrome penceresini kapatmamalarını, taşımamalarını ve içinde yeni sekme açmamalarını hatırlatın.

Arduino ve robotik dersler

Arduino derleyicisi ya da kart paketleri inmiyor

Derleyici ve kart paketleri ilk Arduino projesinde kendiliğinden iner. ESP kartlarında bu birkaç dakika sürebilir; pencereyi kapatmadan bekleyin.

Uzun süre ilerlemiyorsa okul ağı Arduino adreslerini engelliyor olabilir (adres tablosu). Hızlı çözüm olarak bilgisayarı bir kez mobil ağa bağlayıp ilk derlemeyi yapın; paketler bilgisayarda saklanır.

Windows Güvenlik Duvarı izin istiyor

Erişime izin ver'e basın (yönetici izni gerekebilir). Bu izin, kartın bilgisayarda bulunabilmesi için gereklidir.

Kart görünmüyor

USB kablosunu değiştirin ya da başka bir porta takın (bazı kablolar yalnızca şarj içindir). Kart sürücüsünün (ör. CH340) kurulu olduğunu kontrol edin.

Program açılmıyor

“SymDevAI sunucusuna bağlanılamadı”

İnternet bağlantısını, bilgisayarın tarih/saat ayarını ve okul ağının symdevai.com adresine izin verdiğini kontrol edin.

“JVM Runtime Yüklenemedi” (Hata Kodu 126)

Microsoft'un sitesinden Visual C++ Redistributable (x64) paketini kurun ve SymDevAI'yi yeniden açın.

Açılış ekranı görünüp program kapanıyor

Bilgisayarı yeniden başlatıp deneyin. Sürerse %USERPROFILE%\.symdevagent\logs\last-run.log dosyasını k12@symdevai.com adresine gönderin.

Hangi klasör silinebilir?

Sorun giderirken klasör silmeden önce bu tabloya bakın. Klasörler, öğrencilerin kullandığı Windows hesabının kullanıcı klasöründedir (Dosya Gezgini'nde %USERPROFILE%).

Klasörİçinde ne var? Silinirse ne olur?
.cache\seleniumChrome sürücüsü. Silmek güvenlidir; sürücü bir sonraki açılışta yeniden iner (internet erişimi gerekir).
.symdevagent_seleniumSymDevAI'nin Chrome profili: kurum Google hesabının oturumu ve AI Studio ayarları. Silinirse o bilgisayarda Google girişi, Drive bağlantısı ve model seçimi yeniden yapılır.
.symdevagentProgram ayarları, kayıtlar, Arduino derleyicisi ve kart paketleri. Silinirse Arduino paketleri yeniden iner (ESP için birkaç dakika).
SymDev_ProjectsÖğrenci projeleri. Silmeyin; silinen projeler geri gelmez.
Kurulum klasörü%LOCALAPPDATA%\Programs\SymDevAI klasöründeki license.key dosyası bu bilgisayara kayıtlı öğrenci listesidir. Silinirse öğrencilerin o bilgisayara hızlı giriş koduyla yeniden eklenmesi gerekir.
Çözemediğiniz bir durumda k12@symdevai.com adresine yazın; okul kurulumlarında BT biriminizle birlikte uzaktan bağlanarak yardımcı oluyoruz. Kurulum adımları için Okul Kurulum Rehberi'ne, bireysel kurulum için Windows kurulum rehberine bakın.