Verdent Docs
Başlarken

Temel kavramlar

Verdent'in mimarisini ve temel terminolojisini anlayın

Verdent for VS Code, yapay zeka destekli geliştirmeye hassasiyet ve kontrol getirir. Geleneksel yapay zeka kodlama araçları niyetinizi tahmin eder. Verdent ise, yapay zekanın ne yapacağını çalıştırmadan önce tam olarak görmenizi, doğru çalıştığını doğrulamanızı ve her seferinde güvenilir kod teslim etmenizi sağlar.

Önce planla, erken doğrula, güvenilir kod teslim et

Verdent'in iş akışı üç temel aşama üzerine kuruludur:

  • Plan - Herhangi bir şey çalıştırılmadan önce, yapay zekayla bir netleştirme döngüsü üzerinden konuşun. Davranışını plan kurallarıyla özelleştirebilir; etkileşimli mimari planlama, görsel diyagramlar ve görev dökümleriyle gereksinimlerinizi kristal netliğine kavuşturabilirsiniz
  • Code - Değişiklikleri Code Diff'in kurumsal düzeydeki analiziyle inceleyin ve üretime hazır sonuçları güvenle teslim edin
  • Verify - Verify alt aracı ve tarayıcı eylemiyle kalite güvencesi. Kod kapsamlı doğrulamayı geçene kadar çok geçişli onarım döngüleriyle yineleyin

Bu temel kavramları ve Verdent'in mimarisini anlamak, eklentiyle daha verimli çalışmanıza yardımcı olur.

Daha fazla bilgi: Plan-Code-Verify iş akışı


Mimariye genel bakış

Karmaşık görevler parçalanır ve belirli amaçlar için optimize edilmiş özel yapay zeka aracılarına devredilir. Her alt aracı, kendi özel sistem istemiyle ve onu çağıran ana aracıdan izole edilmiş ayrı bir bağlam penceresiyle çalışır.

Bu ayrım, en yüksek performansı korur ve bağlam kirliliğini önler; böylece her alt aracı, ana aracıyı her uygulama detayıyla yüklemeden kendi özel görevine odaklanabilir.

Yerleşik varsayılan alt aracılar:

Verdent, hemen kullanıma hazır üç varsayılan alt aracı içerir:

Alt aracıAmaçNe zaman kullanılır
@VerifierHızlı kod kontrolleri ve doğrulamaKodlama görevlerinde kod kalitesini ve doğruluğunu sağlamak için
@ExplorerHızlı kod tabanı keşfiDosyaları bulmak ve kod tabanı yapınızla ilgili soruları yanıtlamak için
@Code-reviewerAnında kod kalitesi değerlendirmesiGüvenlik, sürdürülebilirlik ve performans için proaktif tarama yapmak için

Özel alt aracılar:

Kendi özel ihtiyaçlarınıza göre uyarlanmış özel alt aracılar oluşturabilirsiniz. Her özel alt aracı kendi sistem istemiyle çalışır; bu da belirli görevler veya iş akışları için özel davranış tanımlamanıza olanak tanır.

Özel alt aracılar, görev kalıplarına göre otomatik olarak veya @-bahsetmeleriyle el ile çağrılabilir. Yaygın kullanım senaryoları şunlardır:

  • Teknoloji yığını uzmanları - React performans optimize edici, SQL sorgu optimize edici, Docker yapılandırma inceleyicisi
  • Kalite güvencesi - Test kapsamı analizcisi, hata yönetimi inceleyicisi, günlük standartları uygulayıcısı
  • Ekibe özel iş akışları - Kod stili uygulayıcısı, dokümantasyon tutarlılığı denetleyicisi, bağımlılık denetçisi
  • Projeye özel ihtiyaçlar - Eski kod modernleştiricisi, geçiş yardımcısı, performans bütçesi uygulayıcısı

Daha fazla bilgi: Alt aracı yönetimi


Yürütme modları

Verdent, yapay zekanın izinleri ve etkileşimleri nasıl yöneteceğini kontrol eden birden çok yürütme modunu destekler:

İzin modları:

  • Manual Accept Mode - Her aracın ilk kullanımında izin ister. Maksimum kontrolle öğrenme ve genel geliştirme için idealdir.
  • Auto-Run Mode (varsayılan) - Güvenli işlemler (dosya okuma, web aramaları) için izinleri otomatik olarak kabul eder. Dosya düzenlemeleri ve komut yürütme yine de onay gerektirir. Güvenilir projeler ve hızlı prototipleme için idealdir.
  • Skip Permissions Mode - Tüm istemleri atlayan tamamen otonom çalışma. Yalnızca otomatik test veya korumalı alanlar gibi izole, güvenli ortamlar içindir.

İzin modları arasında geçiş yapmak için Giriş Kutusu'ndaki Switch Permission düğmesine (geçerli modu "Manual" veya "Auto" olarak gösterir) tıklayın ve açılır menüden istediğiniz modu seçin.

Switch Mode (etkileşim stilini kontrol eder):

  • Agent Mode - Otonom görev yürütme ve dosya işlemleriyle tam aracı davranışı
  • Plan Mode - Yürütmeden önce yaklaşımları incelemeye yönelik planlama odaklı etkileşim
  • Chat Mode - Otonom dosya işlemleri olmadan sohbet tabanlı etkileşim

Etkileşim stilleri arasında geçiş yapmak için Giriş Kutusu'ndaki Switch Mode düğmesine (geçerli modu "Agent" veya "Plan" olarak gösterir) tıklayın ve açılır menüden istediğiniz modu seçin.

Ek modlar:

  • Think Hard Mode - Sorunları derinlemesine analiz etmek, birden çok yaklaşımı keşfetmek ve daha kapsamlı çözümler sunmak için maksimum hesaplama kaynağı ayırır. Mimari kararlar, karmaşık hata ayıklama ve gelişmiş muhakeme gerektiren görevler için idealdir.

Think Hard Mode'u etkinleştirmek için isteğinizi göndermeden önce Giriş Kutusu'ndaki Think Hard düğmesine tıklayın.

Daha fazla bilgi: Yürütme modlarına genel bakış


Bağlam yönetimi

Bağlam yönetimi, oturumunuz sırasında Verdent'in hangi bilgilere erişebileceğini kontrol eder. Bağlam penceresi, aracının token cinsinden ölçülen ve birkaç bileşen arasında paylaşılan bellek sınırıdır: sistem talimatları, dosya içerikleri, sohbet mesajları ve aracı yanıtları.

Bağlam nasıl çalışır:

  • @-bahsetmeleri - Hassas kontrol için @filename.js kullanarak dosyaları açıkça bağlama ekleyin
  • Otomatik yükleme - Verdent, göreve göre ilgili dosyaları otomatik olarak dahil eder
  • Ayrı alt aracı bağlamı - Her alt aracı izole bağlam pencereleriyle çalışır ve ana aracının belleğinin kirlenmesini önler
  • Bağlam penceresi sınırları - Token cinsinden ölçülen sınırlı bağlam. Sohbetler büyüdükçe kullanılabilir alan azalır ve model performansı düşer

En iyi uygulamalar:

  • Büyük görevleri doğal kesme noktalarıyla daha küçük parçalara bölün
  • Karmaşık görevlerde yürütmeden önce yaklaşımları incelemek için Plan Mode'u kullanın
  • Bağlamın tükenmesini önlemek için entegrasyondan önce her bileşeni tamamlayın
  • Yeni bir göreve başlarken bağlamı temizlemek ve en iyi performansı korumak için yeni bir sohbet başlatın

Daha fazla bilgi: Bağlam yönetimi en iyi uygulamaları


Model seçimi

Verdent, tek bir iş akışı içinde birden çok yapay zeka sağlayıcısının (Claude, GPT-5, Gemini, MiniMax) modellerini düzenler. Her özel aracı, kendi belirli görevi için en uygun modeli kullanabilir.

Hazır modeller:

  • Performance - Maksimum bağlam, sınır modelleri (1-2x kredi kullanımı)
  • Balance - Performans ve maliyetin en uygun karışımı (1x kredi kullanımı)
  • Efficiency - Hızlı, duyarlı, maliyet açısından verimli görevler (~0,3x kredi kullanımı)

Kullanılabilir bireysel modeller:

SağlayıcıModelEn uygun olduğuMaliyet verimliliği
AnthropicClaude 4.5 OpusDerin kodlama görevleri ve sorun çözme için harika.1,5x maliyet
AnthropicClaude 4.5 SonnetDengeli karmaşık görevler1x referans
AnthropicClaude 4.5 Sonnet 1MUzun veya karmaşık görevler (>200k girdi)0,5x verimlilik (2x maliyet)
AnthropicClaude 4.5 HaikuHızlı, basit görevlerSonnet'ten 3,2x daha verimli
OpenAIGPT-5 (Beta)Muhakeme ve yaratıcılıkSonnet'ten 1,3x daha verimli
OpenAIGPT-5 Codex (Beta)Kodlama ve hata ayıklamaSonnet'ten 1,3x daha verimli
GoogleGemini 3 ProGelişmiş muhakeme ve çok modlulukDeğişken
KimiKimi 2 Turbo (Beta)Kodlama için yıldırım hızında modelSonnet'ten 3,1x daha verimli

Daha fazla bilgi: Yapılandırma ayarları


SSS

Bağlam kirliliği nedir?

Bağlamdaki önceki eylemlerin ve bilgilerin, gelecekteki görevleri etkileyen istenmeyen davranış kalıpları oluşturmasıdır. Örneğin, kodu tekrar tekrar güncelleyip ardından dağıtırsanı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 izole bağlam pencereleriyle çalışarak bağlam kirliliğini önler; böylece her özel görev temiz bağlamla başlar ve farklı iş türleri arasında çapraz bulaşma engellenir.

Güvenli işlemler nelerdir?

Yalnızca veri okuyan ve herhangi bir değişiklik yapmayan 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.

Komut yürütme nedir?

Verdent aracılığıyla terminal komutlarının veya kabuk betiklerinin çalıştırılmasıdır; test çalıştırma, paket kurma veya derleme komutlarını yürütme gibi işlemleri içerir. Komut yürütme, istenmeyen sistem değişikliklerini önlemek için çoğu izin modunda onay gerektirir.

Token nedir?

Bağlam pencerelerinin ölçü birimidir. Token'lar, yapay zeka modelinin işlediği metin parçalarını (kelimeler, kelime parçaları veya karakterler) temsil eder. Bağlam sınırları karakter veya kelime yerine token cinsinden ölçülür ve tipik sohbetler binlerce token tüketir.

Krediler nedir?

Verdent'in kullanım para birimidir. Farklı modellerin maliyet verimliliği farklıdır (örneğin Haiku, Sonnet referansından 3,2x daha verimlidir, Sonnet 1x referanstır). Aboneliğiniz aylık bir kredi tahsisi içerir (örneğin Starter için 640 kredi, Pro için 2.000, Max için 6.000).

Çok geçişli üret-test-onar döngüsü nedir?

Kodun üretildiği, test edildiği ve kapsamlı testi geçene kadar onarıldığı yinelemeli bir doğrulama sürecidir. Verdent, kod doğru çalışana kadar testleri otomatik olarak çalıştırır, başarısızlıkları analiz eder, sorunları düzeltir ve birden çok 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.


Ayrıca bkz.