---
title: Alt aracı yönetimi
description: Verdent içindeki alt aracıları anlama ve yönetme
---

Alt aracılar, kendi özel sistem istemiyle, ayrı bir bağlam penceresiyle ve izole bir yürütme ortamıyla çalışan özelleşmiş yapay zeka aracılarıdır. Ana aracı tarafından devredilen belirli görevleri, ana konuşma bağlamını kirletmeden ele alırlar.

**Temel özellikler:**

- **İzole bağlam pencereleri:** Her alt aracı kendi ayrı bağlam penceresini korur. Ana aracının bağlamında yer kaplayan tek şey alt aracıların döndürdüğü nihai sonuçlardır; ara işlemler değil.
- **Özel sistem istemleri:** Her alt aracının; davranışını, kişiliğini ve görev yorumlama yaklaşımını tanımlayan özel bir sistem istemi vardır.
- **Otomatik görev devri:** Ana aracı, uygun görev türleri algılandığında alt aracıları otomatik olarak çağırır; bu, otomatik araç seçimine benzer.
- **Manuel çağırma:** Kullanıcılar alt aracıları @-bahsetmeleriyle açıkça belirtebilir (`@Verifier`, `@Explorer`, `@Code-reviewer`).

**İki kategori:**
- **Varsayılan alt aracılar:** Yerleşik (Verifier, Explorer, Code-reviewer) — anında kullanılabilir, önceden yapılandırılmıştır
- **Özel alt aracılar:** Kullanıcı tarafından oluşturulur, `~/.verdent/subagents/` içinde saklanır — projeye özgü ihtiyaçlara göre uyarlanır

---

## Varsayılan alt aracıları anlama

Verdent for VS Code önceden yapılandırılmış, anında kullanılabilen ve herhangi bir kurulum veya yapılandırma gerektirmeyen üç yerleşik varsayılan alt aracı içerir.

<Tabs>
  <Tab title="@Verifier">
    **Uzmanlık alanı:** Hızlı kod kontrolleri ve doğrulama

    **Yetenekler:**
    - Kod mantığını doğrular
    - Söz dizimi doğruluğunu kontrol eder
    - Uygulamayı gereksinimlere göre doğrular

    **Kullanım:**
    Kodlama görevleri sırasında başvurun:
    ```
    @Verifier check this authentication logic
    ```

    **En uygun:** Tam kod incelemesi yükü olmadan hızlı doğrulama için
  </Tab>

  <Tab title="@Explorer">
    **Uzmanlık alanı:** Hızlı kod tabanı keşfi ve gezinme

    **Yetenekler:**
    - Dosyaları desene veya ada göre bulur
    - Kodda anahtar sözcük/işlev arar
    - Mimari soruları yanıtlar
    - İşlevselliğin nerede uygulandığını belirler

    **Kullanım:**
    Kod tabanı soruları için veya açıkça istendiğinde otomatik olarak çağrılır:
    ```
    @Explorer find all API endpoints
    ```

    **En uygun:**
    - Tanıdık olmayan kod tabanlarını anlama
    - Belirli uygulamaları bulma
    - Mimari analiz

    **Performans:** Token açısından verimlidir, karmaşık aramalar için paralel olarak birden fazla örnek çalıştırabilir
  </Tab>

  <Tab title="@Code-reviewer">
    **Uzmanlık alanı:** Kod kalitesi değerlendirmesi

    **Yetenekler:**
    - Yeni ve değiştirilen kodu güvenlik açıkları için proaktif olarak tarar
    - Bakım yapılabilirlik sorunlarını belirler
    - Performans sorunlarını tespit eder

    **Kullanım:**
    Kalite kontrolleri için başvurun:
    ```
    @Code-reviewer review this authentication flow
    ```

    **En uygun:**
    - Commit öncesi incelemeler
    - Entegrasyondan önce sorunları belirleme
    - Kod kalitesi standartlarını sağlama
  </Tab>
</Tabs>

---

### Otomatik ve manuel çağırma karşılaştırması

**Otomatik seçim tetikleyicileri:**

Ana aracı, görev deseni tanıma temelinde alt aracıları otomatik olarak seçer:

**Explorer alt aracısı:**
- Kod tabanı yapısıyla ilgili sorular ("Mimari nedir?", "X nerede uygulanıyor?")
- Dosya arama istekleri ("Şunu yapan tüm dosyaları bul...", "Şununla ilgili bileşenleri göster...")
- Kod gezinme sorguları ("Kimlik doğrulama nasıl çalışıyor?", "Bu işlevi ne çağırıyor?")

**Code-reviewer alt aracısı:**
- Güvenlik incelemesi istekleri ("Güvenlik açıklarını incele", "SQL enjeksiyonu risklerini kontrol et")
- Kod kalitesi değerlendirme istemleri ("Kod kalitesini analiz et", "Bakım yapılabilirlik sorunlarını belirle")
- Commit öncesi inceleme senaryoları (kod değişiklikleri sunulduğunda örtük olarak)

**Verifier alt aracısı:**
- Doğrulama istekleri ("Bu mantığı doğrula", "Bu uygulamanın doğru olup olmadığını kontrol et")
- Söz dizimi ve doğruluk kontrolleri ("Bu kod çalışıyor mu?", "Kimlik doğrulama akışını doğrula")

**Manuel belirtme:**

Kullanıcılar @-bahsetmelerini kullanarak otomatik yönlendirmeyi geçersiz kılabilir:

```
@Explorer find all authentication-related files
@Code-reviewer review the security of login flow
@Verifier check validation logic in middleware
```

**Add Subagent düğmesi:**
Giriş kutusundaki **Add Subagent** düğmesine tıklayarak şunları yapabilirsiniz:
- Kullanılabilir alt aracılardan (varsayılan ve özel) seçim yapın
- Görevi seçilen alt aracıya açıkça devredin
- Otomatik yönlendirme kararlarını geçersiz kılın

**Manuel belirtmenin avantajları:**
- **Hassasiyet:** Görevi tam olarak istediğiniz alt aracının ele almasını sağlayın
- **Geçersiz kılma:** Birden fazla aracı uygulanabilir olduğunda belirli bir alt aracı seçin
- **Test etme:** Özel alt aracı davranışını açıkça doğrulayın
- **Tutarlılık:** Tutarlı sonuçlar için görevleri aynı alt aracıyla tekrarlayın

<Info>
Özel alt aracılar, alt aracı sistem istemi çağırma politikasında tanımlanan "Ne zaman kullanılır" yönergelerine göre otomatik olarak çağrılabilir. Tetikleyici desen yapılandırmasıyla ilgili ayrıntılar şu anda geliştirme aşamasındadır.
</Info>

---

## Özel alt aracılar oluşturma

Özel alt aracılar, projeye özgü ihtiyaçlarınıza, alan uzmanlığınıza veya ekip iş akışlarınıza göre uyarlanmış özelleşmiş aracılar oluşturmanıza olanak tanır.

### Oluşturma yöntemleri

<Tabs>
  <Tab title="Settings menüsü">
    **Yeni başlayanlar için önerilir**

    1. **Settings** → **Subagents** seçeneğine tıklayın
    2. "Create new subagent" seçeneğini seçin
    3. Alt aracı adını, açıklamasını ve sistem istemini tanımlayın
    4. Çağırma politikasını ve kullanım yönergelerini yapılandırın
    5. `~/.verdent/subagents/` dizinine kaydedin

    Bu yöntem, doğrulama ve faydalı istemlerle alt aracı oluşturmak için rehberli bir arayüz sunar.
  </Tab>

  <Tab title="Doğrudan dosya oluşturma">
    **İleri düzey kullanıcılar için önerilir**

    1. `~/.verdent/subagents/` dizinine gidin
    2. Bir markdown dosyası oluşturun (örneğin `security-reviewer.md`)
    3. `name` ve `description` ile YAML frontmatter ekleyin
    4. Davranışı tanımlayan sistem istemini yazın
    5. Çağırma politikasını ve "Ne zaman kullanılır" yönergelerini belirtin

    Bu yöntem daha fazla kontrol sunar ve dosya yapısına aşina kullanıcılar için daha hızlıdır.

    <Tip>
    Özel alt aracıları ~/.verdent/subagents/ içinde saklayarak projeler arasında paylaşın. Tüm çalışma alanlarında kullanılabilir olurlar.
    </Tip>
  </Tab>
</Tabs>

---

### Dosya yapısı

Özel alt aracı dosyaları, YAML frontmatter içeren Markdown biçimini kullanır:

```markdown
---
name: subagent-name
description: Brief description of specialization
---
# System Prompt

[Behavior definition, personality, interpretation style]

Invocation policy (strict): Only run if explicitly requested.

When to use:
- Specific scenario 1
- Specific scenario 2

When NOT to use:
- Avoid scenario 1
- Avoid scenario 2
```

**YAML frontmatter (Zorunlu):**
- `name`: @-bahsetmelerinde kullanılan alt aracı tanımlayıcısı
- `description`: Alt aracının amacına ilişkin tek satırlık açıklama

**Sistem istemi bölümü:**
Alt aracı davranışını tanımlayan Markdown içeriği:
- Kişilik ve ton
- Görevler için yorumlama yaklaşımı
- Çıktı biçimi tercihleri
- Karar verme ilkeleri

**Çağırma politikası (Zorunlu):**
```
Invocation policy (strict|flexible): Policy description
```
- **strict:** Yalnızca kullanıcı tarafından açıkça istendiğinde çağrılır
- **flexible:** Görev desenlerine göre otomatik çağırmaya izin verir

**Kullanım yönergeleri:**
```
When to use the [name] agent:
- Bullet list of scenarios for invocation

When NOT to use:
- Bullet list of scenarios to avoid
```

---

### Özel alt aracı örnekleri

<Tabs>
  <Tab title="API belgeleri">
    ```markdown
    ---
    name: api-documenter
    description: Generates comprehensive API documentation from code
    ---
    # System Prompt

    You are an API documentation specialist.

    Documentation approach:
    - Extract endpoints, parameters, and responses from code
    - Generate OpenAPI/Swagger specifications
    - Include usage examples and error codes
    - Document authentication requirements

    Output format:
    - Markdown tables for endpoints
    - Code examples in multiple languages
    - Authentication flow diagrams

    Invocation policy (strict): Only run when explicitly requested.

    When to use:
    - User requests API documentation generation
    - Need to document REST/GraphQL endpoints
    - Creating developer guides

    When NOT to use:
    - Inline code comments
    - User-facing documentation
    ```

    **Kullanım durumu:** Rota işleyicilerini, denetleyicileri ve şema tanımlarını analiz ederek kapsamlı API belgelerini otomatik olarak oluşturun.
  </Tab>

  <Tab title="Veritabanı geçişi">
    ```markdown
    ---
    name: migration-reviewer
    description: Reviews database migrations for safety and correctness
    ---
    # System Prompt

    You are a database migration safety specialist.

    Review checklist:
    - Check for destructive operations (DROP, DELETE without WHERE)
    - Verify reversible migrations (up/down compatibility)
    - Identify potential data loss scenarios
    - Validate index creation strategies
    - Check for blocking operations on large tables

    Risk assessment:
    - Categorize migrations: low/medium/high risk
    - Recommend staging environment testing for high-risk changes
    - Suggest rollback procedures

    Invocation policy (strict): Only run when explicitly requested.

    When to use:
    - User creates or modifies migration files
    - Pre-deployment migration review
    - Investigating migration failures

    When NOT to use:
    - Schema design from scratch
    - Query optimization
    ```

    **Kullanım durumu:** Dağıtımdan önce riskli veritabanı işlemlerini belirleyerek üretim olaylarını önleyin.
  </Tab>

  <Tab title="Erişilebilirlik">
    ```markdown
    ---
    name: a11y-auditor
    description: Audits frontend code for accessibility compliance
    ---
    # System Prompt

    You are an accessibility compliance specialist (WCAG 2.1 Level AA).

    Audit criteria:
    - Semantic HTML structure
    - ARIA labels and roles
    - Keyboard navigation support
    - Color contrast ratios
    - Screen reader compatibility
    - Focus management

    Report format:
    - Issues categorized by severity (critical/major/minor)
    - WCAG guideline references
    - Code examples showing fixes
    - Testing recommendations

    Invocation policy (flexible): May auto-invoke for UI component reviews.

    When to use:
    - User creates/modifies UI components
    - Pre-deployment accessibility checks
    - Compliance audits

    When NOT to use:
    - Backend API code
    - Build configuration files
    ```

    **Kullanım durumu:** Web uygulamalarının dağıtımdan önce erişilebilirlik standartlarını karşıladığından emin olun.
  </Tab>
</Tabs>

---

### Özel alt aracılar için yaygın kullanım durumları

<Tabs>
  <Tab title="Alan uzmanlığı">
    **Alana özgü uzmanlık**

    - **Finansal hesaplamalar:** Vergi uyumluluğu ve finansal düzenlemeler konusunda uzmanlaşmış alt aracı
    - **Sağlık HIPAA uyumluluğu:** Kodu hasta verisi işleme standartları açısından inceleyin
    - **Kriptografi:** Güvenlik uygulamalarını en iyi uygulamalara göre analiz edin

    Özel bilgi gereksinimleri ve düzenleyici kısıtlamaları olan sektörler için idealdir.
  </Tab>

  <Tab title="Ekip iş akışları">
    **Ekibe özgü iş akışları**

    - **Kod stili uygulayıcı:** Linter kurallarının ötesinde ekibe özgü kodlama standartlarına göre kontrol edin
    - **Belge tutarlılığı:** Belgelerin ekip şablonlarına ve tonuna uymasını sağlayın
    - **Bağımlılık denetleyici:** Üçüncü taraf paket kullanımını onaylı listelere göre izleyin

    Ekip kurallarını uygulayın ve işbirlikçi projeler genelinde tutarlılığı koruyun.
  </Tab>

  <Tab title="Teknoloji yığını">
    **Teknoloji yığını uzmanları**

    - **React performans optimize edici:** Gereksiz yeniden render'ları ve memoization fırsatlarını belirleyin
    - **SQL sorgu optimize edici:** Veritabanı sorgu performansını analiz edip iyileştirin
    - **Docker yapılandırma inceleyici:** Kapsayıcılaştırma en iyi uygulamalarını doğrulayın

    Belirli çerçeveler, diller veya altyapı teknolojileri konusunda derin uzmanlık.
  </Tab>

  <Tab title="Kalite güvencesi">
    **Kalite güvencesi**

    - **Test kapsamı analizcisi:** Test edilmemiş kod yollarını belirleyin, test senaryoları önerin
    - **Hata işleme inceleyici:** Kapsamlı istisna işlemeyi sağlayın
    - **Günlük tutma standartları uygulayıcı:** Hata ayıklama ve izleme için günlük tutma uygulamalarını doğrulayın

    Kod güvenilirliğini ve bakım yapılabilirlik standartlarını korumak için otomatik kalite kontrolleri.
  </Tab>

  <Tab title="Uyumluluk">
    **Uyumluluk ve güvenlik**

    - **GDPR uyumluluk denetleyici:** Veri işlemeyi gizlilik gereksinimleri açısından inceleyin
    - **Güvenlik açığı tarayıcı:** Çerçeveye özgü sorunlar için özelleşmiş tespit
    - **Lisans uyumluluk denetleyici:** Bağımlılıkları lisans uyumluluğu açısından kontrol edin

    Dağıtımdan önce yasal, güvenlik ve lisanslama gereksinimlerine uyumu sağlayın.
  </Tab>

  <Tab title="Projeye özgü">
    **Projeye özgü ihtiyaçlar**

    - **Eski kod modernize edici:** Güncel olmayan desenleri belirleyin, modern alternatifler önerin
    - **Geçiş yardımcısı:** Çerçeve veya dil sürümü yükseltmelerine rehberlik edin
    - **Performans bütçesi uygulayıcı:** Paket boyutlarını ve yükleme sürelerini eşiklere göre izleyin

    Benzersiz proje zorlukları ve teknik borç yönetimi için uyarlanmış özel çözümler.
  </Tab>
</Tabs>

---

## Alt aracı davranışı yapılandırması (AGENTS.md deseni)

AGENTS.md öncelikle bir proje kuralları dosyası olarak hizmet etse de (bkz. [Kural sistemleri](/docs/verdent-for-vscode/agents-rules/rule-systems)), projeye özgü alt aracı davranışını da tanımlayabilir.

### Sistem istemi tasarım ilkeleri

**Spesifik ve yönlendirici olun:**
Genel rehberlik yerine kesin davranış beklentilerini tanımlayın.

<Tip>
Sistem istemlerinde spesifik ve yönlendirici olun; 'Optimize etmeden önce profilleyin' ifadesi 'Mümkünse optimize etmeye çalışın' ifadesinden daha iyidir.
</Tip>

**İyi:**
```markdown
Analysis approach:
- Profile before optimizing
- Focus on algorithmic improvements
- Provide before/after benchmarks
```

**Kaçının:**
```markdown
Try to optimize code when possible
```

**Kişilik ve ton oluşturun:**
Belirli amaçlar için optimize edilmiş ayırt edici "kişilikler" oluşturun:

```markdown
You are a performance optimization specialist.
```

**Karar verme ilkelerini tanımlayın:**
Alt aracının ödünleşmelere nasıl yaklaşması gerektiğine yön verin:

```markdown
When suggesting optimizations:
1. Measure first, optimize second
2. Prioritize readability over micro-optimizations
3. Only suggest changes with >10% performance improvement
```

**Çıktı biçimini belirtin:**
Sonuçların nasıl sunulduğunu kontrol edin:

```markdown
Output format:
- Markdown tables for endpoints
- Code examples in multiple languages
- Authentication flow diagrams
```

---

### Çağırma politikası yapılandırması

**Strict politika:**
```markdown
Invocation policy (strict): Only run when explicitly requested.
```

Şu durumlarda kullanın:
- Alt aracı hassas işlemleri ele alıyorsa (güvenlik incelemeleri, veritabanı geçişleri)
- Kullanıcı ne zaman çağıracağına bilinçli olarak karar vermeli
- Otomatik çağırma kesintiye yol açabilirse

**Flexible politika:**
```markdown
Invocation policy (flexible): May auto-invoke based on task patterns.
```

Şu durumlarda kullanın:
- Alt aracı kesintiye yol açmadan faydalı bağlam sağlıyorsa
- Otomatik çağırma iş akışı verimliliğini artırıyorsa
- Görev desenleri açıkça tanımlanabiliyorsa

**Kullanım yönergeleri en iyi uygulamaları:**

**"Ne zaman kullanılır" bölümü:**
- Tetikleyici senaryolar hakkında spesifik olun
- Alt aracıyı çağırması gereken örnek istemleri ekleyin
- Alt aracı uzmanlığına uyan görev özelliklerini açıklayın

**"Ne zaman kullanılmaz" bölümü:**
- Uygunsuz çağırmayı önlemek için istisnaları açıkça listeleyin
- İlgili alt aracılarla sınırları netleştirin
- Kapsam kaymasını önleyin

---

## Görev yönlendirme ve dağıtımı

Verdent'in çoklu alt aracı sistemi, özelleşmiş aracılar arasında otomatik yönlendirme ve koordinasyonla paralel görev yürütmeye olanak tanır.

### Mimari bileşenleri

**Ana aracı (Düzenleyici):**
Birincil aracı kullanıcı isteklerini analiz eder, karmaşık görevleri parçalara ayırır ve özelleşmiş işi uygun alt aracılara devreder. Konuşma bağlamını korur ve alt aracı sonuçlarını koordine eder.

**Alt aracı havuzu:**
Otomatik veya manuel olarak çağrılabilen kullanılabilir alt aracıların (hem varsayılan hem özel) topluluğu. Her biri izole bağlamla bağımsız olarak çalışır.

**Otomatik görev yönlendirme:**
Ana aracı, alt aracı uzmanlıklarıyla eşleşen görev desenlerini algıladığında işi otomatik olarak dağıtır:
- Kod tabanı keşif soruları → Explorer alt aracısı
- Güvenlik incelemesi istekleri → Code-reviewer alt aracısı
- Doğrulama kontrolleri → Verifier alt aracısı

**Paralel yürütme:**
Karmaşık işlemler için birden fazla alt aracı eşzamanlı çalışabilir. Örnek: Explorer alt aracısı kod tabanını ararken Code-reviewer aynı anda güvenliği analiz eder ve daha hızlı sonuç verir.

<Note>
Paralel alt aracı yürütmesi karmaşık görevleri hızlandırır; Explorer arama yaparken Code-reviewer aynı anda analiz yapabilir.
</Note>

**Sonuç birleştirme:**
Alt aracı çıktıları ana aracıya döndürülür; ana aracı sonuçları sentezler ve kullanıcıya birleşik yanıtlar sunar.

<Info>
Alt aracı yürütme zamanlaması, önceliği, maksimum eşzamanlı limitleri, hata işleme ve kaynak tahsisi hakkında ayrıntılı bilgiler şu anda geliştirme aşamasındadır. Spesifik mimari sorular için destek ekibiyle iletişime geçin.
</Info>

---

## Alt aracı izleme

Alt aracı kullanımını ve performansını, Verdent'in alt aracı işlemlerini ve sonuçlarını görüntülediği Chat View üzerinden izleyin.

### İzleme yöntemleri

**Chat View göstergeleri:**
- Alt aracı çağrıları konuşma geçmişinde görünür
- İlerleme göstergeleri alt aracıların ne zaman çalıştığını gösterir
- Sonuçlar, çıktıyı hangi alt aracının sağladığını açıkça belirtir

**Alt aracı çıktıları bölümü:**
Şunlar için özel görüntüleme:
- Alt aracı görev yürütmesinden elde edilen sonuçlar
- Paralel görevler için ilerleme göstergeleri
- Görevler tamamlandığında birleştirilmiş özetler

**Yanıt atfı:**
Verdent yanıtlarda bulguları belirli alt aracılara atfederek, hangi aracının hangi analizi veya aramayı gerçekleştirdiğini netleştirir.

### Görünürlük ve şeffaflık

**İşlem şeffaflığı:**
Verdent şunları gösterir:
- Hangi alt aracının çağrıldığı
- Çağrının otomatik mi yoksa manuel mi olduğu
- Görev devir nedeni
- Alt aracı yürütme durumu

**Manuel belirtme doğrulaması:**
@-bahsetmelerini kullandığınızda, Verdent belirtilen alt aracının görevi ele aldığını onaylayarak yönlendirme tercihlerinize uyulmasını sağlar.

<Info>
Ayrıntılı yürütme günlükleri, performans metrikleri (yürütme süresi, token kullanımı), geçmiş çağrı takibi, etkinlik görünürlüğü ayarları ve kullanım analizi panoları dahil olmak üzere gelişmiş izleme özellikleri şu anda geliştirme aşamasındadır.
</Info>

---

## Ayrıca bakınız

<CardGroup cols={2}>
  <Card title="Kural sistemleri ve davranış rehberliği" icon="sliders" href="/docs/verdent-for-vscode/agents-rules/rule-systems">
    Verdent davranışını kullanıcı kuralları, proje kuralları ve plan kuralları aracılığıyla yapılandırın
  </Card>
  <Card title="Araç referansı" icon="wrench" href="/docs/verdent-for-vscode/advanced-features/tool-reference">
    Kullanılabilir araçların ve yeteneklerin eksiksiz referansı
  </Card>
</CardGroup>