Sorun giderme ve sık sorulan sorular

Önce başarısız olan işleme ait mesajı okuyun; ardından proje, ajan ve görev durumunu kontrol edin. Aşağıdaki bölümler yaygın sorunlar için doğru yere yönlendirir.

Kurulum çalışma alanına geçmenize izin vermiyor

İlk kurulum, en az bir ajanın kurulmasını, oturumunun açılmasını ve doğrulanmasını gerektirir. Yalnızca kurmak veya oturum açma penceresini kapatmak yeterli değildir: listede Ready (Hazır) görünmelidir.

İlgili ajanın ayrıntılarını açın, oturum açma, ağ veya doğrulama sorunlarını giderip yeniden kontrol edin. Kurulum ve hazırlık bölümüne bakın.

İndirme başarısız oluyor veya hazırlıkta kalıyor

Önce ağı ve sistemin HTTP(S) proxy'sini kontrol edin. Proxy ortam değişkenleri önceliklidir; bu mekanizma SOCKS proxy'lerini desteklemez. İndirme veri almayı bıraktığında hazırlık durumu görünebilir. Güncellemeleri izleyin; hata bildirilirse yeniden deneyin.

Hatalar yinelenirse ajanın tanılama bilgilerini kopyalayın ve sorunun çalışma zamanı bileşeni indirilirken, ajan kurulurken mi yoksa bağlantı doğrulanırken mi oluştuğunu not edin.

Oturum açıldı ama ajan hâlâ kullanılamıyor

Noea, ajanın hazır olup olmadığına doğrulama sonuçlarına göre karar verir. Hesabı veya sağlayıcıyı, kullanılabilir kotayı ve model yapılandırmasını kontrol edin. OpenCode için sağlayıcı listesini yenileyin, bağlantıyı doğrulayın ve yeniden kontrol edin.

Model seçimi önce bağlantı gerektiriyorsa bir oturum bağlayıp yeniden kontrol edin. Bir ajanın desteklediği ayar başka ajan tarafından otomatik olarak desteklenmez.

Proje açılmıyor

Durum	Yapılacak işlem
Seçilen klasör bir Noea projesi değil.	Kod için Open Implementation Folder kullanın veya mevcut bir proje için gerçek proje klasörünü seçin.
Proje klasörü taşındı.	Open Existing Noea Project ile yeni konumunu seçin.
Proje klasörü silindi.	Yeniden açmadan önce Çöp Kutusu'ndan veya yedekten geri yükleyin.
Yapılandırma geçersiz.	Özgün içeriği koruyun. Yapılandırmayı inceleyin veya tanılama bilgilerini gönderin; projeyi yeniden başlatarak üzerine yazmayın.
Verileri uygulamanın daha yeni sürümü yazdı.	Uygulamayı güncelleyip yeniden açın.
Veri sürümü uyumsuz.	Proje ve uygulama verilerinin kopyalarını saklayın, ardından ilgili mesajdaki adımları izleyin. Uyumsuz verilerin üzerine yazmayın.

Niyet okunuyor ama sohbetler başlamıyor

Settings → Current Project → Project (Ayarlar → Geçerli Proje → Proje) bölümündeki uygulama klasörünü kontrol edin. Bağlı klasör yoksa bağlayın; eski yola erişilemiyorsa özgün kod klasörünü yeni konuma taşıyın.

Ajanın da Ready (Hazır) durumunda olduğunu kontrol edin. Niyet dosyalarının okunabilmesi uygulama klasörünün ve ajanın da hazır olduğu anlamına gelmez.

Açıklama eksik veya yanlış görünüyor

Niyeti kaydedin, ardından ilgili paragrafı araştırın veya kenar çubuğundan Explain (Açıkla) çalıştırın. Gereksinim kod değişikliği gerektiriyorsa araştırmadan önce sohbette uygulayın.

Previous text (Önceki metin) düzenlemeden önceki niyete başvurur. May be outdated (Güncelliğini yitirmiş olabilir), destekleyici dosyaların daha sonra değiştiği anlamına gelir. İkisini de geçerli içerikle yeniden karşılaştırın; Açıklamaları güncel tutma bölümüne bakın.

Kenar çubuğundaki No changes found (Değişiklik bulunamadı), tüm testlerin geçtiği veya hiç eksik kalmadığı anlamına gelmez.

Uygulamadan sonra Explain çalışmadı

Settings → Current Project → Automation → Explain automatically after implementing (Ayarlar → Geçerli Proje → Otomasyon → Uygulamadan sonra otomatik açıkla) ayarını kontrol edin. Normal sohbetlerdeki yalnızca kod değişiklikleri, Implement Directly ve başarısız ya da durdurulmuş uygulama çalışmaları bunu tetiklemez.

Gerektiğinde Explain'i elle çalıştırın. Görev bitmiş olmasına rağmen başarısız veya tamamlanmamış kontroller bildiriyorsa sonuçları genişletin, nedeni giderin ve yeniden çalıştırın. Otomatik tetikleme kurallarının tamamına bakın.

Öneri veya düzenleme planı kabul edilemiyor

Öneri belgenin değiştiğini söylüyorsa Ask Agent to Re-propose on Current Version (Ajanın Geçerli Sürüm İçin Yeniden Önermesini İste) seçin. Güncelliğini yitirmiş düzenleme planı için Reorganize (Yeniden Düzenle) seçin.

Normal öneriler eklenen veya değiştirilen metni düzenlemenize izin verir; ancak tek tek değişiklikleri veya dosyaları kabul etmeyi desteklemez. Düzenlenmiş taslaklar salt okunurdur; tüm planı kabul etmeden önce silinmesi önerilen içerikleri korumayı seçebilirsiniz.

Başarısız mesajı yeniden göndermeli misiniz?

Noea mesajın ajana ulaşmadığını söylüyorsa yeniden deneyebilirsiniz. Ulaşmış olma ihtimali varsa yinelenen yürütmeyi önlemek için önce izi ve dosya değişikliklerini inceleyin.

Ajan mesajı almış ama görevin ortasında durmuşsa geçerli durumu kontrol edip devam etmesini isteyen yeni bir yönerge gönderin. Implementation not finished (Uygulama tamamlanmadı) işaretli öneri kartında Continue Implementing (Uygulamaya Devam Et) seçeneği de vardır.

Mesajı düzenlemek, sohbeti dallandırmak veya çalışmayı durdurmak dosya değişikliklerini geri almaz.

MCP sunucusu veya Skill etkili olmuyor

MCP için Test Connection (Bağlantıyı Test Et) kullanın; sonucun belirttiği komutu, URL'yi, yetkilendirmeyi ve ortam değişkenlerini kontrol edin. Test başarılı olsa bile sohbette sunucunun seçili olduğunu ve ajanın bağlantı yöntemini desteklediğini doğrulayın.

MCP yapılandırma değişiklikleri ajanın yeniden bağlanmasını gerektirir. Skill eklemek veya kaldırmak için yeni sohbet gerekir. Explain ve düzenleme görevleri bu uzantıları kullanmaz. MCP sunucuları ve Skills ekleme bölümüne bakın.

Kaydetme başarısız veya başvuru açılmıyor

Kaydetme çakışması, siz düzenlerken başka bir işlemin diskteki dosyayı değiştirdiği anlamına gelir. Geçerli içeriğinizi ayrı kaydedin veya diskteki sürümü yeniden yükleyin. Yeniden yükleme kaydedilmemiş düzenlemeleri atar.

Bozuk bir başvuruda dosyanın veya materyalin hâlâ var olduğunu ve uygulama klasörüne erişilebildiğini kontrol edin. Eski bir açıklama artık belgeyle eşleşmiyorsa en güncel açıklamayı okumak için ilgili paragrafa dönün ve gerekiyorsa yeniden araştırın.

Ekibe yararlı bilgiler gönderin

Hedefinizi, gerçek sonucu ve soruna yol açan adımları anlatmak için kenar çubuğundaki Feedback (Geri Bildirim) seçeneğini kullanın. Takip için e-posta adresi bırakın veya [email protected] adresine ulaşın.

Tanılama bilgileri gerekiyorsa Settings → About (Ayarlar → Hakkında) bölümünden dışa aktarın veya ajanın ayrıntı panelinden kopyalayın. Tanılama bilgileri yerel durum ve günlükler içerebilir; paylaşmadan önce inceleyin. Geri bildirim bu dosyaları otomatik olarak eklemez.