--- title: Alt aracılar description: "Ana aracının ihtiyaç duyduğunda çağırabileceği özelleşmiş uzman aracılar" --- Alt aracı, ana aracının (Worker) görev yürütme sırasında istediği zaman çağırabileceği özelleşmiş bir "uzmandır". Her alt aracının kendi uzmanlık alanı, kendine özel istemi vardır ve hatta farklı bir model üzerinde çalışabilir. Sohbette yalnızca `@SubagentName` yazmanız yeterli; tıpkı bir grup sohbetinde bir iş arkadaşını etiketlemek gibi yardıma katılır. --- ## Yerleşik alt aracılar Verdent, yazılım geliştirmedeki en yaygın ihtiyaçları kapsayan 6 alt aracıyla kutudan çıktığı haliyle gelir: | Ad | Varsayılan model | Hangi konuda iyi | |------|---------------|-------------------| | **General** | Ana aracıyı izler | Karmaşık problemler, kod araması ve çok adımlı görevler için genel amaçlı bir araştırma aracısı; neredeyse her konuda yardımcı olabilir | | **Fast Context** | Gemini 3 Flash | Kodu hızlıca bulma ve bağlamsal kanıt toplama; kod tabanı dizinleme konusunda uzmandır ve son derece hızlıdır | | **Verifier** | Sonnet 4.6 | Hızlı kod incelemesi; değişiklik yaptıktan sonra etiketleyin, bariz sorunları yakalasın | | **Verdent Helper** | Haiku 4.5 | Bir Verdent kullanım asistanı; Verdent'in nasıl çalıştığına dair her şeyi ona sorun | | **Multi-Model Planner** | Gemini 3.1 Pro; Opus 4.6; GPT-5.4 | Birden fazla model (Claude, GPT, Gemini) kullanarak planlar üretir ve çıktılarını birleştirir | | **Reviewer** | Gemini 3.1 Pro; Opus 4.6; GPT-5.4 | Tam kod incelemesi: mantık hataları, uç durumlar, gizli riskler | İki alt aracı özeldir: **Multi-Model Planner** ve **Reviewer**, 2–3 modeli paralel olarak çalıştırır. Her model bağımsız düşünür, kendi çıktısını üretir ve ardından sonuçlar birleştirilir. Diğer tüm alt aracılar tek modellidir. --- ## Alt aracılar nasıl kullanılır Herhangi bir konuşmada, alt aracı seçim menüsünü açmak için `@` yazın (bulanık arama desteklenir). İstediğiniz alt aracıyı seçin; mevcut bağlamı devralır. **Örnekler:** - Karmaşık kimlik doğrulama mantığı yazdıktan sonra: `@Reviewer please review this` → Reviewer bunu güvenlik, mantık ve uç durum açılarından inceler. - Zorlu bir mimari karar için: `@Multi-Model Planner` → birden fazla model çözüm önerir ve siz en iyisini seçersiniz. - Kod yazdıktan sonra hızlıca `@Verifier` çalıştırın → temel doğrulama için tam test paketlerini çalıştırmaktan daha hızlıdır. --- ## Özel alt aracılar Yerleşik alt aracılar çoğu ihtiyacı karşılar, ancak bazen projenize özel bir uzman istersiniz. Kendi alt aracınızı oluşturabilirsiniz. ### Nerede saklanır Özel alt aracılar şu konumda Markdown dosyaları olarak saklanır: ``` ~/.verdent/subagents/ ``` Düzenleme için en fazla 5 düzey alt dizin desteklenir. ### Dosya biçimi Her alt aracı, YAML frontmatter içeren bir Markdown dosyasıdır: ```markdown --- name: SQL-Expert description: Specializes in SQL optimization and database design, good at analyzing slow queries and indexing strategies color: blue model: claude-sonnet-4-6 --- You are a senior database expert focused on PostgreSQL performance optimization. When users provide SQL queries, you should: 1. Analyze the query execution plan 2. Identify performance bottlenecks (full table scans, missing indexes, etc.) 3. Provide concrete optimization suggestions and rewritten SQL ... ``` ### Önemli ayrıntılar - **Ad:** yalnızca harf, rakam ve tire içermelidir (ör. `SQL-Expert`, `MyAgent123`). Boşluk veya ASCII dışı karakter olmaz. - **Renk:** `dark-green`, `light-green`, `red-orange`, `amber`, `cyan`, `blue`, `pink`, `purple`, `verdent` değerlerinden biri; görsel olarak daha kolay tanımak için. - **Anında yeniden yükleme:** `.md` dosyasını kaydetmek anında etkili olur; Verdent'i yeniden başlatmaya gerek yoktur. --- ## Ayarlarda alt aracıları yönetme Tüm alt aracı yönetimi **Settings → Subagents** içinde gerçekleşir. | Eylem | Açıklama | |--------|-------------| | **Listeyi görüntüle** | Tüm alt aracılar kartlar halinde gösterilir. Yerleşik olanlar "Built-in" olarak etiketlenir; eklenti tabanlı olanlar eklenti adlarını gösterir. | | **Etkinleştir / Devre dışı bırak** | Her alt aracıyı diğerlerini etkilemeden açıp kapatın. | | **Yeni oluştur** | **Add Subagent**'a tıklayın ve Identifier (benzersiz ad), Model, Description ve Prompt alanlarını doldurun. | | **Düzenle** | Düzenlemek için bir kartın üzerine gelin. Yerleşik alt aracılarda yalnızca Model ve Description değişikliklerine izin verilir. | | **Çoğalt** | Herhangi bir özel alt aracıyı kopyalayın (kopyalar etkinleştirilene kadar varsayılan olarak devre dışıdır). | | **Sil** | Özel alt aracılar kaldırılabilir (onayla). Yerleşik olanlar silinemez. | ### Model seçim farklılıkları - **Multi-Model Planner** ve **Reviewer**, çoklu model seçimini destekler (aynı anda 2–3 model). - Diğer alt aracılar tek model seçimi kullanır. - **General**'in özel bir seçeneği vardır: ayrı yapılandırma bakımını önleyerek ana aracının modelini otomatik olarak izleyebilir. --- ## Kullanım senaryoları ### Kod incelemesi Karmaşık mantık uyguladıktan sonra `@Reviewer` etiketleyin. Doğruluğu, uç durumları ve olası hataları kontrol eder; sizi satır satır manuel incelemeden kurtarır. ### Çok perspektifli mimari tasarım Önemli kararlar için (ör. mikroservise geçiş, veritabanı seçimi), birden fazla üst düzey modelden bağımsız öneriler almak ve karar riskini azaltmak için `@Multi-Model Planner` kullanın. ### Hızlı doğrulama Kod değişikliklerinden sonra, `@Verifier` sözdizimini, tipleri ve temel sorunları hızlıca kontrol eder; tam test paketlerinden daha hızlı, hiç kontrol etmemekten daha güvenilirdir. ### Özel alan uzmanları Projenize özel alt aracılar oluşturun: - Şemanızı ve sorgu kalıplarınızı bilen bir SQL optimizasyon uzmanı - ESLint ve tasarım sistemi kurallarınızı uygulayan bir ön uç kod standartları koruyucusu - Teknik içeriği anlaşılır, okuyucu dostu bir yazıya uyarlayan bir dokümantasyon asistanı --- ## Notlar - Özel alt aracıların etkinleştirilebilmesi için geçerli bir modelle yapılandırılması gerekir. BYOK kullanıyorsanız ve anahtarın süresi dolarsa ya da model kullanımdan kaldırılırsa, alt aracı otomatik olarak devre dışı bırakılır. - Yerleşik alt aracı modelleri değiştirilebilir, ancak varsayılanlar özenle ayarlanmıştır; bunları değiştirmek performansı düşürebilir. - **Açıklama önemlidir:** ana aracının bağlamına eklenir ve alt aracıların ne zaman çağrılacağını etkiler. Daha iyi açıklamalar daha akıllı yönlendirme sağlar. - Alt aracılar birbirini çağıramaz. Yalnızca ana aracı (Worker) tarafından çağrılabilirler; daha derin iç içe geçmeye izin verilmez.