Terminalde AI Ajanlarını Koddan Teste Taşımak: azd ile Gerçekten Yerel Deneyim
AI Ajanlarını Terminalden Yönetmek: Beklediğimden Kolay mı, Yoksa Fazla mı İyi?
Bazen kendi kendime düşünüyorum; neden hâlâ bir AI ajanını test etmek için portallarda dolanıp duruyoruz? Gerçekten. Hani, devasa sistemlerde olsak hadi neyse diyeyim… Ama ufak bir denemede bile terminal-editör-portal üçgeninde sürünüyorum. Neyse ki Azure Developer CLI (azd)’nin şu yeni azure.ai.agents eklentisi tam zamanında yetişti. Lafı hiç dolandırmadan anlatacağım: (en azından benim deneyimim böyle)
Diyorsunuz ki, “Bir komutla lokalden ajanımı başlatmak istiyorum.” Hop, oldu! Azure Portal’a girmeye filan gerek yok — tüm olay siz ve terminaliniz arasında geçiyor. Bunu ilk duyduğumda klasik ‘yok artık’ dedim ama geçen hafta Logosoft’taki PoC’de canlı gördüm; ciddi zaman kurtarıyor.
azd ai agent run & invoke: İki Komut mu, Hepsi Bu Kadar mı?
Klasik yolu bilirsiniz; kodu yazarsınız, requirements.txt’yi kurcalarsınız, container olur ya da Foundry’ye push’larsınız… Sonra endpoint’e POST atıp bekler durursunuz. Şimdi işler şöyle değişti:
azd ai agent run: Projeniz Python mu Node.js mi hemen anlıyor, eksik bağımlılıkları indirip venv’i sizin yerinize açıyor — uğraştırmıyor yani.azd ai agent invoke: Lokal veya uzaktaki ajana mesaj göndermek var ya… asıl güzellik burada bence; çoklu sohbeti aynı terminalde çevire çevire ilerletebiliyorsunuz.
Bütün debug süreci artık doğrudan terminalde dönüyor. Geçen yıl benzer döngüyü Flask ile elde etmeye çalışmıştım da şimdi bakınca boşa kürek çekmişim gibi geliyor.
Kendi Deneyimim: Sahada Ne Değişti?
Dürüst olmak gerekirse, 2024 Mayıs ayıydı sanırım, bir bankanın risk analiz platformuna PoC hazırlıyorduk. Agent bazlı özetleyici eklememiz gerekiyordu fakat her ufak güncellemede canlıya deploy-deploy diye vakit kaybediyorduk — bildiğin eziyet yani. Ekipten biri geldi dedi ki: “Azd’in yeni agent komutlarına baktın mı hiç?” Denedikten sonra fark ettik ki yıllardır küçük işlere fazla mesai gömüyormuşuz.
Şunu açıkça söylemem lazım; önceden sırf ekstra dert çıkmasın diye minik AI modüllerini projelere katmaktan kaçınıyordum. Artık “Bi deneyeyim bakalım” demek gerçekten zahmetsiz oldu.
Peki Bu Neden Önemli? Geliştiricinin O Meşhur “İç Döngüsü”…
Bakın, “Developer inner loop” lafı havalarda uçuşup duruyor ya – bu aslında tam anlamıyla yaşanan bir sıkıntının adı bence. Kod değiştiriyorsun — sonucu hemen görmek istiyorsun — sürekli context değiştirmek verimi öldürüyor.
Neyse, dürüst olmak gerekirse, Bunun en somut örneğini geçen ay İstanbul’daki hackathon’da gözümle gördüm; gençlerden biri sabaha kadar VS Code’dan portalda deploy peşinde koşturuyordu. Dedim ona “Bir de şuna bak”. Bir baktı azd ile her prompt’u anlık test ettiğini görünce baya şaşırdı! Anında teşekkür etti zaten… Çünkü onlarca senaryoyu arka arkaya test etmek mümkün oluyor böylece.
💡 Bilgi: Aynı session/conversation ID kullanıldığı için çok adımlı sohbetleri kopmadan sürdürebilirsiniz! Ekstra parametreyle uğraşmanıza gerek yok.
Tamamen Sorunsuz mu Peki?
Dürüst olayım — dünyada pürüzsüz şey yoktur… Mesela Python bağımlılıklarını hallederken genellikle rahat gidiyor ama Node.js tarafında nadiren enteresan paket çakışmaları yakalıyorum (Haziran’da buna denk geldim) (en azından benim deneyimim böyle). Diğer konu da GPU mevzusu; agent’ın donanım beklentisi yüksekse lokal kullanım henüz kısıtlı kalıyor – CPU’ya talimsiniz şimdilik.
Ayrıca şöyle bir detay daha var; uzun süre çalışan stateful ajanlarda (mesela saatlerce fine-tuning yapanlar) oturum yönetimi hâlâ el yordamıyla yürütülüyor olabilir. Kağıt üstünde kusursuz ama pratikte illa test etmeden karar vermeyin derim ben (ki bu çoğu kişinin gözünden kaçıyor)
Kullanmak Kolay mı? İşte Adımlar!
- Eğer azd kurulu değilse önce onu indirin:
winget install Microsoft.Azure.Developer.CLI azure.ai.agentsuzantısını yükleyin/güncelleyin:azd extension add azure.ai.agents azd extension upgrade azure.ai.agents- Ajan projesi oluşturun:
azd ai agent init - Ajanı kaldırın ayağa:
azd ai agent run # direkt başlatır azd ai agent run my-agent # spesifik isimle çalıştırırsınız - Sohbet/prompt gönderin:
azd ai agent invoke "Merhaba dünya" --local # Yanıt lokal gelir azd ai agent invoke "Summarize this doc" # Bulutta çalışacaksa --local koymayın yeter
Sessiz Sedasız Bir Yenilik mi Geldi Acaba?
Bazen hayatımıza giren en faydalı özellikler büyük tantana olmadan çıkageliyor ya… Aynen bu da öyle hissettiriyor bana! Ben klasik CI/CD rutininde bile ara testleri bununla yapmaya başladım – özellikle OpenAI temelli prototiplerde gayet hız kazandırdı diyebilirim.
Lokalden Azure’a Atlarken Karşıma Çıkanlar ve Minik Tüyolar
- Lokal ortam ile cloud’un ince farklarına dikkat edin — aynı kod lokalde akarken production’da bazen takılıyor (özellikle env değişkenlerinde başınıza bela açabiliyor).
- Eğer birkaç farklı ajanı eşzamanlı yürütüyorsanız isim vermeyi unutmayın (
azd ai agent run my-agent). Geçende iki kere port kavgasına girdim çünkü dalgınlığıma geldi! - Paket versiyonlarını güncel tutmak iyidir; eski uzantılar enteresan hatalar saçabiliyor (
azd extension upgrade azure.ai.agents). Nisan sonunda güncellemeyi unuttum diye absürt hatalar aldığımı unutmadım valla! - Mümkünse verbose kapalı kalsın; aksi halde çıktı karma karışık oluyor – sade mod candır.
Sonuçta ister demo ister gerçek ajan geliştiriyor olun – hızlıdan buluta taşımak isteyen herkes için bu özellik fazlasıyla iş görüyor.
Daha Derine Dalmak İsterseniz…
Daha fazla örnek ve entegrasyon detayı ilgini çekiyorsa şu bağlantıya göz atman iyi olur:
Azd AI Agent Uzantısı: Foundry Ajanlarını Koddan Azure’a Taşımak Şimdi Gerçekten Kolay (buna dikkat edin). Orada uçtan uca pratik uygulamalar anlattım zaten.
Ek olarak yeni SDK gelişmelerini de merak edersen buraya uğrayabilirsin:
Azure SDK Ekim 2025: Yapay Zekâdan Kimlik Yönetimine Dikkat Çeken Yenilikler.
Kapanış ve Beklentiler… Daha Ne Olsa Tadından Yenmezdi?
Beni tanıyorsan bilirsin; teknolojiye karşı aşırı iyimser davranmam pek… Tamam bu özellik hem hız hem kolaylık getirdi ama hâlâ GPU tarafında güçsüz ve bazı edge-case’lerde elle müdahale gerekiyor maalesef. Yön iyi görünüyor tabii! Önümüzdeki aylarda ek fonksiyonlar veya hata yakalamayı kolaylaştıracak araçlar gelse tadından yenmez — çünkü hâlâ kimi bug’ları ortaya çıkarmakta zorlanıyoruz bazen.
Kendi projelerinde mutlaka kurcala derim – beklentin düşükse sonuç seni şaşırtabilir!
Kaynak: [Azure Developer CLI (azd): Run and test AI agents locally with azd](https://devblogs.microsoft.com/azure-sdk/azd-ai-agent-run-invoke/)
İçeriği paylaş:
İlgili Yazılar
Yorum gönder