Visual Studio 2026 Custom Agents Rehberi: .agent.md ile Özel Copilot Ajanları ve Cloud Agent Sessions

Visual Studio 2026 ve Agentic Workflow Devrimi (Agentic Workflow Revolution)

Visual Studio 2026 Insiders kanalında Eylül 2025'te göründü, stable olarak 2025 sonunda yayınlandı ve Nisan 2026 güncellemesi (v18.5) ile agentic workflows kavramını IDE'nin kalbine yerleştirdi. Microsoft Build 2026'nın merkezi teması "AI Agents" — ve bu vizyon Visual Studio'da somutlaşmış durumda.

Agentic workflow nedir? Klasik kodlama yardımcısı (code assistant) modelinde geliştirici komut yazar, AI önerir, geliştirici kabul eder. Agentic modelde ise AI bağımsız iş akışları çalıştırır (AI runs independent workflows): test yazar, çalıştırır, hata bulur, düzeltmeyi dener, doğrular ve sonra size raporlar. Alesta Web ekibi olarak bu paradigma değişikliğinin önemini vurgulamamız gerek — kod üretiminden öte, kod sahipliği değişiyor.

Custom Agents: .agent.md Dosya Formatı (Custom Agents File Format)

Visual Studio 2026'nın Nisan güncellemesi ile Custom Agents kullanıcı düzeyinde (user-level) destek aldı. Artık repo'nuzdaki .agent.md dosyaları ile özel Copilot ajanları tanımlayabilirsiniz. Bu ajanlar workspace farkındalığına, kod anlama yeteneğine, araç erişimine ve tercih ettiğiniz modele tam erişim sahibi.

---
name: api-reviewer
description: REST API endpoint'lerini güvenlik ve performans açısından inceler
model: gpt-5-turbo
tools:
  - file_read
  - grep
  - mcp:swagger-validator
---

# API Reviewer Agent

Sen bir senior backend mühendisisin. Görevlerin:

1. Endpoint'lerin OWASP Top 10 açısından güvenli olduğunu doğrula
2. SQL injection ve XSS riskini kontrol et
3. Rate limiting yapılandırmasını analiz et
4. Response time'ı optimize edebilecek N+1 sorgu kalıplarını bul

Çıktı formatı:
- 🔴 Critical | 🟡 Warning | 🟢 OK
- Dosya:satır referansı
- Önerilen düzeltme

Bu dosyayı projenin .github/agents/ klasörüne ekledikten sonra agent picker'da (ajan seçicide) görünecek. Ekip arkadaşlarınız da aynı ajanı kullanabilecek — paylaşımlı, versiyon kontrollü, tekrarlanabilir.

Custom Agent Yetenekleri

• ✅ Workspace awareness: Tüm proje yapısını okur (reads entire project structure)
• ✅ Code understanding: Sembol grafiği, çağrı zinciri, tip bilgisi
• ✅ Tool access: File read/write, grep, terminal, debug
• ✅ Custom model: Görev başına farklı LLM seçimi
• ✅ MCP connections: Model Context Protocol ile dış sistem entegrasyonu

Cloud Agent Sessions Nasıl Çalışır? (How Cloud Agent Sessions Work)

Cloud agent sessions, ajanları kendi makinenizden değil Microsoft cloud altyapısından çalıştırma imkanı sunuyor. Bu, uzun süreli görevler (long-running tasks), büyük codebase analizi (large codebase analysis) ve makinenizi tüketmek istemediğiniz batch işler için kritik.

# Komut paleti (Ctrl+Shift+P)
> GitHub Copilot: Start Cloud Agent Session

# Veya alt sağ paneldeki agent icon'una tıkla
# Açılan dialog:
#   - Agent seç: refactor-typescript-strict
#   - Branch: feature/strict-mode
#   - Tahmini süre: ~25 dakika
#   - Maliyet: ~$0.40
# [ Başlat ] tıkla

Cloud agent çalışırken siz başka şeylerle ilgilenebilirsiniz. Ajan görevi bitirdiğinde:

• 🔔 IDE'de bildirim alırsınız
• 🌿 Yeni bir branch oluşturulur ve değişiklikler push edilir
• 📋 Detaylı çalışma raporu IDE'de açılır
• 🔍 Diff'i incelersiniz, mergerlersiniz ya da redederisiniz

Debugger Agent: Runtime Doğrulama (Runtime Validation)

Visual Studio 2026'nın belki de en şaşırtıcı yeniliği Debugger Agent. Bu ajan, GitHub Copilot'un önerdiği fix'leri gerçek runtime davranışına karşı doğruluyor (validates against actual runtime behavior).

Klasik Senaryo (Vite, React vb. projeler için):

1. NullReferenceException alıyorsunuz
2. Copilot fix öneriyor: if (user != null) { ... }
3. Debugger Agent devreye giriyor: Breakpoint koyar, debug session başlatır, fix'i uygular
4. Aynı senaryoyu tekrar oynatır, exception oluşuyor mu kontrol eder
5. Eğer oluşmuyorsa fix'i onaylar — eğer hala oluşuyorsa derinleştirir ve gerçek kök nedeni bulmaya çalışır

# Tools → Options → GitHub Copilot → Agents
[x] Enable Debugger Agent (Preview)
[x] Auto-validate Copilot fixes
[x] Capture variable snapshots during validation

Alesta Web ekibimizin gözlemi: Debugger Agent özellikle race condition ve state mutation hatalarında inanılmaz başarılı. Statik analizle yakalanması zor olan bug'ları runtime ile doğruluyor.

IntelliSense vs Copilot Önceliklendirmesi (Priority Conflict Resolution)

Yıllardır Visual Studio kullanıcılarının yaşadığı bir sorun çözüldü: IntelliSense ve Copilot completion'ları editor'da birbiriyle yarışıyor, hangisi geleceği belirsiz oluyordu. Visual Studio 2026 April Update 18.5 ile IntelliSense artık varsayılan olarak öncelikli.

Bu basit gibi görünen değişiklik aslında büyük bir UX kazancı. Çünkü IntelliSense deterministic (kesin) ve type-safe önerirken, Copilot olasılıksal (probabilistic) çalışır. Birini diğerine karıştırmak hatalara yol açabiliyordu.

GitHub Copilot Testing for .NET (Unit Test Üretimi)

Visual Studio 2026 v18.3 ile gelen GitHub Copilot Testing for .NET artık generally available (GA). Birim testlerinizi (unit tests) IDE'den çıkmadan, doğal dilden (natural language) ürettirebiliyorsunuz.

1. Test edilecek metoda sağ tıkla
2. "Generate Unit Tests with Copilot" seç
3. Açılan panelde:
   - Test framework: xUnit / NUnit / MSTest
   - Mock framework: Moq / NSubstitute
   - Coverage hedefi: %90+ branch coverage
4. [ Generate ] tıkla
5. Üretilen testleri review et, ekle

Üretilen testler genelde aşağıdakileri içeriyor:

• ✅ Happy path testleri
• ✅ Edge case'ler (null, empty, boundary values)
• ✅ Exception testleri
• ✅ Async pattern doğrulamaları
• ✅ Mock'ların doğru çağrıldığı doğrulamaları

Alesta Web olarak şu uyarıyı yapmamız gerek: AI tarafından üretilen testleri asla körüne kabul etmeyin (never blindly accept). Her testi gözden geçirin — özellikle assert'ler. Bazen üretilen test "her şey beklendiği gibi" diyebiliyor ama gerçek senaryoyu test etmiyor.

Build 2026'da Açıklanan AI Agent Yenilikleri (Build 2026 Announcements)

Microsoft Build 2026 San Francisco'da gerçekleşti ve developer tooling açısından dolu dolu bir konferans oldu. Alesta Web rehberinde önemli başlıkları derledik:

1. Multi-Agent Orchestration

Birden fazla agent'i bir iş akışında orkestralayan yeni API'ler. Örneğin: research-agent → code-generator → test-runner → reviewer zinciri.

2. Azure AI Foundry Entegrasyonu

Visual Studio doğrudan Azure AI Foundry ile konuşuyor. Custom modellerinizi (fine-tuned models) IDE'den dağıtıp test edebiliyorsunuz.

3. VS Code Agent Mode'un GA Olması

VS Code'daki agent mode artık Visual Studio 2026'da da var. İki ürün arasında parite (parity) sağlandı.

4. Trust ve Güvenlik Vurgusu

Microsoft, agent'lerin yetki kapsamını (permission scope) sınırlama, audit log tutma ve gizli veri sızdırmama (data leak prevention) konusunda yeni özellikler tanıttı. Production kodda agent kullanımı için kritik.

Visual Studio 2026 Kurulum ve İlk Adımlar (Installation & First Steps)

# Resmi indirme
https://visualstudio.microsoft.com/downloads/

# Sürümler:
- Community (ücretsiz, bireysel)
- Professional (lisanslı)
- Enterprise (kurumsal)

# Minimum gereksinim
- Windows 11 (24H2 önerilir)
- 8 GB RAM (16 GB tavsiye)
- 50 GB disk alanı

Agentic Özellikleri Aktif Etme

1. Visual Studio 2026'yı başlat
2. GitHub hesabınla giriş yap
3. Extensions → Manage Extensions → GitHub Copilot v3.0+ yükle
4. Tools → Options → GitHub Copilot → Agents tab
5. "Enable Custom Agents" ve "Enable Cloud Agent Sessions" işaretle
6. İlk .agent.md dosyanı projenizde oluşturun

📚 Kaynaklar ve Referanslar / Sources and References

• Visual Studio 2026 Release Notes — Microsoft Learn resmi sürüm notları
• GitHub Changelog — Copilot ve agent güncellemeleri
• .NET Blog — Copilot Testing GA
• C++ Team Blog — Build optimizations
• Microsoft Build 2026 — Konferans oturumları

Alesta Web olarak tüm bilgileri kendi geliştirme ortamlarımızda doğruladık.