Verdent Docs
Sorun giderme

Sık sorulan sorular

Verdent for VS Code hakkında sık sorulan sorular

Verdent'in özellikleri, yetenekleri ve kullanımıyla ilgili sık sorulan soruların yanıtları.


Başlangıç

Gelişmiş özelliklere geçmeden önce Hızlı Başlangıç kılavuzunu tamamlayın; bu kılavuz, dokümanlar boyunca karşınıza çıkan temel kavramları kapsar.


Sık karşılaşılan sorunlar (ilk 4)

Verdent for VS Code'da neden oturum açamıyorum?

En yaygın neden: Proxy yapılandırması sorunu

Çözüm:

  1. VS Code Ayarları'nı açın (macOS'ta Cmd+, veya Windows/Linux'ta Ctrl+,)
  2. "useProxy" veya "verdent.enableProxy" araması yapın
  3. Proxy ayarını açıp kapatın (mevcut durumunun tersi)
  4. Tekrar oturum açmayı deneyin

Açıklama: Kurumsal bir güvenlik duvarının arkasındaysanız proxy ayarını etkinleştirmeniz gerekebilir. Ev ağındaysanız devre dışı bırakmayı deneyin.

Ücretsiz deneme kredilerimi neden almadım?

Hata: Ücretsiz deneme kredileri alınamadı veya ücretsiz deneme erişimi reddedildi

Neden: Kayıt sırasında bir hizmet şartları ihlali tespit edildi

Çözüm: Ücretsiz deneme erişiminizle ilgili yardım için support@verdent.ai ile iletişime geçin. Destek ekibi hesabınızı inceleyip sorunu çözmenize yardımcı olacaktır.

Kaydım neden başarısız oldu?

Hata: Hesap kaydı reddedildi veya kısıtlandı

Neden: Kayıt, Verdent'in hizmet şartlarını ihlal etti ve bu da erişim kısıtlamasına yol açtı

Çözüm: Yardım için support@verdent.ai ile iletişime geçin. Destek ekibi kaydınızı inceleyip sorunu çözmenize ilişkin yönlendirme sağlayabilir.

Claude, GPT veya Gemini modellerini neden bulamıyorum?

Sorun: Model seçim menüsünde belirli yapay zeka modellerini bulamıyorsunuz

Neden: Model sağlayıcılarının konuma dayalı kısıtlamaları

Açıklama: Bazı yapay zeka modeli sağlayıcılarının (Anthropic, OpenAI, Google) bölgesel kısıtlamaları vardır ve belirli modellerin belirli coğrafi konumlarda kullanılmasını engeller. Böyle bir durumda:

  • Kısıtlanan modeller model seçim menünüzde görünmez
  • Mevcut diğer tüm modelleri kesintisiz kullanmaya devam edebilirsiniz
  • Aboneliğinize veya kredilerinize hiçbir etkisi olmaz

Mevcut modelleri kontrol edin: Bölgenizde hangi modellerin kullanılabilir olduğunu görmek için https://www.verdent.ai/regions adresini ziyaret edin

Not: Bölgesel kısıtlamalar Verdent tarafından değil, yapay zeka modeli sağlayıcıları tarafından belirlenir. Verdent bu kısıtlamaları geçersiz kılamaz.


Visual Studio Code nedir?

Visual Studio Code, Microsoft tarafından geliştirilen ücretsiz, açık kaynaklı bir kod düzenleyicidir. Birden fazla programlama dilini destekleyen, hafif ama güçlü bir geliştirme ortamıdır ve hata ayıklama, sözdizimi vurgulama, akıllı kod tamamlama ve entegre sürüm kontrolü gibi özellikler sunar. Verdent, doğrudan Visual Studio Code'a bir uzantı olarak entegre olur ve mevcut iş akışınıza yapay zeka destekli kodlama yetenekleri ekler.

Verdent for VS Code nedir?

Verdent, doğal dil sohbetleri aracılığıyla kod üretimi, yeniden düzenleme, hata ayıklama ve proje gezintisinde yardımcı olan, Visual Studio Code için bir yapay zeka kodlama asistanı uzantısıdır.

Temel yetenekler:

  • Dosya araçları aracılığıyla kod üretimi ve değişikliği
  • Özel alt aracılarla kod tabanı keşfi
  • Bash entegrasyonu aracılığıyla komut yürütme
  • Kurallar ve MCP sunucuları aracılığıyla özel genişletilebilirlik
Sistem gereksinimleri nelerdir?

Minimum gereksinimler:

  • Visual Studio Code 1.90.0 veya üzeri
  • Etkin Verdent aboneliği
  • İnternet bağlantısı

Platform desteği: macOS, Windows, Linux, WSL

Kurulumdan sonra Verdent'i kullanmaya nasıl başlarım?
  1. Verdent uzantısını VS Code marketplace'ten kurun
  2. İstendiğinde Verdent hesabınızla oturum açın
  3. Herhangi bir kod dosyası veya proje açın
  4. Chat View'ı açın ve Verdent ile konuşmaya başlayın

İlk görev önerisi: Verdent'ten proje yapınızı açıklamasını veya belirli bir dosyayı incelemesini isteyin.

Visual Studio Code sürümümü nasıl kontrol ederim?

Visual Studio Code'u açın ve HelpAbout seçeneğine gidin (macOS'ta CodeAbout Visual Studio Code). Sürüm numarası iletişim kutusunda görüntülenir. Verdent, Visual Studio Code 1.90.0 veya üzeri sürümü gerektirir.

Komut satırı üzerinden de kontrol edebilirsiniz:

code --version
Krediler nedir?

Verdent ürünleri genelinde kredilerin ortak tanımı, fiyatlandırma kademeleri ve kullanımının temelleri için Krediler ve planlar sayfasına bakın.

Kredilerim biterse ne olur?

Ortak hesap politikası ve kurtarma seçenekleri için Kredileriniz biterse ne olur sayfasına bakın.

Verdent resimlerimi harici sunuculara yükler mi?

Pano aracılığıyla yapıştırılan veya dosya yoluyla referans verilen resimler, sohbet oturumunuz içinde işlenir. Resimler kalıcı olarak saklanmaz ve yeni bir sohbet başlattığınızda temizlenir. Dosya yolu referansları, resmi yüklemeden yerel olarak okur.

Plan Mode nedir?

Plan Mode, Verdent'in dosyaları değiştirmeden veya komut yürütmeden kodu analiz ettiği, araştırma yaptığı ve ayrıntılı uygulama planları oluşturduğu salt okunur bir yürütme modudur. Bir plan oluşturduktan sonra Verdent iki seçenek sunar: Edit (değişiklik talep edip planı iyileştirmek için) veya Start Building (Agent Mode'a geçip yürütmeye başlamak için). Aracı, yürütmeden önce belirsizliği ortadan kaldırmak için açıklayıcı sorular sorabilir. Bu mod, değişikliklere geçmeden önce yaklaşımı gözden geçirmek istediğiniz karmaşık görevler için idealdir ve beklentilerinizle Verdent'in önerdiği çözüm arasında uyum sağlar.

Plan Mode dosyalarıma gerçekten kod yazar mı?

Hayır. Plan Mode kesinlikle salt okunurdur:

  • Verdent dosyaları okuyabilir, kod arayabilir ve kod tabanınızı analiz edebilir
  • Plan Mode sırasında hiçbir dosya yazma, düzenleme veya silme işlemi gerçekleşmez
  • Planlar yalnızca Chat View'da görüntülenir
  • Kod yürütme yalnızca siz açıkça onayladıktan ve Agent Mode'a geçtikten sonra başlar

Güvenlik garantisi: Plan Mode kodunuzu yanlışlıkla değiştiremez. Güvenli keşif ve strateji geliştirme için tasarlanmıştır.

Plan Mode ile Agent Mode arasında nasıl geçiş yaparım?

Geçiş, Input Box aracılığıyla anlıktır:

Plan Mode'a girmek için:

  • Input Box'ta Switch Mode düğmesine tıklayın
  • Açılır menüden Plan Mode'u seçin
  • VEYA "Switch to Plan Mode" deyin

Plan Mode'dan çıkmak için:

  • Input Box'ta Switch Mode düğmesine tıklayın
  • Açılır menüden Agent Mode'u seçin
  • VEYA bir planı inceledikten sonra Start Building'i seçin

Mod kalıcılığı:

  • Mod seçimi mevcut oturum içinde korunur
  • Yeni oturumlar varsayılan Agent Mode'da başlar
  • İstediğiniz zaman serbestçe mod değiştirebilirsiniz

Tipik iş akışı: Plan Mode → inceleme → Agent Mode → yürütme → bir sonraki karmaşık özellik için tekrar Plan Mode.

Temiz bir bağlamla yeni bir sohbeti nasıl başlatırım?

Üst çubuktaki "New Session" düğmesine tıklayın. Bu, mevcut sohbet geçmişini temizler ve Verdent'e bir sonraki göreviniz için temiz bir bağlam penceresi sağlar.

Verdent'i aynı anda birden fazla projede kullanabilir miyim?

Evet, her VS Code penceresi bağımsız çalışır. Verdent'i birden fazla projede açık tutabilirsiniz ve her biri kendi ayrı sohbet bağlamını korur.

Verdent; GitHub, GitLab, Bitbucket ve diğer Git platformlarıyla çalışır mı?

Evet. Verdent standart Git komutlarını kullanır, bu nedenle barındırma platformundan bağımsız olarak herhangi bir Git deposuyla çalışır. Pull request oluşturmak için Verdent, GitHub gerektiren gh CLI'ını kullanır, ancak diğer tüm Git işlemleri evrensel olarak çalışır.


Araçlar ve yetenekler

Verdent hangi dosya formatlarıyla çalışabilir?

Desteklenenler: Aşağıdakiler dahil tüm metin tabanlı dosya formatları:

  • Kaynak kod (JavaScript, Python, TypeScript, Java, Go vb.)
  • Yapılandırma dosyaları (JSON, YAML, TOML, XML, ENV)
  • Dokümantasyon (Markdown, HTML, LaTeX)
  • Derleme dosyaları (package.json, Makefile, requirements.txt)

Desteklenmeyenler: İkili dosyalar (resimler, videolar, PDF'ler, derlenmiş ikili dosyalar, Office belgeleri)

Geçici çözüm: İkili dosyalara kodda referans verilebilir ancak değişiklikler için harici araçlar gerekir.

Verdent en iyi hangi programlama dillerini destekler?

Mükemmel destek:

  • JavaScript, TypeScript, Python, React, Vue, Angular
  • Node.js, Go, Java/Spring, C#/.NET
  • Swift, Kotlin, Flutter

Çok iyi destek: Rust, C/C++, Ruby, R

İyi destek: PHP, Assembly, Julia

Yaygın diller, kapsamlı eğitim verileri sayesinde daha güçlü desteğe sahiptir.

Verdent dosyaları nasıl okur ve değiştirir?

Üç dosya işlemi aracı:

  • file_read: Tam dosyaları veya belirli satır aralıklarını okur
  • file_edit: Belirli metin kalıplarını değiştirir (hedefli değişiklikler)
  • file_write: Yeni dosyalar oluşturur veya dosyaları tamamen yeniden yazar

En iyi uygulama: Değişiklikler için file_edit, yalnızca yeni dosyalar için file_write kullanın.

Komut yürütme nedir?

Testleri çalıştırma, paket kurma veya derleme komutlarını yürütme gibi işlemler dahil, Verdent aracılığıyla terminal komutlarını veya kabuk betiklerini çalıştırmaktır. Komut yürütme, istenmeyen sistem değişikliklerini önlemek için çoğu İzin Modunda onay gerektirir.

Verdent terminalimde komut yürütebilir mi?

Evet, bash aracını kullanarak. Verdent terminal komutlarını şunlarla çalıştırabilir:

  • Maksimum zaman aşımı: 120 saniye (2 dakika)
  • && ile komut zincirleme
  • Çapraz platform desteği (Unix'te bash, Windows'ta PowerShell)

Güvenlik: Komutlar sizin kullanıcı izinlerinizle yürütülür. Yürütmeden önce gözden geçirmek için Manual Accept Mode'u kullanın.

Bash komutları ne kadar süre çalışabilir?

Maksimum zaman aşımı: 120 saniye (2 dakika)

2 dakikayı aşan komutlar otomatik olarak sonlandırılır. Daha uzun işlemler için şunları değerlendirin:

Alternatifler:

  • Daha küçük komutlara bölün: bash("task1") && bash("task2")
  • Daha küçük işlemlere bölün
  • Arka planda çalıştırın ve sonuçları ayrı kontrol edin
Multipass Generate-Test-Repair Cycle nedir?

Kodun kapsamlı testleri geçene kadar üretildiği, test edildiği ve onarıldığı yinelemeli bir doğrulama sürecidir. Verdent otomatik olarak testleri çalıştırır, hataları analiz eder, sorunları düzeltir ve kod doğru çalışana kadar birden fazla geçişte yeniden test eder. Bu, yalnızca öneriler değil, üretime hazır kod sunar. Her sonuç, tam olarak neyin değiştiğini gösteren ayrıntılı özetler ve kod farkları içerir.

Multipass test döngüleri, kod geçene kadar otomatik olarak kodu düzeltir ve yeniden test eder; Verdent üretime hazırlığı bu şekilde sağlar.


Alt aracılar ve yürütme

Alt aracılar nedir ve ne zaman kullanmalıyım?

Alt aracılar, belirli görevler için yalıtılmış bağlam pencerelerine sahip özelleşmiş yapay zeka aracılarıdır.

Yerleşik alt aracılar:

  • @Explorer: Kod tabanı aramaları, mimari sorular
  • @Verifier: Hızlı doğrulama kontrolleri
  • @Code-reviewer: Güvenlik ve kalite incelemeleri

Ne zaman kullanılır: Ana sohbet bağlamından tasarruf etmek için araştırma, doğrulama veya inceleme görevlerini devredin.

Özel alt aracılar nasıl oluşturulur:

~/.verdent/subagents/ içinde bir markdown dosyası oluşturun:

---
name: your-subagent
description: Purpose description
---
# System Prompt
[Behavior definition and expertise]

Kullanım senaryoları: Alana özgü uzmanlık (finans, sağlık), ekip iş akışları, teknoloji uzmanları.

Bağlam kirliliği nedir?

Bağlamdaki önceki eylemler ve bilgilerin, gelecekteki görevleri etkileyen istenmeyen davranış kalıpları oluşturmasıdır. Örneğin, kodu sürekli güncelleyip ardından dağıtıyorsanız, aracı yalnızca deneme yapıyor olsanız bile tüm kod güncellemelerini anında dağıtımla ilişkilendirmeye başlayabilir. Alt aracılar, yalıtılmış bağlam pencereleriyle çalışarak bağlam kirliliğini önler; her özelleşmiş görevin temiz bir bağlamla başlamasına olanak tanır ve farklı türdeki işler arasında çapraz kirlenmeyi engeller.

Şu anda hangi yürütme modunda olduğumu nasıl anlarım?

Verdent panelinin altındaki giriş kutusuna bakın. "Switch Permission" düğmesi mevcut modunuzu gösterir (ör. "Manual", "Auto", "Plan"). Mod değiştirmek için tıklayabilirsiniz.

Auto-Run Mode ile Manual Accept Mode arasındaki fark nedir?

Auto-Run Mode:

  • Dosya işlemleri onay olmadan otomatik yürütülür
  • Komutlar yine de izin gerektirir
  • Güvenilir kod tabanları için daha hızlı iş akışı
  • Sürüm kontrolü olan bireysel projeler için en iyisidir

Manual Accept Mode:

  • Korumalı her işlemi gözden geçirip onaylayın
  • Paylaşılan kod tabanları veya üretim için daha güvenlidir
  • Yürütmeden önce tam olarak neyin çalışacağını görün

Ayarlar veya komut paleti aracılığıyla mod değiştirin.

Güvenli işlemler nedir?

Değişiklik yapmadan yalnızca veri okuyan işlemler: dosya okumaları ve web aramaları. Bunlar Auto-Run Mode'da otomatik olarak onaylanırken, dosya düzenlemeleri ve komut yürütme güvenlik için yine de onay gerektirir.

Aynı anda birden fazla izin modu kullanabilir miyim?

Hayır, izin modları birbirini dışlar; aynı anda yalnızca BİR tane kullanabilirsiniz:

  • Manual Accept - Varsayılan, maksimum kontrol
  • Auto-Run - Güvenilir projeler için akıcı
  • Plan - Salt okunur planlama modu
  • Skip Permissions - Tam özerklik

Input Box'taki Switch Permission düğmesi aracılığıyla anında mod değiştirebilirsiniz. Çoğu kullanıcı görev bağlamına göre modlar arasında geçiş yapar (ör. karmaşık özellikler için Plan Mode, hızlı düzeltmeler için Auto-Run).

Explorer aracını mı yoksa dosyaları doğrudan yüklemeyi mi kullanmalıyım?

Ana bağlamı tüketmeden keşif ve arama görevleri için Explorer aracını kullanın. Dosyaları yalnızca değiştirmeniz gerektiğinde @-bahsetmeleriyle doğrudan yükleyin. Explorer, "şunları yapan tüm dosyaları bul..." soruları için idealdir; @-bahsetmeleri ise "bu belirli dosyayı güncelle" görevleri içindir.

Projem için özel alt aracılar oluşturabilir miyim?

Evet! ~/.verdent/subagents/ içinde özel alt aracılar oluşturun:

---
name: your-subagent
description: Purpose description
---
# System Prompt
[Behavior definition and expertise]

Kullanım senaryoları: Alana özgü uzmanlık (finans, sağlık), ekip iş akışları, teknoloji uzmanları.

Çok adımlı bir görevin ortasında Verdent'i durdurabilir miyim?

Evet. Yürütmeyi istediğiniz zaman kesebilirsiniz. Verdent üzerinde çalıştığı mevcut adımı tamamlayıp ardından durur. O ana kadarki ilerleme korunur. Yapılanları gözden geçirebilir, ayarlamalar yapabilir ve ya devam edebilir ya da farklı bir yaklaşım seçebilirsiniz.

Uzun bir görevde Verdent'in şu anda ne yaptığını nasıl anlarım?

Yapılacaklar listesini izleyin. Herhangi bir anda "devam ediyor" olarak işaretlenmiş bir öğeyle gerçek zamanlı durumu gösterir. Etkin öğe, Verdent'in şu anda tam olarak ne üzerinde çalıştığını gösterir. Tamamlanan öğeler bitti olarak işaretlenir ve bekleyen öğeler geriye kalanları gösterir.

Verdent değişikliklerimi otomatik olarak commit eder mi?

Hayır. Verdent yalnızca siz açıkça istediğinizde commit oluşturur. Değişikliklerin ne zaman commit edileceği konusunda tam kontrol sizdedir. Hazır olduğunuzda "Tüm değişiklikleri hazırla ve bir commit oluştur" demeniz yeterlidir.

Verdent sormadan uzak depolara push eder mi?

Hayır. Verdent uzak depolara yalnızca siz açıkça istediğinizde push eder. Tüm Git işlemleri (commit, push, merge, rebase) güvenlik için açık talimatınızı gerektirir.


Özelleştirme ve entegrasyon

Verdent'in davranışını ekibim için nasıl özelleştiririm?

Üç özelleştirme yöntemi:

  1. VERDENT.md: Kişisel genel tercihler (~/.verdent/VERDENT.md)
  2. AGENTS.md: Projeye özgü ekip standartları (proje kökü, sürüm kontrolü altında)
  3. plan_rules.md: Plan Mode çıktı formatı (~/.verdent/plan_rules.md)

AGENTS.md, ekip tutarlılığı için VERDENT.md'yi geçersiz kılar.

Yapılandırma değişiklikleri ne zaman geçerli olur?

Çoğu Verdent ayarı yeniden başlatma gerektirmeden hemen uygulanır:

  • İzin modları: Input Box aracılığıyla anında geçiş
  • Model ön ayarları: Bir sonraki istekte uygulanır
  • Kural dosyaları: Yeni sohbetlere uygulanır (kaydetme yeniden yüklemeyi tetikler)
  • Alt aracılar: Oluşturulduktan hemen sonra kullanılabilir
  • Klavye kısayolları: VS Code'da kaydedildikten sonra uygulanır

İstisna: VS Code uzantı ayarları (örneğin verdent.enableCheckpoints) hemen geçerli olur ancak tam uygulama için dosyaları veya oturumları yeniden açmanız gerekebilir.

MCP nedir ve nasıl kullanılır?

Model Context Protocol (MCP), Verdent'i harici araçlar ve hizmetlerle genişletir:

Yapılandırma: Settings → MCP Servers aracılığıyla ~/.verdent/mcp.json

Yetenekler:

  • Veritabanı bağlantıları (PostgreSQL, MySQL, MongoDB)
  • Bulut hizmetleri (AWS, Azure, GCP)
  • Proje yönetimi araçları (Jira, Linear)
  • CI/CD pipeline'ları (Jenkins, GitHub Actions)

Durum: MCP entegrasyon dokümanları geliştirilme aşamasında. Kurulum yardımı için support@verdent.ai ile iletişime geçin.


En iyi uygulamalar ve performans

Tüketim kalıplarını takip etmek ve iş akışınızı verimlilik için optimize etmek amacıyla User Center'da kredi kullanımını izleyin.

Token nedir?

Bağlam pencereleri için ölçü birimidir. Token'lar, yapay zeka modelinin işlediği metin parçalarını (kelimeler, kelimelerin parçaları veya karakterler) temsil eder. Bağlam sınırları karakter veya kelimelerle değil token'larla ölçülür ve tipik sohbetler binlerce token tüketir.

Bağlam penceremde neler sayılır?

Oturumunuzdaki her şey: sohbetteki tüm mesajlar, bağlama yüklenen dosya içerikleri, araç çıktıları (grep/arama sonuçları, dosya okumaları), sistem istemleri ve talimatları ve MCP sunucu tanımları. Bunların her biri toplam bağlam kapasitenizden token tüketir.

200K ile 1M bağlam pencereleri arasındaki fark nedir?

Standart modeller (Claude 4.5 Sonnet, Haiku, GPT-5, GPT-5-Codex, MiniMax-M2), çoğu görev için yeterli olan 200K token'lık bağlam pencerelerine sahiptir. Claude Sonnet 4.5, 1000+ dosyalara sahip büyük kod tabanları, karmaşık çok dosyalı yeniden düzenleme veya uzun geliştirme oturumları için genişletilmiş 1M token'lık bağlam (5 kat daha büyük) sunar. 1M bağlam, giriş 200K token'ı aştığında otomatik olarak etkinleşir veya açıkça seçilebilir.

Bağlama güvenle kaç dosya yükleyebilirim?

Sabit bir dosya sınırı yoktur; dosya boyutlarına ve toplam token sayısına bağlıdır. 200K bağlamlar için 20+ büyük dosyayı (her biri >1000 satır) yüklemekten kaçının. Mevcut görevinizle doğrudan ilgili dosyalara odaklanın. @-mentions seçici kullanın ve çok sayıda örnek dosya yüklemek yerine AGENTS.md dokümantasyonundan yararlanın. 1M bağlamla dosya seçimi çok daha az kritik hale gelir.

Bağlam sınırlarına yaklaştığımı nasıl anlarım?

Belirtiler arasında daha yavaş yanıt süreleri, birkaç saat çalışan oturumlar veya çok sayıda büyük dosyanın yüklenmesi yer alır. Oturum uzunluğunuzu ve dosya sayınızı izleyin. Performans düşüşü fark ettiğinizde, mevcut görevinizi tamamlayın, ilerlemenizi commit edin ve temiz bağlamla yeni bir oturum başlatın.

Bağlam penceresi tükenmesini nasıl önlerim?

Stratejiler:

  1. Stratejik dosya okuma: Büyük dosyalar için satır aralıkları kullanın
  2. Alt aracılara devredin: Arka plan araştırması için Explorer/Verifier
  3. Okumadan önce arayın: İlgili dosyaları belirlemek için grep_file kullanın
  4. İşlemleri bölün: Çok adımlı görevleri takip etmek için todo_update kullanın

Genel kural: 500 satırı aşan dosyalar için satır aralıkları kullanılmalıdır.

Bağlamı manuel olarak mı sıfırlamalıyım yoksa Verdent bunu otomatik mi yapar?

Bağlamı sıfırlamak için yeni bir oturumu manuel olarak başlatmanız gerekir; Verdent bağlamı otomatik olarak temizlemez. En iyi uygulama: atomik bir iş birimini tamamladıktan, test ettikten ve sürüm kontrolüne commit ettikten sonra sıfırlayın. 1M token'lık bağlamlar için sıfırlamalar çok daha seyrek gerekir.

Bağlamı sıfırlamak işimi kaybeder mi?

Hayır; bağlamı sıfırlamak yalnızca sohbet geçmişini ve bellekten yüklenen dosyaları temizler. Asıl kod değişiklikleriniz, commit'leriniz ve dosya değişiklikleriniz korunur. Güvenlik için bağlamı sıfırlamadan önce işinizi her zaman sürüm kontrolüne commit edin. Sıfırla → yeni oturum başlat → bir sonraki görevde çalışmaya devam et.

İstemlerim ne kadar belirli olmalı?

Belirsizliği ortadan kaldıracak kadar belirli olun ancak bariz ayrıntıları aşırı açıklamayın. Şunları ekleyin: tam dosya yolları, uygulama yaklaşımı, beklenen sonuçlar ve kısıtlamalar. Kötü: "Kodu düzelt" - çok belirsiz. İyi: "Geçersiz e-posta formatlarını reddetmek için ContactForm.js içindeki e-posta alanına giriş doğrulaması ekle" - net kapsam ve hedef. Tereddüt ederseniz, daha fazla belirlilik yönünde hata yapın.

@-bahsetmeleri ile otomatik dosya yükleme arasındaki fark nedir?

Verdent, istemlerde adıyla belirtilen dosyaları ve aynı dizindeki ilgili dosyaları otomatik olarak yükler. @-mentions (@filename.js) bir dosyanın bağlamda olduğunu açıkça garanti eder; bu, sıkı şekilde bağlı dosyalarla çalışırken, bir dosyadaki kalıpları başka birine uygulamak için referans verirken veya büyük kod tabanlarında otomatik algılamanın bağlamı kaçırabileceği durumlarda kritiktir. Verdent'ten "şununla aynı kalıbı izle..." demesini isterken tam kod referansı sağlamak için her zaman @-mentions kullanın.

Bir oturum sırasında her istemde proje bağlamını tekrarlamam gerekir mi?

Hayır; Verdent bir oturum içinde sohbet bağlamını korur, bu nedenle daha önce tartışılan mimari ayrıntıları veya kuralları tekrarlamanız gerekmez. Ancak kritik kısıtlamalar için veya oturumlar uzadığında (100+ mesaj), önemli bağlamı yeniden belirtin. Daha iyi yaklaşım: teknoloji yığını, kodlama standartları ve kalıplar gibi kalıcı bağlamı belgelemek için proje kuralları (AGENTS.md) kullanın; böylece bunları hiç tekrarlamanız gerekmez.

Verdent istemimi doğru anlamaz veya izlemezse ne yapmalıyım?

Yinelemeli iyileştirme kullanın: çıktıyı gözden geçirin, neyin yanlış olduğunu belirleyin, ardından bir takip isteminde düzeltmeler sağlayın. Örnek: "Doğrulama mantığı iyi ama manuel kontroller yerine Joi şema doğrulaması kullan. ProductController.js içindeki doğrulama kalıbıyla eşleştir." Ayrıca açıklama da isteyebilirsiniz: "Context API yerine neden Redux kullandın?" ardından anladığınıza göre iyileştirin. Aynı istemi tekrarlamayın; neyin başarısız olduğuna göre ayarlayın.

Normal mod yerine ne zaman Plan Mode'u kullanmalıyım?

Plan Mode'u şunlar için kullanın: büyük yeniden düzenlemeler veya mimari değişiklikler, yürütmeden önce kapsamı gözden geçirmek istediğiniz çok dosyalı değişiklikler, gereksinimlerden emin olmadığınız karmaşık görevler veya uygulamadan önce Verdent'in size açıklayıcı sorularla görüşme yapmasını istediğiniz durumlar. Şunlar için Plan Mode'u atlayın: basit, iyi tanımlanmış görevler, hızlı hata düzeltmeleri veya rutin işlemler. Plan Mode ek yük getirir ancak karmaşık işlerde maliyetli hataları önler.

Görevim için doğru model ön ayarını nasıl seçerim?

Model ön ayarını görev karmaşıklığına ve bütçeye göre eşleştirin:

Efficiency kullanın (Sonnet'ten 3,2 kat daha verimli):

  • Hızlı hata düzeltmeleri ve basit kod üretimi
  • Rutin işlemler ve yüksek frekanslı görevler
  • Hızın derinlikten daha önemli olduğu durumlar

Balance kullanın (1x temel değer) - Varsayılan:

  • Genel geliştirme ve günlük kodlama
  • Özellik uygulaması ve kod incelemeleri
  • Çoğu senaryo için dengeli performans

Performance kullanın (0,5x verimlilik, 2x maliyet):

  • Karmaşık mimari kararlar
  • Kapsamlı bağlam gerektiren büyük kod tabanları (200k+ token)
  • Sofistike hata ayıklama ve yeniden düzenleme

Pro ipucu: Çoğu kullanıcı Balance'ı varsayılan olarak tutar ve yalnızca bağlam sınırlarına ulaştığında veya derin akıl yürütme gerektiğinde Performance'a geçer.


Sorun giderme

Güvenlik duvarı veya bağlantı sorunlarını nasıl giderebilirim?

Verdent yapay zeka hizmetlerine bağlanamıyorsa şu yaygın sorunları kontrol edin:

Temel bağlantıyı test edin:

  • Etkin bir internet erişiminiz olduğunu doğrulayın
  • Giden bağlantıların çalıştığını doğrulamak için diğer HTTPS hizmetlerine erişmeyi deneyin

Kurumsal/işletme ortamları:

  • Verdent'in API uç noktalarını beyaz listeye almak için ağ yöneticinizle iletişime geçin
  • Giden HTTPS trafiğinin güvenlik duvarınızdan geçmesine izin verildiğinden emin olun
  • Proxy sunucularının API isteklerini geçirmek üzere doğru yapılandırıldığını kontrol edin
  • SSL/TLS denetimi Verdent uç noktaları için istisnalar gerektirebilir

Yaygın belirtiler:

  • Uzantı takılıyor veya zaman aşımına uğruyor gibi görünür
  • Doğru kimlik bilgilerine rağmen kimlik doğrulama hataları

Güvenlik duvarı yapılandırmasından sonra sorunlar devam ederse, beyaz listeye alınacak belirli uç nokta ayrıntıları için Verdent desteğiyle iletişime geçin.

AGENTS.md kurallarım uygulanmıyor. Neden?

Kontrol edin:

  • Konum: Dosya proje kök dizininde
  • Sözdizimi: Geçerli Markdown
  • Belirlilik: Kurallar yönlendirici olmalı ("Şunu her zaman kullan...", "Şunu yapmaya çalış..." değil)
  • Temiz test: Uygulamayı test etmek için yeni bir sohbet başlatın

Öncelik: AGENTS.md, projeye özgü davranış için VERDENT.md'yi geçersiz kılar.

'file_edit failed to find exact match' hatalarını nasıl düzeltirim?

Nedenler:

  • Metin son okumadan bu yana değişti
  • Boşluk farklılıkları (boşluk yerine sekme)
  • Dize dosyada benzersiz değil

Çözümler:

  • Mevcut içeriği almak için dosyayı tekrar okuyun
  • Benzersizlik için daha büyük bağlam dizesi sağlayın
  • Birden fazla aynı dize için replace_all=true kullanın
  • file_path'in doğru olduğunu doğrulayın
Özel alt aracım neden otomatik olarak çağrılmıyor?

Kontrol edin:

  • Konum: Dosya ~/.verdent/subagents/[name].md içinde
  • Çağırma politikası: Katı politika açık @-bahsetme gerektirir
  • YAML frontmatter: Geçerli sözdizimi
  • "When to use" yönergeleri: İstek kalıbınızla eşleşir

Test: Alt aracının çalıştığını doğrulamak için açık @-bahsetme kullanın: @your-subagent do task


Ayrıca bakın