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)’nın ş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, öldü! Azure Portal’a girmeye filan gerek yok — tüm olay sız 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 yanı.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 yanı. 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 öldü.
azd’nın azure.ai.agents eklentisiyle AI ajanlarını terminalden çalıştırmak ve test etmek için akışın nasıl değiştiğini özetliyor: kurulum, çağırma ve çok adımlı sohbet deneyimi.
| Özellik | azd (azure.ai.agents) |
|---|---|
| Lokalden başlatma | Tek komutla ajanı ayağa kaldırma, portal gerekmez |
| Çalıştırma akışı | run ile Python/Node bağımlılıkları otomatik yönetilir |
| Mesaj gönderme & sohbet | invoke ile lokal/uzak ajana mesaj; aynı terminalde çoklu sohbet |
| Debug/inner loop | Sonuçları terminalde hızlı görmek; deploy-portala gidip gelme azalır |
| Çok adımlı oturum | Aynı session/conversation ID ile sohbet kopmadan sürer |
Not: Makalede anlatılan kazanım, özellikle PoC ve sık güncelleme döngülerinde zaman kazandırması.
Peki Bu Neden Önemli? Geliştiricinin O Meşhur “İç Döngüsü”…
Bakın, “Developer inner loop” lafı havalarda uçuşup dürüyor 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 ölduruyor.
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.
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 illâ 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 önü 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 işim 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 hâlde çı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 tabiî! Ö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!
Sıkça Sorulan Sorular
azd ile AI ajanlarını terminalden yönetmek neden avantajlı?
Terminal üzerinden doğrudan ajanları yönetmek, portal veya GUI bağımlılığını azaltıyor. Ben de kullanınca gördüm ki, hızlı deneme-yanılma döngüsü sağlıyor ve zaman tasarrufu büyük. Özellikle küçük projelerde çok pratik oluyor.
azd ai agent run ve azd ai agent invoke komutları ne işe yarıyor?
azd ai agent run komutu, projenizi otomatik olarak tanıyıp gerekli ortamı kuruyor; invoke işe çalışan ajana mesaj göndermenizi sağlıyor. Benim deneyimimde, invoke komutuyla çoklu sohbeti kesintisiz sürdürebilmek gerçekten çok kolaylaştırdı.
Bu yöntem sadece Python veya Node.js projeleri için mi geçerli?
Şu anda azd, Python ve Node.js projelerini otomatik algılayıp destekliyor. Başka diller için henüz destek kısıtlı olabilir ama temel kullanımda bu iki dil yeterli oluyor.
azd ile geliştiricinin iç döngüsü nasıl iyileşiyor?
Kod değişikliği sonrası sonucu hemen terminalde görebilmek, bağlam değiştirmek zorunda kalmadan hızlı test yapmak verimi artırıyor. Ben hackathon deneyimimde bunun farkını net gördüm; gençler bile çok daha rahat çalıştı.
Terminalde AI ajanını test ederken sohbet geçmişi nasıl korunuyor?
azd, aynı session veya conversation ID’yi kullanarak çok adımlı sohbetlerin kopmadan sürdürülmesini sağlıyor. Böylece ekstra karmaşık parametrelerle uğraşmanıza gerek kalmıyor.
Kaynaklar ve İleri Okuma
Azure Developer CLI AI Agents Belgeleri
Azure Developer CLI (azd) Tanıtımı – Azure Blog
Azure SDK for Python – azure-ai-agents GitHub
20+ yıl deneyimli Azure Solutions Architect. Microsoft sertifikalı bulut mimari ve DevOps danışmanı. Azure, yapay zekâ ve bulut teknolojileri üzerine Türkçe teknik içerikler üretiyor.
